5. Spring Cloud声明式服务调用，Feign（Finchley版本）

• 项目地址完整例子传送门
• 项目中用到模块:
  
• 模块介绍：
  1. eureka-server-peer-awareness 提供注册中心的服务
  2. ribbon-client 启动多实例，并注册到注册中心，提供接口服务
  3. feign-consumer 注册到注册中心，扮演服务消费者的角色，集成了Ribbon负载均衡和Feign声明式服务调用客户端
• 官方文档
  1.Feign介绍
  2.spring-cloud/OpenFeign官方项目

1.Feign介绍

• Spring Cloud Feign是一套基于Netflix Feign实现的声明式服务调用客户端。它使得编写Web服务客户端变得更加简单。我们只需要通过创建接口并用注解来配置它既可完成对Web服务接口的绑定。它具备可插拔的注解支持，包括Feign注解、JAX-RS注解。它也支持可插拔的编码器和解码器。Spring Cloud Feign还扩展了对Spring MVC注解的支持，同时还整合了Ribbon和Eureka来提供均衡负载的HTTP客户端实现。

2.启动注册中心和接口服务提供实例

注册中心：eureka-server-peer-awareness
提供接口服务实例：ribbon-client
如果对这两个项目不是很了解，见：Spring Cloud负载均衡，Ribbon（Finchley版本）

3.创建feign-consumer服务消费者

• pom.xml文件中，创建feign服务消费者，引入spring-cloud-starter-openfeign依赖其中包含了ribbon的依赖，所以不用重复引入spring-cloud-starter-netflix-ribbon

<?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.friends</groupId>
    <artifactId>feign-consumer</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>feign-consumer</name>
    <description>Demo project for Spring Cloud</description>
    <parent>
        <groupId>org.friends</groupId>
        <artifactId>centralpark</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-openfeign</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
</project>

• 启动类中FeignConsumerApplication.java，添加注解@EnableFeignClients，声明feign服务

@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class FeignConsumerApplication {
    public static void main(String[] args) {
        SpringApplication.run(FeignConsumerApplication.class, args);
    }
}

• 添加对外服务的Controller类FeignConsumerController .java

@RestController
public class FeignConsumerController {
    @Autowired
    private FeignConsumerService feignConsumerService;

    @GetMapping("feignClient")
    public  String ribbonClient(){
        return  feignConsumerService.feignClient();

    }
}

• 添加Feign的服务调用FeignConsumerService.java接口，注解@FeignClient标定需要调用的微服务名称，使用SpringMVC式注解@GetMapping等进行调用和参数绑定

@FeignClient("RibbonClient")
public interface FeignConsumerService {
    @GetMapping("ribbonClient")
    String feignClient();
}

• 配置文件中application.yml中,配置注册中心

spring:
  application:
    name: FeignConsumer

eureka:
  client:
    serviceUrl:
      defaultZone: http://peer1:8887/eureka/,http://peer2:8888/eureka/,http://peer3:8889/eureka/
server:
  port: 8001

• 启动消费者服务，访问注册中心面板http:peer1/8887 如下图，可见3个注册中心实例，2个接口提供者实例ribbon-client，1个服务消费者实例feign-consumer
  
• 调用服务消费者接口实例
  访问 http://localhost:8001/feignClient接口，下面字符串交替出现，说明调用成功并且Ribbon负载也在起作用
  1. I’m ribbonClient: port is 8601
  2. I’m ribbonClient: port is 8602

上一篇：Spring Cloud负载均衡，Ribbon（Finchley版本）
下一篇：Spring Cloud 分布式配置中心入门 ，Spring Cloud Config（Finchley版本）