Spring Cloud微服务系列文，服务调用框架Feign 架构师入门：搭建基本的Eureka架构（从项目里抽取）

时间 2019-12-06

标签 spring cloud 微服系列服务调用框架 feign 架构师入门搭建基本 eureka 架构项目抽取栏目 Spring 繁體版

原文原文链接

以前博文的案例中，咱们是经过RestTemplate来调用服务，而Feign框架则在此基础上作了一层封装，好比，能够经过注解等方式来绑定参数，或者以声明的方式来指定请求返回类型是JSON。这种“再次封装”能给咱们带来的便利有两点，第一，开发者无需像使用RestTemplate那样过多地关注HTTP调用细节，第二，在大多数场景里，某种类型的调用请求会被在多个地方被屡次使用，经过Feign能方便地实现这类“重用”。html

1 经过案例快速上手Feign

在FeignDemo-Server项目里，搭建基于Eureka的服务器，该项目的端口号是8888，主机名是localhost，启动后，能经过http://localhost:8888/eureka/查看注册到Eureka服务器中的诸多服务提供者或调用者的信息。java

在FeignDemo-ServiceProvider项目的控制器类里，咱们提供了一个sayHello方法，本项目提供服务的端口号是1111，对外提供的application name（服务名）是sayHelloServiceProvider，是向FeignDemo-Server服务器（也是Eureka服务器）的http://localhost:8888/eureka/注册服务。而提供sayHello的方法以下所示，从中，咱们能看到对应的RequestMapping值。web

1 @RequestMapping(value = "/hello/{username}", method = RequestMethod.GET )spring

2 public String sayHello(@PathVariable("username") String username){浏览器

3 return "hello " + username;缓存

4 }服务器

上述Eureka服务器和客户端的代码，是复用架构师入门：搭建基本的Eureka架构（从项目里抽取）这篇文章里的代码。网络

这里咱们将在FeignDemo-ServiceCaller项目里，演示经过Feign调用服务的方式。架构

第一步，在pom.xml里，引入Eureka、Ribbon和Feign的相关包，关键代码以下。其中，是经过第1行到第9行的代码引入Eureka包，经过第10行到第13行的代码引入Ribbon包，经过第14行到第17行的代码引入Feign包。 app

1    <dependency>
2        <groupId>org.springframework.boot</groupId>
3        <artifactId>spring-boot-starter-web</artifactId>
4        <version>1.5.4.RELEASE</version>
5    </dependency>   
6        <dependency>
7            <groupId>org.springframework.cloud</groupId>
8            <artifactId>spring-cloud-starter-eureka</artifactId>
9        </dependency>
10     <dependency>
11           <groupId>org.springframework.cloud</groupId> 
12           <artifactId>spring-cloud-starter-ribbon</artifactId> 
13    </dependency>  
14     <dependency>
15            <groupId>org.springframework.cloud</groupId>
16            <artifactId>spring-cloud-starter-feign</artifactId>
17    </dependency>

第二步，在application.yml里，经过第3行的代码，定义本项目的名字叫callHelloByFeign，经过第5行的代码，指定本项目是工做在8080端口。同时经过第9行的代码，指定本项目是向http://localhost:8888/eureka/ （也就是FeignDemo-Server）这个Eureka服务器注册。

1    spring:
2      application:
3        name: callHelloByFeign
4    server:
5      port: 8080
6    eureka: 
7      client:
8        serviceUrl:
9          defaultZone: http://localhost:8888/eureka/

第三步，在启动类里，经过第1行的代码，添加支持Feign的注释，关键代码以下。这样，在启动这个Eureka客户端时，就能够引入Feign支持。

1    @EnableFeignClients
2    @EnableDiscoveryClient
3    @SpringBootApplication
4    public class ServiceCallerApp 
5    {
6        public static void main( String[] args )
7        {      SpringApplication.run(ServiceCallerApp.class, args);  }
8    }

第四步，经过Feign封装客户端调用的细节，外部模块是经过Feign来调用客户端的，这部分的代码是在Controller.java里。

1    省略必要的package和import的代码
2    //经过注解指定待调用的服务名
3    @FeignClient("sayHelloServiceProvider")
4    //在这个接口里，经过Feign封装客户端的调用细节 
5    interface FeignClientTool
6    {
7            @RequestMapping(method = RequestMethod.GET, value =   "/hello/{name}")
8          String sayHelloInClient(@PathVariable("name") String name);
9    }
10    //Controller是控制器类
11    @RestController
12    public class Controller {        
13          @Autowired
14         private FeignClientTool tool;    
15    //在callHello方法是，是经过Feign来调用服务
16        @RequestMapping(value = "/callHello", method = RequestMethod.GET)
17          public String callHello(){ 
18            return tool.sayHelloInClient("Peter");
19        }        
20    }

在Controller.java这个文件，其实定义了一个接口和一个类。在第5行的FeignClientTool接口里，咱们封装了Feign的调用业务，具体来讲，是经过第3行的FeignClient注解，指定了该接口会调用“sayHelloServiceProvider“服务提供者的服务，而经过第8行的，则指定了调用该服务提供者中sayHelloInClient的方法。

而在第12行的Controller类里，先是在第14行里，经过Autowired注解，引入了FeignClientTool类型的tool类，随后在第17行的callHello方法里，是经过tool类的sayHelloInClient方法，调用了服务提供者的相关方法。

