SpringCloud Feign

# Feign

Feign 是一个声明式的 REST客户端，它能让 REST 调用更加简单

Feign 供了 HTTP 请求的模板，通过接口、注解的形式，定义好 HTTP 参数

示例

大致流程概述：

消费者引入依赖

消费者启动器类添加注解 @EnableFeignClients

消费者创建服务客户端接口（用于访问请求的

消费者创建新的controller （用于测试步骤3访问可行

消费者 pom.xml (主要依赖

<!-- Feign -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

消费者启动类，添加注解 @EnableFeignClients

@SpringCloudApplication
@EnableFeignClients // 启动 feign功能
public class ConsumerApplication {
    
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }
    
    @Bean
    // Ribbon 启动负载均衡
    @LoadBalanced
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
    
}

消费者创建Feign客户端，以接口形式存在

//标识 Feign客户端
@FeignClient("user-service")
public interface UserService {
    
    // http://user-service/user/1 （前提：该url可访问
    @GetMapping("user/{id}")
    User queryById(@PathVariable ("id")Long id);
    
}

该接口主要作用是无需手动拼接 url，通过注释进行拼接url（不同方法都有各自的拼接结果

@FeignClient 注释的value需要指定 ==服务名称==

消费者创建新的 controller ConsumerFeignController类

@RestController
public class ConsumerFeignController {
    
    @Autowired
    private UserService client;
    
    @GetMapping ("/cf/{id}")
    public User queryById(@PathVariable Long id) {
        return client.queryById(id);
    }
    
}

用于测试接口访问

测试访问 http://localhost:8080/cf/1 （代码以上篇文章为基础，因此访问IP一样

# Feign-Ribbon

Ribbon主要用于配置请求时长、重新访问等相关配置

Feign本身集成了 Ribbon依赖和自动配置（无需再次配置Ribbon

由于自动配置的缘故，我们只需关注主要的配置信息

配置	值 (默认)	说明
`ribbon.ConnectTimeout`	int (1000ms)	连接超时时长 (两端连接最长时长，超出则超时)
`ribbon.ReadTimeout`	int (1000ms)	请求处理超时时长 (连接后读取资源最长时长，超出则超时)！
`ribbon.MaxAutoRetries`	int (0)	对请求的失败重试次数
`ribbon.MaxAutoRetriesNextServer`	int (1)	对请求失败重试换节点次数
`ribbon.OkToRetryOnAllOperations`	boolean (false)	是否对所有的请求方式都重试

支持全局配置或单个服务配置

以上参数自行在浏览器测试

# Feign-Hystrix

Feign 默认也集成 Hystrix依赖

详细了解：04Spring Cloud 熔断器Hystrix (opens new window)

应用说明：

默认是关闭Hystrix ，需要手动配置Hystrix打开
需要为 Feign客户端注解添加降级服务的指定类
需要为 Feign客户端编写falback作为降级处理

示例

在以上代码基础上进行编辑测试

启动Hystrix。消费者配置启动

# feign-hystrix
feign :
    hystrix :
        # 熔断器打开
        enabled : true

启动类添加 @EnableHystrix注解

@SpringCloudApplication
@EnableEurekaClient
@EnableFeignClients // 启动 feign功能
public class ConsumerApplication {
    
    public static void main(String[] args) {
        SpringApplication.run(ConsumerApplication.class, args);
    }
    
    @Bean
    // Ribbon 启动负载均衡
    @LoadBalanced
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
    
}

降级服务模板。为 Feign客户端创建 Fallback模板

// 为UserService接口 Fallback降级服务
@Component
@Slf4j
public class UserServiceFallback implements UserService{
    
    @Override
    public User queryById(Long id) {
        User user = new User();
        user.setId(id);
        user.setName("用户异常");
        log.error("访问拥堵！{}",id);
        return user;
    }
    
}

@Component注解自动扫描对象（添加容器自动注入的应用

实现指定服务的接口

Feign客户端降级服务。注解 fallback值：需要指定Fallback模板类

//标识 Feign客户端 (添加 Fallback降级服务
@FeignClient(value = "user-service",fallback = UserServiceFallback.class)
public interface UserService {
    
    // http://user-service/user/1
    @GetMapping("user/{id}")
    User queryById(@PathVariable ("id")Long id);
    
}

测试
1. 依次打开 Eureka、server、consumer 三个服务
2. 浏览器访问 http://localhost:8080/cf/1 （访问成功
3. 关闭 server 再次访问以上请求
4. 再次访问以上链接，会返回降级的fallback模板

# Feign-日志

Feign日志专门记录请求/响应的信息

Level级别

Level级别会根据不同的配置，分别记录不同的信息

Level级别	说明
`NONE` (默认)	不记录任何信息
`BASIC`	只记录请求方法，URL以及响应状态码、执行时间
`HEADERS`	在BASIC的基础上，额外记录请求/响应头信息
`FULL`	记录请求/响应明细信息（请求头、请求体、元数据）

应用说明：

Feign日志需要在指定包下配置日志级别
Feign客户端也需添加注解 configuration值指定 Feign日志配置类

示例

配置日志级别。消费者配置日志级别 debug

# 日志级别
logging :
    level :
        com.sans : debug

创建 Feign日志配置类。消费者创建 Feign日志配置类指定 level级别

package com.sans.config;

// 配置类
@Configuration
public class FeignConfig {
    
    /* 请求级别：
        - NONE：不记录任何信息(默认值)
        - BASIC：只记录请求方法，URL以及响应状态码、执行时间
        - HEADERS：在BASIC的基础上，额外记录 请求/响应 头信息
        - FULL：记录 请求/响应 明细信息（请求头、请求体、元数据）
    * */
    
    @Bean
    public Logger.Level feignLoggerLevel() {
        return Logger.Level.FULL;
    }
    
}

接口注释。消费者 Feign客户端 @FeignClient注解 configuration值添加 Feign日志配置类

@FeignClient(value = "user-service",fallback = UserServiceFallback.class,configuration = FeignConfig.class)
public interface UserService {
    
    // http://user-service/user/1
    @GetMapping("user/{id}")
    User queryById(@PathVariable ("id")Long id);
    
}

测试
1. 依次打开 Eureka、server、consumer 三个服务
2. 浏览器访问 http://localhost:8080/cf/1 （访问成功
3. 查看控制台日志

# http压缩

Feign 也支持请求/响应进行GZIP压缩，减少传输性能损耗

需要手动启动配置示例：

feign :
    # 日志 请求/响应 分别启动
    compression:
        request:
	        # 开启请求压缩
            enabled: true 
            # 设置压缩的数据类型 (默认)
            mime-types: text/html,application/xml,application/json 
            # 设置触发压缩的大小下限 (默认)
            min-request-size: 2048 
        response:
	        # 开启响应压缩
            enabled: true

以上配置除了压缩启动，其他应用默认值即可

仓库代码 : https://gitee.com/Bozhu12/spring-cloud-examples.git (opens new window)

#SpringClound #Java

← SpringCloud Hystrix熔断器 SpringCloud Gateway网关→