Spring Cloud服务治理-Eureka/服务消费者 Feign

上篇讲了如何使用Ribbon+RestTemplate服务消费者，现在来谈下如何通过Feign去消费服务。

Feign是一个声明式的伪Http客户端，它使得写Http客户端变得更简单。

使用Feign，只需要创建一个接口并注解，它具有可插拔的注解特性，可使用Feign 注解和JAX-RS注解，Feign支持可插拔的编码器和解码器，Feign默认集成了Ribbon，并和Eureka结合，默认实现了负载均衡的效果。

Feign 具有如下特性：

• 可插拔的注解支持，包括Feign注解和JAX-RS注解
• 支持可插拔的HTTP编码器和解码器
• 支持Hystrix和它的Fallback
• 支持Ribbon的负载均衡
• 支持HTTP请求和响应的压缩Feign是一个声明式的Web Service客户端，它的目的就是让Web Service调用更加简单。它整合了Ribbon和Hystrix，从而不再需要显式地使用这两个组件。Feign还提供了HTTP请求的模板，通过编写简单的接口和注解，就可以定义好HTTP请求的参数、格式、地址等信息。接下来，Feign会完全代理HTTP的请求，我们只需要像调用方法一样调用它就可以完成服务请求。

简而言之：Feign能干Ribbon和Hystrix的事情，但是要用Ribbon和Hystrix自带的注解必须要引入相应的jar包才可以。

---

简单搭建步骤如下：

1.修改spring-cloud-eureka-provider-a，spring-cloud-eureka-provider-b，spring-cloud-eureka-provider-c服务名统一为eureka-provider，注意：1、2步骤是为了模拟负载均衡部署多节点

2.修改三个服务提供者的请求统一为"/"

3.新建spring-cloud-feign-consumer项目，pom必须引入spring-cloud-starter-openfeign依赖

<?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.example</groupId>
	<artifactId>spring-cloud-feign-consumer</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>spring-cloud-feign-consumer</name>
	<description>Demo project for Spring Boot</description>

	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>2.0.3.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>Finchley.RELEASE</spring-cloud.version>
	</properties>

	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-actuator</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-netflix-eureka-client</artifactId>
		</dependency>
		<dependency>
			<groupId>org.springframework.cloud</groupId>
			<artifactId>spring-cloud-starter-openfeign</artifactId>
		</dependency>

		<dependency>
			<groupId>org.projectlombok</groupId>
			<artifactId>lombok</artifactId>
			<optional>true</optional>
		</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>

4.在工程的启动类中使用@EnableFeignClients开启Feign服务

package com.example.eureka.feign.consumer;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;

/**
 * @EnableFeignClients:开启Feign的功能
 *
 * @author fangxc
 * @data 2018年7月31日 上午9:19:37
 * @version 1.0.0
 *
 */
@EnableFeignClients
@EnableDiscoveryClient
@SpringBootApplication
public class SpringCloudFeignConsumerApplication {

	public static void main(String[] args) {
		SpringApplication.run(SpringCloudFeignConsumerApplication.class, args);
		System.out.println("feign-consumer service has started!");
	}
}

5.定义调用服务的接口，通过@FeignClient（"服务名"），来指定调用哪个服务。

比如在代码中调用了eureka-provider服务的 "/" 接口，"/" 就是调用服务提供者项目：spring-cloud-eureka-provider-a的 serverA() 方法，spring-cloud-eureka-provider-b的 serverB() 方法，spring-cloud-eureka-provider-c的 serverC() 方法，代码如下：

package com.example.eureka.feign.consumer;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

/**
  *  指定这个接口所要调用的 提供者服务名称 "eureka-provider"
 * @author fangxc
 *
 */
@FeignClient("eureka-provider")
public interface HomeClient {

	@GetMapping("/")
    String consumer();
	
}

6.消费方法

package com.example.eureka.feign.consumer;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ConsumerController {

	@Autowired
    private HomeClient homeClient;
	
    @GetMapping(value = "/hello")
    public String hello() {
        return  homeClient.consumer();
    }
    
}

7.添加配置

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

8.依次开启spring-cloud-eureka-service，spring-cloud-eureka-provider-a，spring-cloud-eureka-provider-b，spring-cloud-eureka-provider-c，spring-cloud-feign-consumer

9.浏览器输入http://localhost:9000/hello，返回结果在spring-cloud-eureka-provider-a:10001，spring-cloud-eureka-provider-b:10002，spring-cloud-eureka-provider-c:10003之中选择，说明每次请求会按照feign规则进行分发给三个同服务名应用达到负载均衡功能