FeignClient註解及參數

1、FeignClient註解

  FeignClient註解被@Target(ElementType.TYPE)修飾，表示FeignClient註解的做用目標在接口上

1 2 3 4 5

@FeignClient(name =  "github-client" , url =  "https://api.github.com" , configuration = GitHubExampleConfig. class ) public  interface  GitHubClient {      @RequestMapping(value =  "/search/repositories" , method = RequestMethod.GET)      String searchRepo(@RequestParam( "q" ) String queryStr); }

　聲明接口以後，在代碼中經過@Resource注入以後便可使用。@FeignClient標籤的經常使用屬性以下：

• name：指定FeignClient的名稱，若是項目使用了Ribbon，name屬性會做爲微服務的名稱，用於服務發現
• url: url通常用於調試，能夠手動指定@FeignClient調用的地址
• decode404:當發生http 404錯誤時，若是該字段位true，會調用decoder進行解碼，不然拋出FeignException
• configuration: Feign配置類，能夠自定義Feign的Encoder、Decoder、LogLevel、Contract
• fallback: 定義容錯的處理類，當調用遠程接口失敗或超時時，會調用對應接口的容錯邏輯，fallback指定的類必須實現@FeignClient標記的接口
• fallbackFactory: 工廠類，用於生成fallback類示例，經過這個屬性咱們能夠實現每一個接口通用的容錯邏輯，減小重複的代碼
• path: 定義當前FeignClient的統一前綴

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

@FeignClient(name =  "github-client" ,          url =  "https://api.github.com" ,          configuration = GitHubExampleConfig. class ,          fallback = GitHubClient.DefaultFallback. class ) public  interface  GitHubClient {      @RequestMapping(value =  "/search/repositories" , method = RequestMethod.GET)      String searchRepo(@RequestParam( "q" ) String queryStr);        /**       * 容錯處理類，當調用失敗時，簡單返回空字符串       */      @Component      public  class  DefaultFallback implements GitHubClient {          @Override          public  String searchRepo(@RequestParam( "q" ) String queryStr) {              return  "" ;          }      } }

　在使用fallback屬性時，須要使用@Component註解，保證fallback類被Spring容器掃描到,GitHubExampleConfig內容以下：

1 2 3 4 5 6 7

@Configuration public  class  GitHubExampleConfig {      @Bean      Logger.Level feignLoggerLevel() {          return  Logger.Level.FULL;      } }

　　在使用FeignClient時，Spring會按name建立不一樣的ApplicationContext，經過不一樣的Context來隔離FeignClient的配置信息，在使用配置類時，不能把配置類放到Spring App Component scan的路徑下，不然，配置類會對全部FeignClient生效.

2、Feign Client 和@RequestMapping

當前工程中有和Feign Client中同樣的Endpoint時，Feign Client的類上不能用@RequestMapping註解不然，當前工程該endpoint http請求且使用accpet時會報404

Controller：

1 2 3 4 5 6 7 8 9 10 11 12 13

@RestController @RequestMapping( "/v1/card" ) public  class  IndexApi {        @PostMapping( "balance" )      @ResponseBody      public  Info index() {          Info.Builder builder =  new  Info.Builder();          builder.withDetail( "x" , 2);          builder.withDetail( "y" , 2);          return  builder.build();      } }

Feign Client

1 2 3 4 5 6 7 8 9 10 11 12 13

@FeignClient(          name =  "card" ,          url =  "http://localhost:7913" ,          fallback = CardFeignClientFallback. class ,          configuration = FeignClientConfiguration. class ) @RequestMapping(value =  "/v1/card" ) public  interface  CardFeignClient {        @RequestMapping(value =  "/balance" , method = RequestMethod.POST, produces = MediaType.APPLICATION_JSON_VALUE)      Info info();   }

if @RequestMapping is used on class, when invoke http /v1/card/balance, like this :

若是 @RequestMapping註解被用在FeignClient類上，當像以下代碼請求/v1/card/balance時，注意有Accept header：

1 2 3 4

Content-Type:application/json Accept:application/json   POST http: //localhost:7913/v1/card/balance

那麼會返回 404。

若是不包含Accept header時請求，則是OK：

1 2	Content-Type:application/json POST http: //localhost:7913/v1/card/balance

或者像下面不在Feign Client上使用@RequestMapping註解,請求也是ok，不管是否包含Accept:

1 2 3 4 5 6 7 8 9 10 11 12 13

@FeignClient(          name =  "card" ,          url =  "http://localhost:7913" ,          fallback = CardFeignClientFallback. class ,          configuration = FeignClientConfiguration. class )   public  interface  CardFeignClient {        @RequestMapping(value =  "/v1/card/balance" , method = RequestMethod.POST, produces = MediaType.APPLICATION_JSON_VALUE)      Info info();   }

 

3、Feign請求超時問題

Hystrix默認的超時時間是1秒，若是超過這個時間還沒有響應，將會進入fallback代碼。而首次請求每每會比較慢（由於Spring的懶加載機制，要實例化一些類），這個響應時間可能就大於1秒了
解決方案有三種，以feign爲例。
方法一
hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds: 5000
該配置是讓Hystrix的超時時間改成5秒
方法二
hystrix.command.default.execution.timeout.enabled: false
該配置，用於禁用Hystrix的超時時間
方法三
feign.hystrix.enabled: false
該配置，用於索性禁用feign的hystrix。該作法除非一些特殊場景，不推薦使用。

參見： http://www.itmuch.com/spring-cloud-sum-feign/