Spring Cloud学习系列第二章：使用Feign调用服务

一、Feign简介

  Feign是一个声明式的Web服务客户端。这使得Web服务客户端的写入更加方便 要使用Feign创建一个界面并对其进行注释。它具有可插入注释支持，包括Feign注释和JAX-RS注释。Feign还支持可插拔编码器和解码器。Spring Cloud增加了对Spring MVC注释的支持，并使用Spring Web中默认使用的HttpMessageConverters。Spring Cloud集成Ribbon和Eureka以在使用Feign时提供负载均衡的http客户端。

  上面这段话是官方文档，说的有些啰嗦，简单来说，就是Feign帮我们准备了一套调用Spring Cloud注册服务中心里面的服务，不用再去使用Apache httpclient之类的http客户端工具了，还提供了很多功能，编解码、负载均衡等。

二、创建Feign项目

我们的目的是使用上一章发布的服务，而且是到Eureka Server中去访问服务，所以我们的Feign项目就是比Eureka Server项目多一个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"><modelVersion>4.0.0</modelVersion><groupId>com.nan</groupId><artifactId>feigndemo</artifactId><version>0.0.1-SNAPSHOT</version><packaging>jar</packaging><name>feigndemo</name><description>Demo project for Spring Boot</description><parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><version>1.5.6.RELEASE</version><relativePath/> <!-- lookup parent from repository --></parent><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><java.version>1.8</java.version><spring-cloud.version>Dalston.SR2</spring-cloud.version></properties><dependencies><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-feign</artifactId></dependency><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-eureka</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-test</artifactId><scope>test</scope></dependency></dependencies><dependencyManagement><dependencies><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-dependencies</artifactId><version>${spring-cloud.version}</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build></project>

  项目启动入口要激活Feign client，内容如下。

package com.nan.feigndemo;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;@SpringBootApplication@EnableEurekaClient@EnableFeignClientspublic class FeigndemoApplication {    public static void main(String[] args) {        SpringApplication.run(FeigndemoApplication.class, args);    }}

  接下来就要声明Feign客户端了，目的就是指向我们发布的服务，首先看内容。

package com.nan.feigndemo.client;import org.springframework.cloud.netflix.feign.FeignClient;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestParam;@FeignClient("HelloService")public interface HelloServiceClient {    @RequestMapping("/hello")    String hello(@RequestParam("name") String name);}

  很明显，这是一个interface，是一个声明式使用方式。重要的注解，FeignClient，"HelloService"属性就是我们发布的服务的spring.application.name。下面的接口方法就和我们发布的Rest接口一致了，另外RequestMapping不要用在interface上，不然会被spring mvc容器扫描到。

  然后编写我们自己的项目业务，调用这个客户端，内容如下。

package com.nan.feigndemo.controller;import com.nan.feigndemo.client.HelloServiceClient;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.RequestMapping;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.bind.annotation.RestController;@RestControllerpublic class FeignDemoController {    @Autowired    private HelloServiceClient helloServiceClient;    @RequestMapping("/feigndemo")    public String feignDemo(@RequestParam("name") String name) {        return helloServiceClient.hello(name);    }}

  简单的controller，就不多废话了。重要的是下面的项目配置。

server:  port: 8080spring:  application:    name: FeignDemoeureka:  client:    serviceUrl:      defaultZone: http://node01:8081/eureka/,http://node02:8082/eureka/

 server.port和application.name是我们项目自己的，eureka.client.serviceUrl就是我们的Eureka Server集群模式的地址，然后启动项目，记得Eureka server和HelloService也要启动。然后浏览器访问我们的feigndemo项目，浏览器输入http://localhost:8080/feigndemo?name=秦始皇，浏览器会出现 Hello 秦始皇, this client port is 9091，再刷新页面，会出现 Hello 秦始皇, this client port is 9092。OK，服务调用，负载均衡都已实现，真是太佩服他们了，一步一步简化我们的开发。

  以上就是笔者目前所学，还是很初级的内容，如果有什么错误和遗漏，还请见谅并指正，不胜感激。