SpringCloud（第 012 篇）電影微服務(wù)接入 Feign 進行客戶端負載均衡，通過 FeignClient 調(diào)用遠程 Http 微服務(wù)
一、大致介紹
1、本章節(jié)主要介紹在 SpringCloud 生態(tài)圈中，使用一個類似于 Java HTTP 客戶端的工具 Feign 來訪問遠程 HTTP 服務(wù)器；
2、雖然說我們可以采用 RestTemplate、URLConnection、Netty、HttpClient都可以訪問遠端 HTTP 服務(wù)器，但是使用 Feign 來說，F(xiàn)eign 可以做到使用 HTTP 請求遠程服務(wù)時就像調(diào)用本地的方法一樣，讓開發(fā)者完全感知不到這是在調(diào)用遠端服務(wù)，感覺無非就是調(diào)用一個 API 方法一樣；
3、當(dāng)我們使用 Feign 的時候，SpringCloud 整合了 Ribbon 和 Eureka 去提供負載均衡；
二、實現(xiàn)步驟
2.1 添加 maven 引用包
<?xml version="1.0" encoding="UTF-8"?>
<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>
<artifactId>springms-consumer-movie-feign</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<parent>
<groupId>com.springms.cloud</groupId>
<artifactId>springms-spring-cloud</artifactId>
<version>1.0-SNAPSHOT</version>
</parent>
<dependencies>
<!-- web模塊 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 客戶端發(fā)現(xiàn)模塊 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>
<!-- 監(jiān)控和管理生產(chǎn)環(huán)境的模塊 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- Java HTTP 客戶端開發(fā)的工具的模塊 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-feign</artifactId>
</dependency>
</dependencies>
</project>
2.2 添加應(yīng)用配置文件（springms-consumer-movie-feign/src/main/resources/application.yml）
spring:
application:
name: springms-consumer-movie-feign
server:
port: 7910
eureka:
client:
# healthcheck:
# enabled: true
serviceUrl:
defaultZone: http://admin:admin@localhost:8761/eureka
instance:
prefer-ip-address: true
instance-id: ${spring.application.name}:${spring.cloud.client.ipAddress}:${spring.application.instance_id:${server.port}}
2.3 添加實體用戶類User（springms-consumer-movie-feign/src/main/java/com/springms/cloud/entity/User.java）
package com.springms.cloud.entity;
import java.math.BigDecimal;
public class User {
private Long id;
private String username;
private String name;
private Short age;
private BigDecimal balance;
public Long getId() {
return this.id;
}
public void setId(Long id) {
this.id = id;
}
public String getUsername() {
return this.username;
}
public void setUsername(String username) {
this.username = username;
}
public String getName() {
return this.name;
}
public void setName(String name) {
this.name = name;
}
public Short getAge() {
return this.age;
}
public void setAge(Short age) {
this.age = age;
}
public BigDecimal getBalance() {
return this.balance;
}
public void setBalance(BigDecimal balance) {
this.balance = balance;
}
}
2.4 添加用戶 Feign 客戶端（springms-consumer-movie-feign/src/main/java/com/springms/cloud/feign/UserFeignClient.java）
package com.springms.cloud.feign;
import com.springms.cloud.entity.User;
import org.springframework.cloud.netflix.feign.FeignClient;
import org.springframework.web.bind.annotation.*;
/**
* 用戶Http請求的客戶端。
*
* 注解FeignClient的傳參：表示的是注冊到 Eureka 服務(wù)上的模塊名稱，也就是需要訪問的微服務(wù)名稱。
*
* @author hmilyylimh
*
* @version 0.0.1
*
* @date 17/9/19
*
*/
@FeignClient("springms-provider-user")
public interface UserFeignClient {
/**
* 這里有兩個坑需要注意：
*
* 1、這里需要設(shè)置請求的方式為 RequestMapping 注解，用 GetMapping 注解是運行不成功的，即 GetMapping 不支持。
*
* 2、注解 PathVariable 里面需要填充變量的名字，不然也是運行不成功的。
*
* @param id
* @return
*/
@RequestMapping(value = "/simple/{id}", method = RequestMethod.GET)
public User findById(@PathVariable("id") Long id);
/**
* 這里也有一個坑需要注意：
*
* 如果入?yún)⑹且粋€對象的話，那么這個方法在 feign 里面默認為 POST 方法，就算你寫成 GET 方式也無濟于事。
*
* @param user
* @return
*/
@RequestMapping(value = "/user", method = RequestMethod.POST)
public User postUser(@RequestBody User user);
}
2.5 添加電影Web訪問層Controller（springms-consumer-movie-feign/src/main/java/com/springms/cloud/controller/MovieFeignController.java）
package com.springms.cloud.controller;
import com.springms.cloud.entity.User;
import com.springms.cloud.feign.UserFeignClient;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import java.util.Random;
/**
* 電影 Feign 控制器，通過 Feign 訪問遠端服務(wù)。
*
* @author hmilyylimh
*
* @version 0.0.1
*
* @date 17/9/19
*
*/
@RestController
public class MovieFeignController {
@Autowired
private UserFeignClient userFeignClient;
@GetMapping("/movie/{id}")
public User findById(@PathVariable Long id) {
return userFeignClient.findById(id);
}
@GetMapping("/movie/user")
public User postUser(User user){
Random random = new Random();
User tmpUser = new User();
long id = (long) random.nextInt(100);
tmpUser.setId(id);
tmpUser.setName("TempUser" + id);
tmpUser.setAge((short) id);
return userFeignClient.postUser(tmpUser);
}
}
2.6 添加電影微服務(wù)啟動類（springms-consumer-movie-feign/src/main/java/com/springms/cloud/MsConsumerMovieFeignApplication.java）
package com.springms.cloud;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
import org.springframework.cloud.netflix.feign.EnableFeignClients;
/**
* 電影微服務(wù)接入 Feign 進行客戶端負載均衡，通過 FeignClient 調(diào)用遠程 Http 微服務(wù)。
*
* Feign: Java HTTP 客戶端開發(fā)的工具。
*
* 注解 EnableFeignClients 表示該電影微服務(wù)已經(jīng)接入 Feign 模塊。
*
* @author hmilyylimh
*
* @version 0.0.1
*
* @date 17/9/19
*
*/
@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients
public class MsConsumerMovieFeignApplication {
public static void main(String[] args) {
SpringApplication.run(MsConsumerMovieFeignApplication.class, args);
System.out.println("【【【【【【 電影Feign微服務(wù) 】】】】】】已啟動.");
}
}
三、Feign 簡述流程分析
總到來說，F(xiàn)eign的源碼實現(xiàn)的過程如下：
首先通過@EnableFeignCleints注解開啟FeignCleint
根據(jù)Feign的規(guī)則實現(xiàn)接口，并加@FeignCleint注解
程序啟動后，會進行包掃描，掃描所有的@ FeignCleint的注解的類，并將這些信息注入到ioc容器中。
當(dāng)接口的方法被調(diào)用，通過jdk的代理，來生成具體的RequesTemplate
RequesTemplate在生成Request
Request交給Client去處理，其中Client可以是HttpUrlConnection、HttpClient也可以是Okhttp
最后Client被封裝到LoadBalanceClient類，這個類結(jié)合類Ribbon做到了負載均衡。
四、測試
/****************************************************************************************
一、電影微服務(wù)接入 Feign 進行客戶端負載均衡，通過 FeignClient 調(diào)用遠程 Http 微服務(wù)（測試接入 Feign 模塊）：
1、注解：EnableFeignClients
2、啟動 springms-discovery-eureka 模塊服務(wù)，啟動1個端口；
3、啟動 springms-provider-user 模塊服務(wù)，啟動1個端口；
4、啟動 springms-consumer-movie-feign 模塊服務(wù)；
5、在瀏覽器輸入地址http://localhost:7910/movie/1 或者 http://localhost:7910/movie/user 都可以看到信息成功的被打印出來；
總結(jié)：說明接入 Feign 已經(jīng)成功通過測試；
****************************************************************************************/
/****************************************************************************************
一、電影微服務(wù)接入 Feign 進行客戶端負載均衡，通過 FeignClient 調(diào)用遠程 Http 微服務(wù)（測試接入 Feign 模塊進行負載均衡）：
1、注解：EnableFeignClients
2、啟動 springms-discovery-eureka 模塊服務(wù)，啟動1個端口；
3、啟動 springms-provider-user 模塊服務(wù)，啟動3個端口（7900、7899、7898）；
4、啟動 springms-consumer-movie-feign 模塊服務(wù)；
5、在瀏覽器輸入地址http://localhost:7910/movie/1 連續(xù)刷新9次，正常情況可以看到 springms-provider-user 的3個端口輪詢打印用戶日志信息；
總結(jié)：1、說明接入 Feign 已經(jīng)成功的在客戶端進行了負載均衡處理；
2、之所以會在客戶端進行輪詢打印日志信息，是因為沒有配置調(diào)度算法，而默認的調(diào)度算法就是輪詢，所以會出現(xiàn)輪詢打印日志信息；
****************************************************************************************/
五、下載地址
https://gitee.com/ylimhhmily/SpringCloudTutorial.git
SpringCloudTutorial交流QQ群: 235322432
SpringCloudTutorial交流微信群: 微信溝通群二維碼圖片鏈接
歡迎關(guān)注，您的肯定是對我最大的支持!!!
