0°

Spring Cloud构建微服务架构:服务消费(Feign)【Dalston版】

Spring Cloud Feign

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

下面,我们通过一个例子来展现Feign如何方便的声明对eureka-client服务的定义和调用。

动手试一试

下面的例子,我们将利用之前构建的eureka-server作为服务注册中心、eureka-client作为服务提供者作为基础。而基于Spring Cloud Ribbon实现的消费者,我们可以根据eureka-consumer(服务消费者)实现的内容进行简单改进就能完成,具体步骤如下:

  • 根据eureka-consumer复制一个服务消费者工程,命名为:eureka-consumer-feign。在pom.xml中增加下面的依赖:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
1<?xml version="1.0" encoding="UTF-8"?>
2<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
4    <modelVersion>4.0.0</modelVersion>
5    <parent>
6        <groupId>org.springframework.boot</groupId>
7        <artifactId>spring-boot-starter-parent</artifactId>
8        <version>1.5.21.RELEASE</version>
9        <relativePath/> <!-- lookup parent from repository -->
10    </parent>
11    <groupId>com.liu</groupId>
12    <artifactId>eureka-consumer-feign</artifactId>
13    <version>0.0.1-SNAPSHOT</version>
14    <name>eureka-consumer-feign</name>
15    <description>Demo project for Spring Boot</description>
16
17    <properties>
18        <java.version>1.8</java.version>
19    </properties>
20
21    <dependencyManagement>
22        <dependencies>
23            <dependency>
24                <groupId>org.springframework.cloud</groupId>
25                <artifactId>spring-cloud-dependencies</artifactId>
26                <version>Dalston.SR1</version>
27                <type>pom</type>
28                <scope>import</scope>
29            </dependency>
30        </dependencies>
31    </dependencyManagement>
32
33    <dependencies>
34        <dependency>
35            <groupId>org.springframework.boot</groupId>
36            <artifactId>spring-boot-starter</artifactId>
37        </dependency>
38
39        <dependency>
40            <groupId>org.springframework.cloud</groupId>
41            <artifactId>spring-cloud-starter-feign</artifactId>
42        </dependency>
43
44        <dependency>
45            <groupId>org.springframework.boot</groupId>
46            <artifactId>spring-boot-starter-test</artifactId>
47            <scope>test</scope>
48        </dependency>
49
50        <dependency>
51            <groupId>org.springframework.cloud</groupId>
52            <artifactId>spring-cloud-starter-eureka</artifactId>
53        </dependency>
54        <dependency>
55            <groupId>org.springframework.boot</groupId>
56            <artifactId>spring-boot-starter-web</artifactId>
57        </dependency>
58        <dependency>
59            <groupId>org.springframework.boot</groupId>
60            <artifactId>spring-boot-starter-actuator</artifactId>
61        </dependency>
62    </dependencies>
63
64    <build>
65        <plugins>
66            <plugin>
67                <groupId>org.springframework.boot</groupId>
68                <artifactId>spring-boot-maven-plugin</artifactId>
69            </plugin>
70        </plugins>
71    </build>
72
73</project>
74
75
76
  • 修改应用主类。通过@EnableFeignClients注解开启扫描Spring Cloud Feign客户端的功能:


1
2
3
4
5
6
7
8
9
10
11
12
1@EnableFeignClients
2@EnableDiscoveryClient
3@SpringBootApplication
4public class EurekaConsumerFeignApplication {
5
6    public static void main(String[] args) {
7        SpringApplication.run(EurekaConsumerFeignApplication.class, args);
8    }
9
10}
11
12
  • 创建一个Feign的客户端接口定义。使用@FeignClient注解来指定这个接口所要调用的服务名称,接口中定义的各个函数使用Spring MVC的注解就可以来绑定服务提供方的REST接口,比如下面就是绑定eureka-client服务的/dc接口的例子 我们只需要使用consumer1()就可以访问到服务名为eureka-client,接口方法名为dc的方法:


1
2
3
4
5
6
7
8
9
1@FeignClient("eureka-client")
2public interface DcClient {
3
4    @GetMapping("/dc")
5    String consumer1();
6
7}
8
9
  • 修改Controller。通过定义的feign客户端来调用服务提供方的接口:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
1@RestController
2public class DcController {
3
4    @Autowired
5    DcClient dcClient;
6
7    @GetMapping("/consumer")
8    public String dc() {
9        return dcClient.consumer1();  //通过dcClient.consumer1()找到DcClient inteface里的
10                                                   //  @GetMapping("/dc")
11                                                    //   String consumer1();
12                                                   //从而知道要访问的服务名+服务接口
13    }
14
15}
16
17

通过Spring Cloud Feign来实现服务调用的方式更加简单了,通过@FeignClient定义的接口来统一的声明我们需要依赖的微服务接口。而在具体使用的时候就跟调用本地方法一点的进行调用即可。由于Feign是基于Ribbon实现的,所以它自带了客户端负载均衡功能,也可以通过Ribbon的IRule进行策略扩展。另外,Feign还整合的Hystrix来实现服务的容错保护,在Dalston版本中,Feign的Hystrix默认是关闭的。待后文介绍Hystrix带领大家入门之后,我们再结合介绍Feign中的Hystrix以及配置方式。

在完成了上面你的代码编写之后,读者可以将eureka-server、eureka-client、eureka-consumer-feign都启动起来,然后访问http://localhost:2101/consumer ,来跟踪观察eureka-consumer-feign服务是如何消费eureka-client服务的/dc接口的,并且也可以通过启动多个eureka-client服务来观察其负载均衡的效果。

「点点赞赏,手留余香」

    还没有人赞赏,快来当第一个赞赏的人吧!