也就是说，在callHello方法里，咱们并无再经过RestTemplate，以输入地址和服务名的方式调用服务，而是经过封装在FeignClientTool（Feign接口）里的方法调用服务。

完成上述代码后，咱们能够经过以下的步骤查看运行效果。

第一步，启动FeignDemo-Server项目，随后输入http://localhost:8888/，能看到注册到Eureka服务器里的诸多服务。

第二步，启动FeignDemo-ServiceProvider项目，随后输入http://localhost:1111/hello/Peter，能调用其中的服务，此时，能在浏览里看到“hello Peter”的输出。

第三步，启动FeignDemo-ServiceCaller项目，随后输入http://localhost:8080/callHello，一样能在浏览里看到“hello Peter”的输出。请注意，这里的调用是经过Feign完成的。

2 经过比较其它调用方式，了解Feign的封装性

在以前的代码里，咱们是经过以下形式，经过RestTemplate对象来调用服务。

1 RestTemplate template = getRestTemplate();

2 String retVal = template.getForEntity("http://sayHello/hello/Eureka", String.class).getBody();

在第2行的调用中，咱们须要指定url以及返回类型等信息。

以前咱们还见过基于RestClient对象的调用方式，关键代码以下。

1 RestClient client = (RestClient)ClientFactory.getNamedClient("RibbonDemo");

2 HttpRequest request = HttpRequest.newBuilder().uri(new URI("/hello")).build();

3 HttpResponse response = client.executeWithLoadBalancer(request);

其中是在第1行指定发起调用的RestClient类型的对象，在第2行里指定待调用的目标地址，随后在第3行发起调用。

这两种调用方式有着以下的共同点:调用时，须要详细地知道各类调用参数，好比服务提供者的url，若是有须要经过Ribbon实现负载均衡等机制，也须要在调用时一并指定。

但事实上，这些调用方式的底层细节，应该向服务使用者屏蔽，好比在调用时，无需关注目标url等信息。这就比如某位老板要秘书去订飞机票，做为服务使用者的老板只应当关心调用的结果，好比买到的飞机票是几点开的，该去哪一个航站楼登机，至于调用服务的底层细节，好比该到哪一个订票网站去买，服务使用者无需知道。

说得更专业些，这叫“解耦合”，即下降服务调动者和服务提供者之间的耦合度，这样的好处是，一旦服务提供者改变了实现细节（没改变服务调用接口），那么服务调用者部分的代码无需改动。

咱们再来回顾下经过Feign调用服务的方式。

1 private FeignClientTool tool; //定义Feign类

2 tool.sayHelloInClient("Peter"); //直接调用

第2行是调用服务，但其中，咱们看不到任何服务提供者的细节，由于这些都在第1行引用的FeignClientTool类里封装掉了。也就是说，经过基于Feign的调用方式，开发者能真正地作到“面向业务”，而无需过多地关注发起调用的细节。

3 经过注解输出调用日志

在开发和调试阶段，咱们但愿能看到日志，从而能定位和排查问题。这里，咱们将讲述在Feign里输出日志的方法，以便让你们能在经过Feign调用服务时，看到具体的服务信息。

这里咱们将改写FeignDemo-ServiceCaller项目。

改动点1：在application.yml文件里，增长以下的代码，以开启Feign客户端的DEBUG日志模式，请注意，这里须要指定完成的路径，就像第3行那样。

1 logging:

2 level:

3 com.controller.FeignClientTool: DEBUG

改动点2：在这个项目的启动类ServiceCallerApp.java里，增长定义日志级别的代码，在第7行的feignLoggerLevel方法里，咱们经过第8行的代码，指定了Feign日志级别是FULL。

1    //省略必要的pacakge和import代码
2    @EnableFeignClients
3    @EnableDiscoveryClient
4    @SpringBootApplication
5    public class ServiceCallerApp{
6        @Bean //定义日志级别是FULL
7        Level feignLoggerLevel()    { 
8            return Level.FULL; 
9        }
10        //启动类
11        public static void main( String[] args )  { 
12           SpringApplication.run(ServiceCallerApp.class, args); 
13       }
14    }

完成后，依次运行Eureka服务器、服务提供者和服务调用者的启动类，随后在浏览器里输入http://localhost:8080/callHello，即能在控制台里看到DEBUG级别的日志，下面给出了部分输出。

1 2018-06-17 12:18:27.296 DEBUG 208 --- [rviceProvider-2] com.controller.FeignClientTool : [FeignClientTool#sayHelloInClient] ---> GET http://sayHelloServiceProvider/hello/Peter?name=Peter HTTP/1.1

2 2018-06-17 12:18:27.296 DEBUG 208 --- [rviceProvider-2] com.controller.FeignClientTool : [FeignClientTool#sayHelloInClient] ---> END HTTP (0-byte body)

从第1行的输出里，咱们能看到以GET的方式向FeignClientTool类的sayHelloInClient方法发起调用，从第2行的输出里，能看到调用结束。

在上文里，咱们用的是FULL级别的日志，此外，还有NONE、BASIC和HEADERS这三种，在下表里，咱们将详细讲述各级别日志的输出状况。

日志输出级别	描述
NONE	不输出任何日志
BASIC	只输出请求的方法，请求的URL和相应的状态码，以及执行的时间
HEADERS	除了会输出BASIC级别的日志外，还会记录请求和响应的头信息
FULL	输出全部的和请求和响应相关的日志信息