Spring Cloud Feign 組成和配置

Feign的組成

接口	作用	默認值
Feign.Builder	Feign的入口	Feign.Builder
Client	Feign底層用什么去請求	和Ribbon配合時：LoadBalancerFeignClient 不和Ribbon配合時：Fgien.Client.Default
Contract	契約，注解支持	SpringMVCContract
Encoder	解碼器，用於將獨享轉換成HTTP請求消息體	SpringEncoder
Decoder	編碼器，將相應消息體轉成對象	ResponseEntityDecoder
Logger	日志管理器	Slf4jLogger
RequestInterceptor	用於為每個請求添加通用邏輯（攔截器，例子：比如想給每個請求都帶上heared）	無

Feign的日記級別

日志級別	打印內容
NONE（默認）	不記錄任何日志
BASIC	僅記錄請求方法，URL，響應狀態代碼以及執行時間（適合生產環境）
HEADERS	記錄BASIC級別的基礎上，記錄請求和響應的header
FULL	記錄請求和弦ineader，body和元數據

首先如何整合Feign

遵循SpringBoot的三板斧第一步：加依賴

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

第二步：寫注解

@EnableFeignClients //在啟動類上加

第三步：寫配置

如何給Feign添加日志級別

細粒度

方式一：代碼實現第一步：添加Feign配置類，可以添加在主類下，但是不用添加@Configuration。如果添加了@Configuration而且又放在了主類之下，那么就會所有Feign客戶端實例共享，同Ribbon配置類一樣父子上下文加載沖突；如果一定添加@Configuration，就放在主類加載之外的包。建議還是不用加@Configuration。

public class FeignConfig {
    @Bean
    public Logger.Level Logger() {
        return Logger.Level.FULL;
    }
}

第二步：給@FeignClient添加配置類

//@FeignClient configuration = GoodsFeignConfig.class 細粒度配置，指定配置類
@FeignClient(name = "goods", configuration = FeignConfig.class)

第四步：寫配置

logging:
  level:
    com.xxx.xxx.FeignAPI: DEBUG #需要將FeignClient接口全路徑寫上# 開啟日志 格式為logging.level. Feign客戶端路徑

方式二：配置屬性實現

feign:
  client:
    config:
      #想要調用的微服務名稱
      server-1:
        loggerLevel: FULL

全局配置

方式一：代碼實現添加了@Configuration放在了主類之下，那么就會所有Feign客戶端實例共享，同Ribbon配置類一樣父子上下文加載沖突；讓父子上下文ComponentScan重疊（強烈不建議）唯一正確方式

//在啟動類上為@EnableFeignClients注解添加defaultConfiguration配置
@EnableFeignClients(defaultConfiguration = FeignConfig.class)

方式二：配置屬性實現

feign:
  client:
    config:
      #將調用的微服務名稱改成default就配置成全局的了
      default:
        loggerLevel: FULL

Feign支持的配置項

代碼方式

配置項	作用
Logger.Level	指定日志級別
Retryer	指定重試策略
ErrorDecoder	指定錯誤解碼器
Request.Options	超時時間
Collection	攔截器
SetterFactory	用於設置Hystrix的配置屬性，Fgien整合Hystrix才會用

配置屬性

feign:
  client:
    config:
      feignName:
        connectTimeout: 5000  # 相當於Request.Optionsn 連接超時時間
        readTimeout: 5000     # 相當於Request.Options 讀取超時時間
        loggerLevel: full     # 配置Feign的日志級別，相當於代碼配置方式中的Logger
        errorDecoder: com.example.SimpleErrorDecoder  # Feign的錯誤解碼器，相當於代碼配置方式中的ErrorDecoder
        retryer: com.example.SimpleRetryer  # 配置重試，相當於代碼配置方式中的Retryer
        requestInterceptors: # 配置攔截器，相當於代碼配置方式中的RequestInterceptor
          - com.example.FooRequestInterceptor
          - com.example.BarRequestInterceptor
        # 是否對404錯誤解碼
        decode404: false
        encode: com.example.SimpleEncoder
        decoder: com.example.SimpleDecoder
        contract: com.example.SimpleContract

Feign還支持對請求和響應進行GZIP壓縮，以提高通信效率，配置方式如下：

# 配置請求GZIP壓縮
feign.compression.request.enabled=true
# 配置響應GZIP壓縮
feign.compression.response.enabled=true
# 配置壓縮支持的MIME TYPE
feign.compression.request.mime-types=text/xml,application/xml,application/json
# 配置壓縮數據大小的下限
feign.compression.request.min-request-size=2048

Ribbon配置 VS Feign配置

粒度	Ribbon	Feign
代碼局部	@RibbonClient(configuration=RibbonConfig.class)，RibbonConfig類必須加@Configuration,且必須放在父上下文無法掃到的包下	@FeignClient(configuration=FeignConfig.class)，FeignConfig類的@Configuration可以不加（可選），如果有，必須放在父上下文無法掃到的包下
代碼全局	@RibbonClients(defaultConfigurtion=RibbonConfig.class)	@EnableFeignClients(defaultConfiguration = FeignConfig.class) ...
配置屬性局部	.ribbon.NFLoadBalancerClassName ...	feign.client.config. .loggerLevel ...
配置屬性全局	無	feign.client.config.default.loggerLevel

Feign 代碼方式 VS 配置屬性方式

配置方式	有點	缺點
代碼配置	基於代碼，更加靈活	如果Feign的配置類加了@Configuration注解，需注意父子上下文，線上修改需要重打包，發布
屬性配置	易上手 配置更加直觀 線上修改無需重新打包，發布 優先級更高	極端場景下沒有代碼配置更加靈活

優先級：細粒度屬性配置 > 細粒度代碼配置 > 全局屬性配置 > 全局代碼配置

趙小胖個人博客