微服务架构 | 负载均衡 - [OpenFeign]

简介

Feign ≈ RestTemplate + Ribbon
OpenFeign ≈ Feign + MVC支持
OpenFeign 通过接口，而非协议访问服务提供方
类似 Dubbo/JNDI 的方式，通过接口和注解，生成远端服务的代理对象进行访问

快速入门

依赖

<dependency>
    <groupId>org.springframework.cloudgroupId>
    <artifactId>spring-cloud-starter-openfeignartifactId>
dependency>

配置

序列化
因为 OpenFeign加入了对 SpringMvc 的集成，因此可以通过对 MVC 进行配置的方式影响 OpenFeign 的 RPC 结果，比如替换序列化组件

@Configuration
public class WebMvcConfig {
    @Bean
    GsonHttpMessageConverter gsonHttpMessageConverter(){
        GsonHttpMessageConverter converter = new GsonHttpMessageConverter();
        GsonBuilder gsonBuilder = new GsonBuilder();
        gsonBuilder.setDateFormat("yyyy-MM-dd HH:mm:ss");
        converter.setGson(gsonBuilder.serializeNulls().create());
        return converter;
    }
}

因为 OpenFeign 自动依赖 Ribbon，因此可以通过对 Ribbon 的配置设置超时
并且可以直接通过 yml 进行配置，注意这里的超时依然是消费者的超时控制

ribbon:
	# 建立连接后从服务器读取到可用资源所用的时间
	ReadTimeout: 5000
	# 建立连接所用的时间，适用于网络状况正常的情况下,两端连接所用的时间
	ConnectTimeout: 5000

启动类
对 OpenFeign 接口的类扫描，是由 @EnableFeignClients 进行而不是 @SpringBootApplication
因此若项目变更了启动类默认位置，则 @EnableFeignClients 上也应该标注 basePackage 属性
如下面示例中的注释行：

//@SpringBootApplication(scanBasePackages = "com.fc.sprcloudlearning")
//@EnableFeignClients(basePackages = "com.fc.sprcloudlearning")
@SpringBootApplication
@EnableFeignClients
public class OrderComsummerApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderComsummerApplication.class,args);
    }
}

OpenFeign 接口
注意事项：

• 不需要 @Component 注解
• 接口上需要注明接口对应的服务名
• 接口方法上的 mvc 路径为服务提供方的 mvc 路径
• 接口方法上的 mvc 路径需要写全，注意带有类路径的情况

//@Component
@FeignClient(value = "PAYMENT-SERVICE")
public interface PaymentOpenfeignService {
    @RequestMapping(value = "/payment/{id}", method = RequestMethod.GET)
    CommonResult findById(@PathVariable("id") Long id);
}

OpenFeign 的（接口）日志

Feign 的接口日志级别

• NONE: 默认的，不显示任何日志
• BASIC：仅记录请求方法、URL、响应状态码以及执行时间
• HEADERS：除了BASIC中定义的信息以外，还有请求和响应的头信息
• FULL： 除了HEADERS中定义的信息之外，还有请求和响应的正文及元数据

开启 OpenFeign 的接口日志需要两处配置
1 项目的日志需要可以输出相关类的日志
OpenFeign 的接口日志只是项目日志中的一部分，如果项目中日志的配置不支持，就无所谓接口日志记录成什么样
这里就是正常项目日志的配置，loombok / log4j 等等任意
这里的日志级别是 debug 的原因是 OpenFeign 的接口日志本身是 debug 级别的项目日志

logging:
  config: classpath:logback.cfg.dev.xml
  level:
    # 对服务类进行正常的接口配置，否则对应类根本不输出日志，就无所谓其中的接口日志记录到什么程度了
    com.fc.sprcloudlearning.order.service.PaymentOpenfeignService: debug

2 配置 OpenFeign 的接口日志级别
这里配置了如果项目需要服务相关的类输出日志，那其中接口日志输出的详细程度

@Configuration
public class OpenFeignConfig {
    @Bean
    Logger.Level openFeignLoggerLevel(){
        return Logger.Level.FULL;
    }
}

日志输出效果如下图：
BASIC

HEADERS

FULL

OpenFeign 的负载均衡规则

OpenFeign 实际上是个 Rest 客户端，负载均衡操作依赖 Ribbon 负载均衡能力
因此，OpenFeign 下变更负载均衡规则的方式如 Ribbon