08 在Spring Cloud中使用Feign
Spring Cloud对Feign进行了封装，本例将演示如何在Spring Cloud中使用Feign。
1.准备SpringCloud的测试项目
测试项目主要有三个，
a.spring-feign-server: Eureka的服务器项目，端口为8761；
b.spring-feign-provider: 服务提供者，该项目通过在控制台输入对应的端口号启动两个实例，分别是8080和8081端口的实例，这两个实例提供如下服务
第一个地址为person/{personId}的服务，请求后返回Person实例，Person的message属性请求的是URL。
c.spring-feign-invoker: 服务调用者，该项目对外端口是9000，本例主要是在该项目下使用Feign。
由于Eureka服务器项目以及服务提供者项目不是本文的重点，此处不做详细介绍，详情可参考前面的博文。本文将重点介绍服务调用者项目，项目的目录结构如下
2.Spring Cloud中整合Feign
在服务调用者（spring-feign-invoker）的pom.xml文件中引入相关依赖，代码清单如下
pom.xml
<?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> <groupId>com.triheart</groupId> <artifactId>springfeigninvoker</artifactId> <version>1.0-SNAPSHOT</version> <dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-dependencies</artifactId> <version>Dalston.SR1</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-config</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-eureka</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-ribbon</artifactId> </dependency> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-feign</artifactId> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.16.18</version> </dependency> </dependencies> </project>
在服务调用者启动类中打开Feign开关，代码清单如下
InvokerApp.java
package com.triheart.firstekserviceinvoker; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.boot.builder.SpringApplicationBuilder; import org.springframework.cloud.client.discovery.EnableDiscoveryClient; import org.springframework.cloud.netflix.feign.EnableFeignClients; /** * @author 阿遠 * Date: 2018/8/23 * Time: 17:51 */ @SpringBootApplication @EnableDiscoveryClient @EnableFeignClients public class InvokerApp { public static void main(String[] args) { new SpringApplicationBuilder(InvokerApp.class).run(args); } }
接下来，编写客户端接口，与单独直接使用Feign类似，代码清单如下
PersonClient.java
package com.triheart.firstekserviceinvoker; import org.springframework.cloud.netflix.feign.FeignClient; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; /** * @author 阿遠 * Date: 2018/8/29 * Time: 9:46 */ @FeignClient("spring-feign-provider") //调用服务提供者的服务名称 public interface PersonClient { @RequestMapping(method = RequestMethod.GET, value = "/hello") String hello(); }
与单独使用Feign不同的是，接口使用了@FeignClient注解来修饰，并且声明了需要调用的服务名称。另外接口方法使用了@RequestMapping来修饰，这是因为Feign的“翻译器”的功能可以让Feign知道第三方注解的含义，Spring Cloud也提供翻译器，将@RequestMapping注解的含义告知Feign,因此我们的服务接口就可以直接使用该注解。除了该注解外，默认还支持@RequestParam、@RequestHeader、@PathVariable这三个参数注解。需要注意的是，使用Spring Cloud的“翻译器”后，将不能再使用Feign的默认注解。接下来，在控制器中调用接口方法，代码清单如下
package com.triheart.firstekserviceinvoker; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Configuration; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RestController; /** * @author 阿遠 * Date: 2018/8/23 * Time: 17:56 */ @RestController @Configuration public class InvokerController { @Autowired private PersonClient personClient; @RequestMapping(value = "/invokeHello", method = RequestMethod.GET) public String invokeHello() { return personClient.hello(); } }
在控制器在中，注入了PersonClient的Bean，不难看出，客户端实例的创建及维护，Spring容器都帮我们实现了。
启动Eureka服务器。
启动两个服务提供者，分别在8080和8081端口启动。
启动服务调用者，端口为9000。
在浏览器中输入http://localhost:9000/invokeHello，我们可以看到，服务提供者的/hello服务已经被调用。
3.Feign负载均衡
我们知道，如果结合Ribbon的使用，Spring Cloud的客户端就会拥有负载均衡的功能，因此，Spring Cloud实现的Feign客户端也拥有负载均衡的功能。下面我们测试其负载均衡功能
在PersonClient .java接口中添加如下代码
@RequestMapping(method = RequestMethod.GET, value = "/person/{personId}")
Person getPerson(@PathVariable("personId") Integer personId);
在InvokerController.java中添加如下代码
@RequestMapping(value = "/router", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_VALUE) public String router() { // 调用服务提供者的接口 Person p = personClient.getPerson(2); return p.getMessage();
重新启动服务调用者，在浏览器中输入http://localhost:9000/router,刷新，可以看到8080与8081端口被循环调用。
