什么是Feign？

　　Feign可以把Rest的請(qǐng)求進(jìn)行隱藏，偽裝成類(lèi)似SpringMVC的Controller一樣，不需要自己拼接Url，拼接參數(shù)等操作，都交給Feign去做。

　　Feign是Netflix開(kāi)發(fā)的聲明式、模板化的Http客戶端，其靈感來(lái)自Retrofit、JAXRS-2.0以及WebSocket。

　　Feign可以幫助我們更加便捷、優(yōu)雅地調(diào)用HttpApi。

　　SpringCloud對(duì)Feign進(jìn)行了增強(qiáng)，使Feign支持了SpringMVC注解，并整合了Ribbon和Eureka，從而讓Feign的使用更加方便。

?

初步使用Feign

導(dǎo)入依賴(lài)

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

?

開(kāi)啟Feign功能

　　添加注解，開(kāi)啟Feign功能。

@SpringCloudApplication
@EnableFeignClients // 開(kāi)啟feign客戶端
public class ItcastServiceConsumerApplication {
    
    public static void main(String[] args) {
        SpringApplication.run(ItcastServiceConsumerApplication.class, args);
    }
}

　　刪除RestTemplate：Feign已經(jīng)自動(dòng)繼承了Ribbon負(fù)載均衡的RestTemplate。所以，此處不需要再注冊(cè)RestTemplate。

?

Feign的客戶端

@FeignClient(value = "service-provider") // 標(biāo)注該類(lèi)是一個(gè)feign接口
public interface UserClient {

    @GetMapping("user/{id}")
    User queryById(@PathVariable("id") Long id);
}

　　這是一個(gè)接口，F(xiàn)eign會(huì)通過(guò)動(dòng)態(tài)代理，幫我們生成實(shí)現(xiàn)類(lèi)。這點(diǎn)跟Mybatis的mapper很像。

　　@FeignClient，聲明這是一個(gè)Feign客戶端，類(lèi)似@Mapper注解。同時(shí)通過(guò)value屬性指定服務(wù)名稱(chēng)。

　　接口中的定義方法，完全采用SpringMVC的注解，F(xiàn)eign會(huì)根據(jù)注解幫我們生成URL，并訪問(wèn)獲取結(jié)果。

@Controller
@RequestMapping("consumer/user")
public class UserController {

    @Autowired
    private UserClient userClient;

    @GetMapping
    @ResponseBody
    public User queryUserById(@RequestParam("id") Long id){
        User user = this.userClient.queryUserById(id);
        return user;
    }

}

?

負(fù)載均衡

　　Feign中本身已經(jīng)集成了Ribbon依賴(lài)和自動(dòng)配置。

　　因此不需要額外引入依賴(lài)，也不需要再注冊(cè)RestTemplate對(duì)象。

?

Hystrix支持

　　Feign默認(rèn)也有對(duì)Hystrix的繼承。

　　默認(rèn)情況是關(guān)閉的，需要通過(guò)下面的參數(shù)來(lái)開(kāi)啟：

feign:
  hystrix:
    enabled: true # 開(kāi)啟Feign的熔斷功能

?

請(qǐng)求壓縮

　　Spring Cloud Feign支持對(duì)請(qǐng)求和響應(yīng)進(jìn)行GZIP壓縮，以減少通信過(guò)程中性能損耗。

　　通過(guò)下面的參數(shù)即可開(kāi)啟請(qǐng)求和響應(yīng)的壓縮功能：

feign:
  compression:
    request:
      enabled: true # 開(kāi)啟請(qǐng)求壓縮
    response:
      enabled: true # 開(kāi)啟響應(yīng)壓縮　　

　　同時(shí)，也可以對(duì)請(qǐng)求的數(shù)據(jù)類(lèi)型，以及觸發(fā)壓縮的大小下限進(jìn)行設(shè)置：

feign:
  compression:
    request:
      enabled: true # 開(kāi)啟請(qǐng)求壓縮
      mime-types: text/html,application/xml,application/json # 設(shè)置壓縮的數(shù)據(jù)類(lèi)型
      min-request-size: 2048 # 設(shè)置觸發(fā)壓縮的大小下限

?

日志級(jí)別

　　通過(guò) logging.level.xx=debug 設(shè)置日志級(jí)別。

　　這個(gè)對(duì)Feign客戶端不會(huì)產(chǎn)生效果，因?yàn)锧FeignClient注解修改的客戶端在被代理時(shí)，都會(huì)創(chuàng)建一個(gè)新的Feign.Logger實(shí)例。

　　需要額外指定這個(gè)日志的級(jí)別。

logging:
  level:
    cn.itcast: debug

@Configuration
public class FeignLogConfiguration {

    @Bean
    Logger.Level feignLoggerLevel(){
        return Logger.Level.FULL;
    }
}

　　NONE：不記錄任何日志信息，默認(rèn)值。

　　BASIC：僅記錄請(qǐng)求的方法，URL以及響應(yīng)狀態(tài)碼和執(zhí)行時(shí)間。

　　HEADERS：在BASIC的基礎(chǔ)上，額外記錄了請(qǐng)求和響應(yīng)的頭信息。

　　FULL：記錄所有請(qǐng)求和響應(yīng)的明細(xì)，包括頭信息、請(qǐng)求體，元數(shù)據(jù)。

?

FeignClient中指定配置類(lèi)

@FeignClient(value = "service-privider", fallback = UserFeignClientFallback.class, configuration = FeignConfig.class)
public interface UserFeignClient {
    @GetMapping("/user/{id}")
    User queryUserById(@PathVariable("id") Long id);
}

?