上一篇Spring Cloud构建微服务架构之服务消费（二）介绍了如何使用Ribbon来消费微服务提供的接口。本文我们将继续介绍Spring Cloud中的另外一个服务消费的工具：Spring Cloud Feign。
Spring Cloud Feign
Spring Cloud Feign是一套基于Netflix Feign实现的声明式服务调用客户端。它使得编写Web服务客户端变得更加简单。我们只需要通过创建接口并用注解来配置它既可完成对Web服务接口的绑定。它具备可插拔的注解支持，包括Feign注解、JAX-RS注解。它也支持可插拔的编码器和解码器。Spring Cloud Feign还扩展了对Spring MVC注解的支持，同时还整合了Ribbon和Eureka来提供均衡负载的HTTP客户端实现。微服务间调用使用Feign居多。
下面的代码将演示如何使用feign来消费微服务提供的接口
- 1 在Services工程下右键新建Module，名称为customer-service-feign，在pom.xml添加feign依赖：
<?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">
<parent>
<artifactId>services</artifactId>
<groupId>spring-cloud-demos</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>customer-service-feign</artifactId>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<version>1.5.7.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-feign</artifactId>
</dependency>
</dependencies>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<java.version>1.8</java.version>
</properties>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<executions>
<execution>
<goals>
<goal>repackage</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
- 创建主类FeignApplication并通过@EnableFeignClients注解开启扫描Spring Cloud Feign客户端的功能：
package com.snow.spring.cloud;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.netflix.feign.EnableFeignClients;
@EnableFeignClients
@EnableDiscoveryClient
@SpringBootApplication
public class FeignApplication {
public static void main(String[] args){
SpringApplication.run(FeignApplication.class,args);
}
}
- 3.创建一个Feign的客户端接口定义。
使用@FeignClient注解来指定这个接口所要调用的服务名称，接口中定义的各个函数使用Spring MVC的注解就可以来绑定服务提供方的REST接口，比如下面就是绑定biz-provider-service1服务的/getUserInfo接口的例子：
package com.snow.spring.cloud.service;
import org.springframework.cloud.netflix.feign.FeignClient;
import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.PostMapping;
@FeignClient("biz-provider-service1")
@Component
public interface SP1Client {
@PostMapping("/getUserInfo")
String getInfo(String userName);
}
- 4 创建消费服务Controller
在Controller中注入FeignClient接口实例，直接通过该实例调用声明的方法来实现微服务消费。通过Spring Cloud Feign来实现服务调用的方式更加简单了，通过@FeignClient定义的接口来统一的声明我们需要依赖的微服务接口。微服务之间的调用，感觉就像调用本地方法一样方便了。而在具体使用的时候就跟调用本地方法一点的进行调用即可。由于Feign是基于Ribbon实现的，所以它自带了客户端负载均衡功能，也可以通过Ribbon的IRule进行策略扩展。
package com.snow.spring.cloud.controller;
import com.snow.spring.cloud.service.SP1Client;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class CustomerController {
Logger logger = LoggerFactory.getLogger(CustomerController.class);
@Autowired
SP1Client sp1Client;
@GetMapping("/getUserInfo")
public String getUserInfo(@RequestParam String userName){
logger.info("get request:" + userName);
return sp1Client.getInfo(userName);
}
}
- 5 . 修改应用配置文件指定消费服务端口
spring:
application:
name: customer-serice-feign
server:
port: 9002
eureka:
instance:
prefer-ip-address: true
client:
serviceUrl:
defaultZone: http://localhost:8762/eureka/
services:
urls:
userInfoUrl: http://biz-provider-service1/
启动FeignApplication，然后再浏览器中访问：http://localhost:9002/getUserInfo?userName=snow
我们可以看到，请求到达CustomerController，并通过FeignClient声明的SP1Client接口来调用指定的微服务。刷新浏览器，通过日志我们发现请求也是均匀分发的，FeignClient集成了Ribbon负载均衡。
至此，FeignClient的方式消费微服务提供的接口演示完毕。
作者水平有限，说的不好的地方还请包含。
文章中所有的实例代码均可以在下面的连接上获取参考。谢谢。
码市：spring-cloud-demos
