05 服务消费者（Feign）

本博客记录程序员DD的spring cloud Dalston版教程学习笔记
Spring Cloud Feign
Spring Cloud Feign是一套基于Netflix Feign实现的声明式服务调用客户端。它使得编写Web服务客户端变得更加简单。我们只需要通过创建接口并用注解来配置它既可完成对Web服务接口的绑定。它具备可插拔的注解支持，包括Feign注解、JAX-RS注解。它也支持可插拔的编码器和解码器。Spring Cloud Feign还扩展了对Spring MVC注解的支持，同时还整合了Ribbon和Eureka来提供均衡负载的HTTP客户端实现。
1.创建eureka-consumer-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>
    <parent>
        <groupId>com.star</groupId>
        <artifactId>springcloudlearn</artifactId>
        <version>0.0.1-SNAPSHOT</version>
    </parent>
    <groupId>com.star</groupId>
    <artifactId>eureka-consumer-feign</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>eureka-consumer-feign</name>
    <description>服务消费者feign</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

    <dependencies>
        <!--基础jar-->
        <dependency>
            <groupId>com.star</groupId>
            <artifactId>eureka-common</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <!--eureka依赖jar包-->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-eureka-server</artifactId>
        </dependency>
        <!--spring boot监控-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        <!-- feign -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-feign</artifactId>
        </dependency>

    </dependencies>

    <!--spring-cloud依赖-->
    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-dependencies</artifactId>
                <version>Dalston.SR1</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>

2.application.properties配置文件修改

#指定注册到eureka server上的服务名称
spring.application.name=eureka-consumer-feign
#端口
server.port=8004
#指定eureka server通信地址
eureka.client.serviceUrl.defaultZone=http://localhost:8000/eureka/
# 是否注册IP到eureka server，如不指定或设为false，那就会注册主机名到eureka server
eureka.client.instance.prefer-ip-address=true
eureka.instance.instance-id=${spring.application.name}:${random.int}

3.修改应用主类。通过@EnableFeignClients注解开启扫描Spring Cloud Feign客户端的功能

/**    
* <p>Description: 启动eureka-consumer服务 </p>
* <p>version 1.0.0 </p>
 * <p>通过@EnableDiscoveryClient注解激活Eureka中的DiscoveryClient实现，这样才能实现Controller中对服务信息的输出
 * 通过@EnableFeignClients注解开启扫描Spring Cloud Feign客户端的功能</p>
* @author likai
* @date 2019/8/28 18:08   
*/
@SpringBootApplication
@EnableDiscoveryClient
@EnableFeignClients
public class EurekaConsumerFeignApplication {

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

}

4.创建一个Feign的客户端接口定义。使用@FeignClient注解来指定这个接口所要调用的服务名称，接口中定义的各个函数使用Spring MVC的注解就可以来绑定服务提供方的REST接口

/**
 * <p>version 1.0.0 </p>
 * <p>通过@FeignClient定义的接口来统一的声明我们需要依赖的微服务接口</p>
 * @author likai
 * @Date 2019/8/29 10:16
 * @Description
 */
@FeignClient("eureka-client")
public interface DemoClient {

    /**    
    * <p>Description: </p>
    * <p>version 1.0.0 </p>
     * <p>@GetMapping("/demo")指向client的接口地址</p>
    * @param
    * @return   
    * @author likai
    * @date 2019/8/29 10:18   
    */
    @GetMapping("/demo")
    String getDemo();
}

5.通过定义的feign客户端来调用服务提供方的接口

/**
 * <p>version 1.0.0 </p>
 *
 * @author likai
 * @Date 2019/8/28 19:20
 * @Description DemoController用于接口调用
 */
@RestController
public class DemoController {

    @Autowired
    DemoClient demoClient;

    /**
    * <p>Description:调用服务提供者的接口 </p>
    * <p>version 1.0.0 </p>
    * @param
    * @return   
    * @author likai
    * @date 2019/8/28 19:37   
    */
    @GetMapping("/demo")
    public String demo(){
        return demoClient.getDemo();
    }
}

6.启动项目
观察eureka-server服务治理中心后台，eureka-consumer-feign注册成功


7.访问localhost:8004/demo

可以看到获取到了client接口返回的数据

工程说明：

1. eureka的服务注册中心：eureka-server
2. eureka的服务提供方：eureka-client
3. eureka的服务消费者feign：eureka-consumer-feign