Spring Cloud Learning | 第四篇：声明式服务调用（Fegin）

一. Feigin简介

      Feign是一个声明式的伪Http客户端，它使得写Http客户端变得更简单。使用Feign，只需要创建一个接口并用注解的方式来配置它，即可完成对服务提供方的接口绑定，简化了在使用Ribbon时自行封装服务调用客户端的开发量。

      Feign具有可插拔的注解特性，包括Feign 注解和JAX-RS注解，同时也扩展了对SpringMVC的注解支持。Feign支持可插拔的编码器和解码器，默认集成了Ribbon，并和Eureka结合，默认实现了负载均衡的效果。

二. 快速入门

2.1 启动之前的eureka-server工程，端口号为8761，启动eureka-client工程两次，端口号为8762和8763。

2.2 创建Feign服务

      首先新建一个Spring Boot基础工程，命名为service-feign，在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.dan</groupId>
	<artifactId>service-feign</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>service-feign</name>
	<description>Demo project for Spring Boot</description>

	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>1.5.9.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>Edgware.SR1</spring-cloud.version>
	</properties>

	<dependencies>
		<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>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</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>

      在工程的配置文件application.properties文件上配置指定服务注册中心、自身的服务名、端口号等：

spring.application.name=service-feign
eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka
server.port=8765

      在启动类上加上@EnableFeignClients注解开启Feign的支持功能：

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class ServiceFeignApplication {

  public static void main(String[] args) {
    SpringApplication.run(ServiceFeignApplication.class, args);
  }
}

      定义HelloService接口，通过@FeignClient注解指定服务名来绑定服务指定调用哪个服务，然后再使用Spring MVC的注解来绑定具体该服务提供的REST接口：

@FeignClient("hello-service")
public interface HelloService {

	@GetMapping("/hello")
	String hello(@RequestParam(value = "name") String name);
	
}

      接着，创建一个controller来实现对Feign客户端的调用

@RestController
public class HelloController {

  @Autowired
  HelloService helloService;
 
  @GetMapping(value = "/hello")
  public String sayHi(@RequestParam(value = "name") String name){
   return helloService.sayHello(name);
  }
}

      启动工程，Eureka Server的信息面板：

      多次访问localhost:8765/hello?name=Jack 交替看到：

Hello Jack. I am from port:8762
Hello Jack. I am from port:8763

 

源码下载：https://github.com/lingd3/SpringCloudLearning/tree/master/chapter4