在Spring Cloud Netflix棧中,各個(gè)微服務(wù)都是以HTTP接口的形式暴露自身服務(wù)的,因此在調(diào)用遠(yuǎn)程服務(wù)時(shí)就必須使用HTTP客戶端。我們可以使用JDK原生的URLConnection
、Apache的Http Client
、Netty的異步HTTP Client, Spring的RestTemplate
。但是,用起來(lái)最方便、最優(yōu)雅的還是要屬Feign了。
Feign簡(jiǎn)介
Feign是一種聲明式、模板化的HTTP客戶端。在Spring Cloud中使用Feign, 我們可以做到使用HTTP請(qǐng)求遠(yuǎn)程服務(wù)時(shí)能與調(diào)用本地方法一樣的編碼體驗(yàn),開(kāi)發(fā)者完全感知不到這是遠(yuǎn)程方法,更感知不到這是個(gè)HTTP請(qǐng)求。比如:
@Autowired
private AdvertGropRemoteService service; // 遠(yuǎn)程服務(wù)
public AdvertGroupVO foo(Integer groupId) {
return service.findByGroupId(groupId); // 通過(guò)HTTP調(diào)用遠(yuǎn)程服務(wù)
}
開(kāi)發(fā)者通過(guò)service.findByGroupId()
就能完成發(fā)送HTTP請(qǐng)求和解碼HTTP返回結(jié)果并封裝成對(duì)象的過(guò)程。
Feign的定義
為了讓Feign知道在調(diào)用方法時(shí)應(yīng)該向哪個(gè)地址發(fā)請(qǐng)求以及請(qǐng)求需要帶哪些參數(shù),我們需要定義一個(gè)接口:
@FeignClient(name = "ea") // [A]
public interface AdvertGroupRemoteService {
@RequestMapping(value = "/group/{groupId}", method = RequestMethod.GET) // [B]
AdvertGroupVO findByGroupId(@PathVariable("groupId") Integer adGroupId) // [C]
@RequestMapping(value = "/group/{groupId}", method = RequestMethod.PUT)
void update(@PathVariable("groupId") Integer groupId, @RequestParam("groupName") String groupName)
A: @FeignClient
用于通知Feign組件對(duì)該接口進(jìn)行代理(不需要編寫(xiě)接口實(shí)現(xiàn)),使用者可直接通過(guò)@Autowired
注入。
B: @RequestMapping
表示在調(diào)用該方法時(shí)需要向/group/{groupId}
發(fā)送GET
請(qǐng)求。
C: @PathVariable
與SpringMVC
中對(duì)應(yīng)注解含義相同。
Spring Cloud應(yīng)用在啟動(dòng)時(shí),F(xiàn)eign會(huì)掃描標(biāo)有@FeignClient
注解的接口,生成代理,并注冊(cè)到Spring容器中。生成代理時(shí)Feign會(huì)為每個(gè)接口方法創(chuàng)建一個(gè)RequetTemplate
對(duì)象,該對(duì)象封裝了HTTP請(qǐng)求需要的全部信息,請(qǐng)求參數(shù)名、請(qǐng)求方法等信息都是在這個(gè)過(guò)程中確定的,F(xiàn)eign的模板化就體現(xiàn)在這里。
在本例中,我們將Feign與Eureka和Ribbon組合使用,@FeignClient(name = "ea")
意為通知Feign在調(diào)用該接口方法時(shí)要向Eureka中查詢名為ea
的服務(wù),從而得到服務(wù)URL。
Feign的Encoder、Decoder和ErrorDecoder
Feign將方法簽名中方法參數(shù)對(duì)象序列化為請(qǐng)求參數(shù)放到HTTP請(qǐng)求中的過(guò)程,是由編碼器(Encoder)完成的。同理,將HTTP響應(yīng)數(shù)據(jù)反序列化為java對(duì)象是由解碼器(Decoder)完成的。
默認(rèn)情況下,F(xiàn)eign會(huì)將標(biāo)有@RequestParam
注解的參數(shù)轉(zhuǎn)換成字符串添加到URL中,將沒(méi)有注解的參數(shù)通過(guò)Jackson轉(zhuǎn)換成json放到請(qǐng)求體中。注意,如果在@RequetMapping
中的method
將請(qǐng)求方式指定為POST
,那么所有未標(biāo)注解的參數(shù)將會(huì)被忽略,例如:
@FeignClient(name = "ea") // [A]
public interface AdvertGroupRemoteService {
@RequestMapping(value = "/group/{groupId}", method = RequestMethod.GET) // [B]
AdvertGroupVO findByGroupId(@PathVariable("groupId") Integer adGroupId) // [C]
@RequestMapping(value = "/group/{groupId}", method = RequestMethod.PUT)
void update(@PathVariable("groupId") Integer groupId, @RequestParam("groupName") String groupName)
此時(shí)因?yàn)槁暶鞯氖荊ET請(qǐng)求沒(méi)有請(qǐng)求體,所以obj
參數(shù)就會(huì)被忽略。
在Spring Cloud環(huán)境下,F(xiàn)eign的Encoder*只會(huì)用來(lái)編碼沒(méi)有添加注解的參數(shù)*。如果你自定義了Encoder, 那么只有在編碼obj
參數(shù)時(shí)才會(huì)調(diào)用你的Encoder。對(duì)于Decoder, 默認(rèn)會(huì)委托給SpringMVC中的MappingJackson2HttpMessageConverter
類(lèi)進(jìn)行解碼。只有當(dāng)狀態(tài)碼不在200 ~ 300之間時(shí)ErrorDecoder才會(huì)被調(diào)用。ErrorDecoder的作用是可以根據(jù)HTTP響應(yīng)信息返回一個(gè)異常,該異常可以在調(diào)用Feign接口的地方被捕獲到。我們目前就通過(guò)ErrorDecoder來(lái)使Feign接口拋出業(yè)務(wù)異常以供調(diào)用者處理。
Feign的HTTP Client
Feign在默認(rèn)情況下使用的是JDK原生的URLConnection
發(fā)送HTTP請(qǐng)求,沒(méi)有連接池,但是對(duì)每個(gè)地址會(huì)保持一個(gè)長(zhǎng)連接,即利用HTTP的persistence connection
。我們可以用Apache的HTTP Client替換Feign原始的http client, 從而獲取連接池、超時(shí)時(shí)間等與性能息息相關(guān)的控制能力。Spring Cloud從Brixtion.SR5
版本開(kāi)始支持這種替換,首先在項(xiàng)目中聲明Apache HTTP Client和feign-httpclient
依賴(lài):
@RequestMapping(value = "/group/{groupId}", method = RequestMethod.GET)
void update(@PathVariable("groupId") Integer groupId, @RequestParam("groupName") String groupName, DataObject obj);
然后在application.properties
中添加:
feign.httpclient.enabled=true
總結(jié)
通過(guò)Feign, 我們能把HTTP遠(yuǎn)程調(diào)用對(duì)開(kāi)發(fā)者完全透明,得到與調(diào)用本地方法一致的編碼體驗(yàn)。這一點(diǎn)與阿里Dubbo中暴露遠(yuǎn)程服務(wù)的方式類(lèi)似,區(qū)別在于Dubbo是基于私有二進(jìn)制協(xié)議,而Feign本質(zhì)上還是個(gè)HTTP客戶端。如果是在用Spring Cloud Netflix搭建微服務(wù),那么Feign無(wú)疑是最佳選擇。
http://blog.csdn.net/tracker_w/article/category/6360121
http://blog.csdn.net/neosmith/article/details/52449921