Spring Cloud 进阶之路 -- Feign 的使用(*)

Feign 是一个声明式的伪RPC的REST客户端，它使用了基于接口的注解方式，很方便的客户端配置，Spring Cloud 给 Feign 添加了支持Spring MVC注解，并整合Ribbon及Eureka进行支持负载均衡。

Feign的使用很简单，有以下几步：
1、添加依赖
2、启动类添加 @EnableFeignClients 注解支持
3、建立Client接口，并在接口中定义需调用的服务方法
4、使用Client接口。

具体如下：
1、添加 spring-cloud-starter-openfeign 依赖

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

完整的 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.antma</groupId>
    <artifactId>eureka-call-client</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>
 
    <name>eureka-call-client</name>
    <description>Demo project for Spring Boot</description>
 
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.0.2.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-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>
        </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>

2、启动类添加 @EnableFeignClients 注解支持

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

3、建立Client接口，并在接口中定义需要调用的服务方法

package com.antma.eurekacallclient.client;
 
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
 
@FeignClient(name = "CLIENT")
public interface TestClient {
 
    @GetMapping("/getMsg")
    public String getMsg();
 
}

说明：name=“CLIENT”，这里的"CLIENT"是注册到Eureka 中的要调用的应用名
@GetMapping(“/getMsg”) 这里的“getMsg”是要调用的应用里的相应的方法（这里需要注意，如果CLIENT服务下面的访问路径是 /list/getMsg ，则这里也要写"/list/getMsg"）。

4、使用Client接口

package com.antma.eurekacallclient.controller;
 
import com.antma.eurekacallclient.client.TestClient;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
 
@RestController
@Slf4j
public class ClientController {
 
    @Autowired
    private TestClient testClient;
 
    @GetMapping("getServerMsg")
    public String getServerMsg() {
        String result = testClient.getMsg();
        log.info("result={}", result);
 
        return result;
    }
}

使用上面定义的 TestClient 接口，直接调用其方法即可，附两张图：

Eureka中注册的两个服务，CLIENT 为要调用的应用，CALL-CLIENT为调用者

下面是浏览器访问后的结果：

注意：
模块feign-api当中XxxClient所在的包名通常与服务消费者的@EnableFeignClients注解所在的包名（启动类所在的包）不一致，因此无法扫描到UserClient。
有两种方式解决：

方式一：指定Feign应该扫描的包（UserClient所在的包）

@EnableFeignClients(basePackages = "cn.itcast.feign.clients")

方式二：指定需要加载的Client接口（直接指定Class）

@EnableFeignClients(clients = {UserClient.class})