業餘草 SpringCloud教程 | 第三篇: 服務消費者（Feign）(Finchley版本)

上一篇文章，講述瞭如何通過RestTemplate+Ribbon去消費服務，這篇文章主要講述如何通過Feign去消費服務。

一、Feign簡介

Feign是一個宣告式的偽Http客戶端，它使得寫Http客戶端變得更簡單。使用Feign，只需要建立一個介面並註解。它具有可插拔的註解特性，可使用Feign 註解和JAX-RS註解。Feign支援可插拔的編碼器和解碼器。Feign預設整合了Ribbon，並和Eureka結合，預設實現了負載均衡的效果。

簡而言之：

• Feign 採用的是基於介面的註解
• Feign 整合了ribbon，具有負載均衡的能力
• 整合了Hystrix，具有熔斷的能力

二、準備工作

繼續用上一節的工程， 啟動eureka-server，埠為8761; 啟動service-hi 兩次，埠分別為8762 、8773.

三、建立一個feign的服務

新建一個spring-boot工程，取名為serice-feign，在它的pom檔案引入Feign的起步依賴spring-cloud-starter-feign、Eureka的起步依賴spring-cloud-starter-netflix-eureka-client、Web的起步依賴spring-boot-starter-web，程式碼如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.forezp</groupId>
    <artifactId>service-feign</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>service-feign</name>
    <description>Demo project for Spring Boot</description>


    <parent>
        <groupId>com.forezp</groupId>
        <artifactId>sc-f-chapter3</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>
    </dependencies>

    </project>

在工程的配置檔案application.yml檔案，指定程式名為service-feign，埠號為8765，服務註冊地址為http://localhost:8761/eureka/ ，程式碼如下：

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka/
server:
  port: 8765
spring:
  application:
    name: service-feign

在程式的啟動類ServiceFeignApplication ，加上@EnableFeignClients註解開啟Feign的功能：

@SpringBootApplication
@EnableEurekaClient
@EnableDiscoveryClient
@EnableFeignClients
public class ServiceFeignApplication {

    public static void main(String[] args) {
        SpringApplication.run( ServiceFeignApplication.class, args );
    }
}

定義一個feign介面，通過@ FeignClient（“服務名”），來指定呼叫哪個服務。比如在程式碼中呼叫了service-hi服務的“/hi”介面，程式碼如下：

@FeignClient(value = "service-hi")
public interface SchedualServiceHi {
    @RequestMapping(value = "/hi",method = RequestMethod.GET)
    String sayHiFromClientOne(@RequestParam(value = "name") String name);
}

在Web層的controller層，對外暴露一個”/hi”的API介面，通過上面定義的Feign客戶端SchedualServiceHi 來消費服務。程式碼如下：

@RestController
public class HiController {


    //編譯器報錯，無視。 因為這個Bean是在程式啟動的時候注入的，編譯器感知不到，所以報錯。
    @Autowired
    SchedualServiceHi schedualServiceHi;

    @GetMapping(value = "/hi")
    public String sayHi(@RequestParam String name) {
        return schedualServiceHi.sayHiFromClientOne( name );
    }
}

啟動程式，多次訪問http://localhost:8765/hi?name=forezp,瀏覽器交替顯示：

hi forezp,i am from port:8762

hi forezp,i am from port:8763

Feign原始碼解析：http://blog.csdn.net/forezp/article/details/73480304

本文原始碼下載： 
https://github.com/forezp/SpringCloudLearning/tree/master/sc-f-chapter3

五、參考資料

本文參考了以下：

http://cloud.spring.io/spring-cloud-static/Finchley.RELEASE/single/spring-cloud.html

感謝您的關注！可加QQ1群：135430763，QQ2群：454796847，QQ3群：187424846。QQ群進群密碼：xttblog，想加微信群的朋友，可以微信搜尋：xmtxtt，備註：“xttblog”，新增助理微信拉你進群。備註錯誤不會同意好友申請。再次感謝您的關注！後續有精彩內容會第一時間發給您！原創文章投稿請傳送至532009913@qq.com郵箱。商務合作可新增助理微信進行溝通！