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