1、项目模块介绍

2、 父项目

主要依赖 spring-cloud 的 版本控制

<properties>
    <!--   springCloud 版本     -->
    <scd.version>Dalston.SR4</scd.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>${scd.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3、 eureka 模块

3.1 主要依赖

<!--   eureka 注册中心 依赖     -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-eureka-server</artifactId>
</dependency>

3.2 配置信息

# 端口
server:
  port: 8096

# 服务名
spring:
  application:
    name: edocmall-eureka

# eureka 服务注册与发现 配置
eureka:
  client:
    #Eureka 监控页面
    service-url:
      defaultZone: http://127.0.0.1:${server.port}/eureka
    register-with-eureka: false # 是否注册自己的服务到注册中心，默认为true
    on-demand-update-status-change: false # 是否主动拉取其他注册的服务信息，默认也是true

3.3 主启动类上的注解

@EnableEurekaServer //eureka服务端启动，可以就接受别人来注册

3.4 测试 访问

启动项目，访问 http://localhost:8096

4、server 服务提供模块

4.1 主要依赖

<!--   eureka 客户端依赖     -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>

4.2 配置信息

# 端口
server:
  port: 8097

# 服务名配置，eureka注册信息，服务调用基于服务名，必须增加
spring:
  application:
    name: edocmall-server
  #数据源配置
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/kh96_springboot_edocbd?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=GMT
    username: root
    password: root

# mybatis-plus 配置
mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true

# eureka 注册中心的配置
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:8096/eureka  # 注册中心的地址
  # 关闭自我保护机制，保证不可用的服务及时剔除
  server:
    enable-self-preservation: false

4.3 代码介绍

4.4 主启动类上的注解

@MapperScan("com.kgc.scd.mapper")
@EnableEurekaClient // 开启 eureka 服务注册，将此服务注册到 eureka中

4.5 请求测试

服务提供端的请求最好先单独测试一下，成功后再进行远程调用；

5、 web 服务消费模块

5.1 使用restTemplate 调用

5.1.1 主启动类 向容器中放入 restTemplate

@SpringBootApplication
public class Edocmall96WebApplication {

    public static void main(String[] args) {
        SpringApplication.run(Edocmall96WebApplication.class, args);
    }

    //往容器中添加 restTemplate 
    @Bean
    public RestTemplate restTemplate(){
        return new RestTemplate();
    }

}

5.1.2 请求中直接调用具体url下的请求

@RestController
public class WebEntryController {

    @Autowired
    private RestTemplate restTemplate;
    
     // 根据文档编号，获取文档详情
    @GetMapping("/entryById")
    public RequestResult<EdocEntryVO> entryDetail(Integer id){
        log.info("------ 根据文档编号：{}，获取文档详情 ------",id);

        //模拟发送http请求请求server端，获取文档详情
        //弊端：消费端，必须在程序内，记录提供者的ip地址，如果地址出现变更，还需要计时更新，如果服务者有多个及其，无法实现负载均衡
        EdocEntryVO edocEntryVO = restTemplate.getForObject("http://127.0.0.1:8097/entry?id="+id,EdocEntryVO.class);

        return ResultBuildUtil.success(edocEntryVO);

    }
    
} 

5.1.3 请求测试

5.2 使用 feign 远程调用

5.2.1 主要依赖

<!--   eureka 客户端依赖     -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>

<!--  feign远程调用依赖      -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-feign</artifactId>
    <version>1.3.5.RELEASE</version>
</dependency>

5.2.2 配置信息

# 端口
server:
  port: 8098

spring:
  application:
    name: edocmall-web
# 服务名

# eureka 注册中心的配置
eureka:
  client:
    service-url:
      defaultZone: http://127.0.0.1:8096/eureka
  # 关闭自我保护机制，保证不可用的服务及时剔除
  server:
    enable-self-preservation: false

# 开启客户端服务降级，默认是关闭的，需要打开
feign:
  hystrix:
    enabled: true

5.2.3 代码介绍

5.2.3.1 业务层接口

//指定服务名
@FeignClient(value = "edocmall-server") 
public interface WebEntryService {
    //基于feign 远程调用edoc-server服务端提供的查询文档详情接口
    @GetMapping("/entry") //必须跟远程请求一直
    EdocEntryVO invokeEntryServiceUserFeign(@RequestParam("id") Integer id); //必须写 @RequestParam("id")
    // 注意 一点更要写 @RequestParam("id") 里面的参数必须写
    
}

5.2.3.1 控制层直接调用接口

@RestController
public class WebEntryController {
    
    @Autowired
    private WebEntryService webEntryService;
    
      // 根据文档编号，获取文档详情
    @GetMapping("/entryById")
    public RequestResult<EdocEntryVO> entryDetail(Integer id){
        log.info("------ 根据文档编号：{}，获取文档详情 ------",id);

      //基于feign 远程调用服务端接口，获取文档详情
      EdocEntryVO edocEntryVO = webEntryService.invokeEntryServiceUserFeign(id);

       return ResultBuildUtil.success(edocEntryVO);

    }
    
}

5.2.4 主启动类上的注解

@EnableEurekaClient  // 开启 eureka 服务注册，将此服务注册到 eureka中
@EnableFeignClients  //开启 feign 远程调用服务

5.2.5 请求测试

eureka 注册中心：

feign远程调用：

6、Feign的服务降级与熔断

6.1 服务降级(服务消费端)

6.1.1 依赖

由于feign中有hystrix的依赖，所以不用单独添加；

6.1.2 hytrix 配置

# 开启客户端服务降级，默认是关闭的，需要打开
feign:
  hystrix:
    enabled: true

6.1.3 接口指定服务降级后的实现类

@FeignClient(value = "edocmall-server",fallback = WebEntryServiceImpl.class) //fallback 指定调用失败后 降级调用的数据
public interface WebEntryService {
    ......
}

6.1.4 实现类，具体降级服务操作

@Service
public class WebEntryServiceImpl implements WebEntryService {

    @Override
    public EdocEntryVO invokeEntryServiceUserFeign(Integer id) {
        //此方法，就是regn远程调用，触发服务剪辑的默认实现，正常请求不会调用
        //只用远程 feign调用失败，才会调用
        EdocEntryVO edocEntryVO = new EdocEntryVO();
        edocEntryVO.setId(999);
        edocEntryVO.setCid(0);
        edocEntryVO.setTitle("触发熔断服务降级");
        edocEntryVO.setSummary("当feign远程调用接口失败，默的默认实现");
        edocEntryVO.setUploadUser("feign-hystrix");
        edocEntryVO.setCreateDate(new Date());

        return edocEntryVO;
    }

6.1.5 测试

6.1.5.1 不添加服务降级时 服务端宕机情况

6.1.5.2 添加服务降级后 服务端宕机情况

6.1.5.3 添加服务降级后 服务端正常，接口报错

接口报错信息：

6.2 服务熔断(服务提供端)

6.2.1 依赖

<!--导入Hystrix依赖-->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-hystrix</artifactId>
</dependency>

6.2.2 熔断 备选方法 和 熔断触发条件

@Slf4j
@RestController
public class EntryController {

    @Autowired
    private EntryService entryService;

    //根据 id 查询文档详情
    @GetMapping("/entry")
    @HystrixCommand(fallbackMethod = "fallbackStoryDetail")  //指定 服务熔断后的备选方法
    public EdocEntryVO entryDetail(@RequestParam Integer id){
        log.info("------ 根据文档编号：{}，获取文档详情 ------",id);

        EdocEntryVO edocEntry = entryService.getEdocEntryById(id);

        if (edocEntry == null){
            //抛出异常，触发 熔断 备选方法
            throw new RuntimeException("id为："+id+"的用户不存在，触发服务熔断");
        }

        return edocEntry;

    }

    // 根据 id 查询文档详情 方法 服务熔断后  的备选方案
    public EdocEntryVO fallbackStoryDetail(@RequestParam Integer id){
        //此方法，只用服务熔断时，才会被调用
        EdocEntryVO edocEntryVO = new EdocEntryVO();
        edocEntryVO.setId(999);
        edocEntryVO.setCid(0);
        edocEntryVO.setTitle("根据 id 查询文档详情 方法 服务熔断后  的备选方案");
        edocEntryVO.setSummary("当根据id 查询不到具体用户信息时，就会触发");
        edocEntryVO.setUploadUser("hystrix");
        edocEntryVO.setCreateDate(new Date());

        return edocEntryVO;
    }

}

6.2.3 主启动类上的注解

@EnableHystrix //开启熔断服务 旧的开启服务熔断注解： @EnableCircuitBreaker

6.2.4 测试

6.2.4.1 没有服务降级，也没有服务熔断 时

直接返回错误；

6.2.4.2 有服务降级，没有服务熔断 时

触发服务降级；

6.2.4.3 有服务降级，也有服务熔断 时

触发服务熔断；

7、显示eureka中服务的基本信息

7.1 依赖

<!-- 暴露info端点给外部访问, 需要添加暴露端点的启动依赖: -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

7.2 配置

# 服务信息 eureka 中服务配置的基本信息
info:
  app.name: web 消费端
  company.name: com.kgc.kh96 # 公司域名
  # 其他信息可以自行查询

7.3 测试

点击服务路径：

点击后的测试信息：

8、eureka注册中心进行加密

8.1Eureka加密的重要性

如果我们不对Eureka进行加密就会导致一些恶意的微服务注册到Eureka注册中心，为了防止这种事情发生我们就要对Eureka进行加密处理。

8.2 实现步骤

8.2.1 配置依赖 maven

​ Eureka 自带了一个 Web 的管理页面，方便我们查询注册到上面的实例信息，但是有一个问题：如果在实际使用中，注册中心地址有公网 IP 的话，必然能直接访问到，这样是不安全的。所以我们需要对 Eureka 进行改造，加上权限认证来保证安全性。
​ 改造我们的 eureka-server，通过集成 Spring-Security 来进行安全认证。
​ 在 pom.xml 中添加 Spring-Security 的依赖包，代码如下所示。

<!-- eureka依赖配置 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-eureka-server</artifactId>
</dependency>

<!-- Spring-Security 的依赖包 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>

8.2.2 springboot Eureka注册中心 配置文件

8.2.2.1yml文件：

spring:
  security:
    user:
      name: Your username
      password: Yourpassword

8.2.2.1properties格式：

spring.security.user.name: Your username
spring.security.user.name: Your password

8.2.3 注册中心security配置

package com.dazuizui.eureka1.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@Configuration
@EnableWebSecurity
public class WebSecurityConfig extends WebSecurityConfigurerAdapter {

  /*    @Override
    protected void configure(HttpSecurity http) throws Exception {
        // 关闭csrf
        http.csrf().disable();
        // 支持httpBasic
        http.authorizeRequests().anyRequest().authenticated().and().httpBasic();
    }*/
  
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        //过滤eureka路径
        http.csrf().ignoringAntMatchers("/eureka/**");
        super.configure(http);
    }
}

8.2.3 注册中心的配置文件

8.2.3.1 yml版：

#服务名
spring:
  application:
    name: eureka
  basic:
    enable: true
    
# security在springboot 2.0.0版本后需要在spring的层级下才能成功，2.0.0之前的版本不需要在spring的层级下
security:
  user:
    name: admin
    password: admin

# 端口号
server:
  port: 8096

eureka:
  instance:
    hostname: localhost
  client:
    service-url:
      defaultZone: http://${spring.security.user.name}:${spring.security.user.password}@${eureka.instance.hostname}:${server.port}/eureka/
    fetch-registry: true # 是否主动拉取其它注册的服务信息，默认也是true
    register-with-eureka: false # 是否注册自己的服务到注册中心，默认是true

​ 重新启动注册中心，访问 http://localhost:8096/，此时浏览器会提示你输入用户名和密码，输入正确后才能继续访问 Eureka 提供的管理页面。

8.2.4 eureka服务端注册的配置文件配置

​ 在 Eureka 开启认证后，客户端注册的配置也要加上认证的用户名和密码信息，需要对应的账户和密码：

# 端口
server:
  port: 8100

# 服务名
spring:
  application:
    name: wyyxmall-hx-server

# eureka注册中心配置
eureka:
  client:
    service-url:
      defaultZone: http://admin:admin@localhost:8096/eureka/

8.2.5 若出现配置eureka认证后输入密码还报错无法进入的情况

8.2.5.1 在进行eureka server安全认证时，登陆用户名密码报错。

8.2.5.2 方法一：springboot 2.0.0版本之前

springboot 2.0.0版本之前的 配置文件application.yml配置如下：

# security在springboot 2.0.0版本后需要在spring的层级下才能成功，2.0.0之前的版本不需要在spring的层级下
security:
  basic:
    enable: true
  user:
    name: admin
    password: admin

8.2.5.3 方法二：springboot 2.0.0版本之后

springboot 2.0.0版本之后的 配置文件application.yml配置如下：

spring:
  security:
    basic:
      enable: true
    user:
      name: admin
      password: admin

8.2.6 测试结果