前言

為啥需要學(xué)Feign呢？我們先來回顧之前寫的代碼

先來看我們以前利用RestTemplate發(fā)起遠(yuǎn)程調(diào)用的代碼：

這里就有幾個(gè)問題：

• 代碼可讀性差，編程體驗(yàn)不統(tǒng)一
• 參數(shù)復(fù)雜URL難以維護(hù)

而Feign是一個(gè)聲明式的http客戶端。其作用就是幫助我們優(yōu)雅的實(shí)現(xiàn)http請(qǐng)求的發(fā)送，解決上面提到的問題

1.Feign替代RestTemplate

1.1 引入依賴

我們?cè)趏rder-service服務(wù)的pom文件中引入feign的依賴：

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

1.2 添加注釋

在order-service的啟動(dòng)類添加注解開啟Feign的功能：

1.3 編寫Feign的客戶端

在order-service中新建一個(gè)接口，內(nèi)容如下：

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

這個(gè)客戶端主要是基于SpringMVC的注解來聲明遠(yuǎn)程調(diào)用的信息，比如：

• 服務(wù)名稱：userservice
• 請(qǐng)求方式：GET
• 請(qǐng)求路徑：/user/{id}
• 請(qǐng)求參數(shù)：Long id
• 返回值類型：User

這樣，F(xiàn)eign就可以幫助我們發(fā)送http請(qǐng)求，無需自己使用RestTemplate來發(fā)送了

1.4 測(cè)試

修改order-service中的OrderService類中的queryOrderById方法，使用Feign客戶端代替RestTemplate：

1.5 總結(jié)

使用Feign的步驟：

① 引入依賴

② 添加@EnableFeignClients注解

③ 編寫FeignClient接口

④ 使用FeignClient中定義的方法代替RestTemplate

2.自定義配置

Feign可以支持很多的自定義配置，如下表所示：

一般情況下，默認(rèn)值就能滿足我們使用，如果要自定義時(shí)，只需要?jiǎng)?chuàng)建自定義的@Bean覆蓋默認(rèn)Bean即可

下面以日志為例來演示如何自定義配置：

2.1 配置文件方式

基于配置文件修改feign的日志級(jí)別可以針對(duì)單個(gè)服務(wù)：

feign:  
  client:
    config: 
      userservice: # 針對(duì)某個(gè)微服務(wù)的配置
        loggerLevel: FULL #  日志級(jí)別 

也可以針對(duì)所有服務(wù)：

feign:  
  client:
    config: 
      default: # 這里用default就是全局配置，如果是寫服務(wù)名稱，則是針對(duì)某個(gè)微服務(wù)的配置
        loggerLevel: FULL #  日志級(jí)別 

而日志的級(jí)別分為四種：

• 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ù)

2.2 Java代碼方式

也可以基于Java代碼來修改日志級(jí)別，先聲明一個(gè)類，然后聲明一個(gè)Logger.Level的對(duì)象：

public class DefalutFeignConfiguration {
    @Bean
    public Logger.Level feignLogLevel(){
        return Logger.Level.BASIC; // 日志級(jí)別為BASIC
    }
}

如果要全局生效，將其放到啟動(dòng)類的@EnableFeignClients這個(gè)注解中：

@EnableFeignClients(defaultConfiguration = DefaultFeignConfiguration .class) 

如果是局部生效，則把它放到對(duì)應(yīng)的@FeignClient這個(gè)注解中：

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

3.Feign使用優(yōu)化

Feign底層發(fā)起http請(qǐng)求，依賴于其它的框架。其底層客戶端實(shí)現(xiàn)包括：

• URLConnection：默認(rèn)實(shí)現(xiàn)，不支持連接池
• Apache HttpClient ：支持連接池
• OKHttp：支持連接池

因此提高Feign的性能主要手段就是使用連接池代替默認(rèn)的URLConnection。

這里我們用Apache的HttpClient來演示：

1）引入依賴

