Feign入门

Feign介绍

Feign是一个声明式的http客户端
官方地址:https://github.com/OpenFeign/feign

Feign是Netflix开发的声明式、模板化的HTTP客户端, Feign可以帮助我们更快捷、优雅地调用HTTP API。

在Spring Cloud中,使用Feign非常简单——创建一个接口,并在接口上添加一些注解,代码就完成了。Feign支持多种注解,例如Feign自带的注解或者JAX-RS注解等。

Spring Cloud对Feign进行了增强,使Feign支持了Spring MVC注解,并整合了Ribbon和Eureka,从而让Feign的使用更加方便。

Spring Cloud Feign是基于Netflix feign实现,整合了Spring Cloud Ribbon和Spring Cloud Hystrix,除了提供这两者的强大功能外,还提供了一种声明式的Web服务客户端定义的方式。

Spring Cloud Feign帮助我们定义和实现依赖服务接口的定义。在Spring Cloud feign的实现下,只需要创建一个接口并用注解方式配置它,即可完成服务提供方的接口绑定,简化了在使用Spring Cloud Ribbon时自行封装服务调用客户端的开发量。

Spring Cloud Feign具备可插拔的注解支持,支持Feign注解、JAX-RS注解和Spring MVC的注解。

Feign的使用与配置

Springboot集成Feign

pom文件中引入feign的依赖:

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

添加注解启动类添加注解开启Feign的功能:

@SpringBootApplication
@EnableFeignClients

编写Feign的客户端:

@FeignClient("userservice")
public interface UserClient {
    @GetMapping("/getUser/{id}")
    User queryById(@PathVariable("id") Long id);
}

日志配置

使用application.yml配置

feign:
  client:
    config:
      default: # 这里用default就是全局配置,如果是写服务名称,则是针对某个微服务的配置
        loggerLevel: FULL # 四种不同的级别
        
#NONE:不输出日志。
#BASIC:只输出请求方法的 URL 和响应的状态码以及接口执行的时间。
#HEADERS:将 BASIC 信息和请求头信息输出。
#FULL:输出完整的请求信息。

使用Java类注解配置

@Configuration
public class FeignConfiguration {
    @Bean
    public Logger.Level feignLogLevel(){
        return Logger.Level.BASIC; // 日志级别为BASIC
    }
}

如果要全局生效,将其放到启动类的@EnableFeignClients这个注解中:

@EnableFeignClients(defaultConfiguration = DefaultFeignConfiguration .class);

如果是局部生效,则把它放到对应的@FeignClient这个注解中:

@FeignClient(value = "userservice", configuration = DefaultFeignConfiguration .class);

请求压缩

Spring Cloud Feign 支持对请求和响应进行GZIP压缩,以减少通信过程中的性能损耗。
只有当 Feign 的 Http Client 不是 okhttp3 的时候,压缩才会生效。
通过下面的参数即可开启请求与响应的压缩功能:

feign:
  client:
    config:
      default: # 这里用default就是全局配置,如果是写服务名称,则是针对某个微服务的配置
        loggerLevel: FULL # 四种不同的级别:NONE、BASIC、HEADERS、FULL
  compression:
    request:
      mime-types: application/json,application/xml
      enabled: true
      min-request-size: 2048

客户端组件

Feign 中默认使用 JDK 原生的 URLConnection 发送 HTTP 请求。
我们可以集成别的组件来替换掉 URLConnection,比如 Apache HttpClient,OkHttp。
pom文件中引入Apache的HttpClient依赖

<!--httpClient的依赖 -->
<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-httpclient</artifactId>
</dependency>

application.yml中添加配置

feign:
  httpclient:
    enabled: true # 开启feign对HttpClient的支持
    max-connections: 200 # 最大的连接数
    max-connections-per-route: 50 # 每个路径的最大连接数

重试机制

Feign的重试机制在源码中默认关闭的,因为Ribbon的重试机制和Fiegn原来的重试机制冲突,所以在一般情况下,Feign的重试机制指的就是Ribbon的重试机制。

上一篇:03-Feign性能优化


下一篇:Feign