openfeign的使用

导入 openfeign 的相关jar 包

1
2
3
4
5
6
7
8
9
10
<!--OpenFeign-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<!--负载均衡-->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>

在启动类使用 @EnableFeignClients

1
2
3
4
5
6
7
8
9
10
11
12
13
14
@EnableFeignClients
@MapperScan("com.hmall.cart.mapper")
@SpringBootApplication
public class CartApplication {
public static void main(String[] args) {
SpringApplication.run(CartApplication.class, args);
}


@Bean
public RestTemplate restTemplate(){
return new RestTemplate();
}
}

新建 ItemClient 实现 OpenFeign 客户端使用

1
2
3
4
5
@FeignClient("item-service")
public interface ItemClient {
@GetMapping("/items")
List<ItemDTO> queryItemById(@RequestParam Collection<Long> ids);
}

当定义的FeignClient不在SpringBootApplication的扫描包范围时,这些FeignClient无法使用。有两种方式解决:
方式一:指定FeignClient所在包

1
@EnableFeignClients(basePackages = "com.hmall.api.clients")

方式二:指定FeignClient字节码

1
@EnableFeignClients(clients = {UserClient.class})

连接池

OpenFeign对Http请求做了优雅的伪装,不过其底层发起http请求,依赖于其它的框架。这些框架可以自己选择,包括以下三种:
HttpURLConnection:默认实现,不支持连接池
Apache HttpClient :支持连接池
OKHttp:支持连接池
具体源码可以参考FeignBlockingLoadBalancerClient类中的delegate成员变量。

OpenFeign 整合OKHttp

引入依赖

1
2
3
4
5
<!--ok-http-->
<dependency>
<groupId>io.github.openfeign</groupId>
<artifactId>feign-okhttp</artifactId>
</dependency>

开启连接池功能

1
2
3
feign:
okhttp:
enabled: true

OpenFeign输出日志的级别

OpenFeign只会在FeignClient所在包的日志级别为DEBUG时,才会输出日志。而且其日志级别有4级:
NONE:不记录任何日志信息,这是默认值。
BASIC:仅记录请求的方法,URL以及响应状态码和执行时间
HEADERS:在BASIC的基础上,额外记录了请求和响应的头信息
FULL:记录所有请求和响应的明细,包括头信息、请求体、元数据。

由于Feign默认的日志级别就是NONE,所以默认我们看不到请求日志。

要自定义日志级别需要声明一个类型为Logger.Level的Bean,在其中定义日志级别:

1
2
3
4
5
6
7
public class DefaultFeignConfig {  
@Bean
public Logger.Level feignLogLevel(){
return Logger.Level.FULL;
}
}

但此时这个Bean并未生效,要想配置某个FeignClient的日志,可以在@FeignClient注解中声明:

1
@FeignClient(value = "item-service", configuration = DefaultFeignConfig.class) 

如果想要全局配置,让所有FeignClient都按照这个日志配置,则需要在@EnableFeignClients注解中声明

1
@EnableFeignClients(defaultConfiguration = DefaultFeignConfig.class)