在order-service的pom文件中引入Apache的HttpClient依賴：

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

2）配置連接池

在order-service的application.yml中添加配置：

feign:
  client:
    config:
      default: # default全局的配置
        loggerLevel: BASIC # 日志級(jí)別，BASIC就是基本的請(qǐng)求和響應(yīng)信息
  httpclient:
    enabled: true # 開啟feign對(duì)HttpClient的支持
    max-connections: 200 # 最大的連接數(shù)
    max-connections-per-route: 50 # 每個(gè)路徑的最大連接數(shù)

總結(jié)Feign的優(yōu)化：

日志級(jí)別盡量用basic

使用HttpClient或OKHttp代替URLConnection

① 引入feign-httpClient依賴

② 配置文件開啟httpClient功能，設(shè)置連接池參數(shù)

4.最佳實(shí)踐

所謂最佳實(shí)踐，就是使用過程中總結(jié)的經(jīng)驗(yàn)，最好的一種使用方式。

自習(xí)觀察可以發(fā)現(xiàn)，F(xiàn)eign的客戶端與服務(wù)提供者的controller代碼非常相似：

feign客戶端：

UserController：

有沒有一種辦法簡(jiǎn)化這種重復(fù)的代碼編寫呢？

4.1 繼承方式

一樣的代碼可以通過繼承來共享：

1.定義一個(gè)API接口，利用定義方法，并基于SpringMVC注解做聲明

2.Feign客戶端和Controller都集成改接口

優(yōu)點(diǎn)：

• 簡(jiǎn)單
• 實(shí)現(xiàn)了代碼共享

缺點(diǎn)：

• 服務(wù)提供方、服務(wù)消費(fèi)方緊耦合
• 參數(shù)列表中的注解映射并不會(huì)繼承，因此Controller中必須再次聲明方法、參數(shù)列表、注解

4.2 抽取方式

Feign的Client抽取為獨(dú)立模塊，并且把接口有關(guān)的POJO、默認(rèn)的Feign配置都放到這個(gè)模塊中，提供給所有消費(fèi)者使用。

例如，將UserClient、User、Feign的默認(rèn)配置都抽取到一個(gè)feign-api包中，所有微服務(wù)引用該依賴包，即可直接使用

4.3 實(shí)現(xiàn)基于抽取的最佳實(shí)踐 抽取

首先創(chuàng)建一個(gè)module，命名為feign-api：

項(xiàng)目結(jié)構(gòu)：

在 feign-api 中然后引入feign的starter依賴：

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

然后，order-service中編寫的UserClient、User、DefaultFeignConfiguration都復(fù)制到feign-api項(xiàng)目中

在order-service中使用 feign-api

首先，刪除order-service中的UserClient、User、DefaultFeignConfiguration等類或接口

在order-service的pom文件中中引入feign-api的依賴：

<dependency>
    <groupId>com.xn2001.feign</groupId>
    <artifactId>feign-api</artifactId>
    <version>1.0</version>
</dependency>

修改order-service中的所有與上述三個(gè)組件有關(guān)的導(dǎo)包部分，改成導(dǎo)入feign-api中的包

重啟測(cè)試

重啟后，發(fā)現(xiàn)服務(wù)報(bào)錯(cuò)了：

這是因?yàn)閁serClient現(xiàn)在在cn.itcast.feign.clients包下，

而order-service的@EnableFeignClients注解是在cn.itcast.order包下，不在同一個(gè)包，無法掃描到UserClient。

解決掃描包問題

方式一：

指定Feign應(yīng)該掃描的包：（不推薦）

@EnableFeignClients(basePackages = "cn.itcast.feign.clients")

方式二：

指定需要加載的Client接口：

@EnableFeignClients(clients = {UserClient.class}) 

到此這篇關(guān)于SpringCloud學(xué)習(xí)筆記之Feign遠(yuǎn)程調(diào)用的文章就介紹到這了,更多相關(guān)SpringCloud Feign遠(yuǎn)程調(diào)用內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論