Feign是一个申明式的http客户端,官网地址:https://github.com/OpenFeign/feign
其作用就是帮忙咱们优雅的实现http申请的发送
一 根本应用
1 在消费者中引入依赖
<dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-openfeign</artifactId></dependency>
2 减少启动注解
在消费者启动类上增加 @EnableFeignClients 注解,提供者可不增加
3 编写 Feign 接口
@FeignClient("userservice") //服务名称public interface UserClient { @GetMapping("/hello/feignTest/{id}") //地址必须与服务中的地址统一 String feignTest(@PathVariable("id") String id);}
//提供者中代码
@RestController@RequestMapping("/hello")public class Hello { @GetMapping("/hello") private String hello() { return "userHello"; } @GetMapping("feignTest/{id}") private String feignTest(@PathVariable("id") String id){ return "feignTest, ID:"+id; }}
4 注入调用
//消费者中注入调用
@RestController@RequestMapping("/hello")public class Hello { @Autowired private UserClient userClient; @GetMapping("/hello") private String hello() { return "orderHello"; } @GetMapping("/feign/{id}") private String feign(@PathVariable("id")String id ){ return userClient.feignTest(id); }}
二 自定义配置
Feign能够反对很多的自定义配置,如下表所示:
类型 | 作用 | 阐明 |
---|---|---|
feign.Logger.Level | 批改日志级别 | 蕴含四种不同的级别:NONE、BASIC、HEADERS、FULL |
feign.codec.Decoder | 响应后果的解析器 | http近程调用的后果做解析,例如解析json字符串为java对象 |
feign.codec.Encoder | 申请参数编码 | 将申请参数编码,便于通过http申请发送 |
feign. Contract | 反对的注解格局 | 默认是SpringMVC的注解 |
feign. Retryer | 失败重试机制 | 申请失败的重试机制,默认是没有,不过会应用Ribbon的重试 |
个别只会批改日志的配置
feign日志级别:
- none(默认) 无日志
- basic 记录申请发送、完结工夫、耗时等根本信息
- headers basic的信息+申请头、响应头信息
- full headers+申请体、响应体
自定义的形式分为代码和配置文件(都是在消费者模块中增加)
配置文件形式:
#针对单个服务feign: client: config: userservice: # 针对某个微服务的配置 loggerLevel: FULL # 日志级别
#针对所有服务feign: client: config: default: # 这里用default就是全局配置,如果是写服务名称,则是针对某个微服务的配置 loggerLevel: FULL # 日志级别
代码形式:
public class DefaultFeignConfiguration { @Bean public Logger.Level feignLogLevel(){ return Logger.Level.BASIC; // 日志级别为BASIC }}
针对单个服务则在单个服务的 @FeignClient 中增加 configuration = xxx.class
@FeignClient(value = "userservice", configuration = DefaultFeignConfiguration .class)
针对所有服务则在启动类 @EnableFeignClients 中增加 defaultConfiguration = xxx.class
@EnableFeignClients(defaultConfiguration = DefaultFeignConfiguration .class)
三Feign应用优化
1 优化日志级别
优化日志级别为 none 或 basic
2 http客户端优化
feign自身只是近程调用的申明,底层还是须要http客户端进行近程调用
feign的客户端有:
- URLConnection:默认实现,不反对连接池
- Apache HttpClient :反对连接池
- OKHttp:反对连接池
只须要替换成带连接池的 HttpClient 或 OKHttp 则能够晋升性能
以 HttpClient 为例
1 在消费者中引入依赖
<!--httpClient的依赖 --><dependency> <groupId>io.github.openfeign</groupId> <artifactId>feign-httpclient</artifactId></dependency>
2 批改配置文件中feign相干的配置
feign: client: config: default: # default全局的配置 loggerLevel: BASIC # 日志级别,BASIC就是根本的申请和响应信息 httpclient: enabled: true # 开启feign对HttpClient的反对 max-connections: 200 # 最大的连接数 time-to-live: 900 # 连贯最大闲置工夫,单位为秒,缺省值是 900秒(15分钟) max-connections-per-route: 50 # 每个门路的最大连接数
四 Feign我的项目中的应用
我的项目中应用办法个别分为 继承 或者 独自抽离成一个模块
1 继承
让Feign接口和服务提供者继承或实现同一个接口,达到两边的统一性(紧耦合,耦合度高)
2 独自抽离成一个模块
把feign相干的代码(feign接口、配置文件、依赖、相干实体类 )抽离成一个独自的模块,要应用其中的feign接口间接引入该模块
引入feign模块的形式可能会导致消费者无奈注入对应的 feign 接口类
解决办法:
- 指定要加载的Feign接口类:在启动类的@EnableFeignClients中增加 clients = {xxxx.class,xxx.class}
- 指定Feign应该扫描的包:在启动类的 @EnableFeignClients 中增加 basePackages = "xxx.xxx.xxx.xxx"
//样例
指定须要加载的Client接口:
@EnableFeignClients(clients = {UserClient.class})
指定Feign应该扫描的包:
@EnableFeignClients(basePackages = "com.ray.feignapi.clients")