SpringCloud Feign

⒈Feign是什么？

　　Feign是Netflix开发的声明式、模板化的HTTP客户端， Feign可以帮助我们更快捷、优雅地调用HTTP API。

　　SpringCloud微服务项目之间调用是通过Rest请求来进行服务调用的，之前我们用到RestTemplate来进行服务请求，Spring通过Feign将RestTemplate封装成了可声明式的web客户端，使得编写web客户端更加简单。

　　在Spring Cloud中，使用Feign非常简单——创建一个接口，并在接口上添加一些注解，代码就完成了。Spring Cloud对Feign进行了增强，使Feign支持了Spring MVC注解和HttpmessageConverters、Feign注解或者JAX-RS注解等。Feign还支持可插拔的编码器和解码器，SpringCloud还对Feign集成了注册中心（Eureka）和客户端负载均衡（Ribbon），使得我们拥有一个客户端负载均衡的web请求客户端。

⒉示例

　　①在服务消费者项目工程中添加Feign依赖　　

         <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-netflix-ribbon</artifactId>
         </dependency>
         <dependency>
             <groupId>org.springframework.cloud</groupId>
             <artifactId>spring-cloud-starter-openfeign</artifactId>
         </dependency>

　　②创建一个Feign接口，并添加@FeignClient注解

 package cn.coreqi.feign;

 import cn.coreqi.entities.User;
 import org.springframework.cloud.openfeign.FeignClient;
 import org.springframework.web.bind.annotation.GetMapping;
 import java.util.List;

 @FeignClient(value = "USER-PROVIDER")   //指定微服务实例名称
 public interface UserFeignClient {
     @GetMapping("/users")   //指定调用微服务的服务地址
     public List<User> getList();
 }

　　③修改Controller代码，让其调用Feign接口

　　

 package cn.coreqi.controller;

 import cn.coreqi.entities.User;
 import cn.coreqi.feign.UserFeignClient;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 import org.springframework.web.client.RestOperations;
 import java.util.List;

 @RestController
 public class UserController {
     @Autowired
     private RestOperations restTemplate;

     @Autowired
     private UserFeignClient userFeignClient;

     @GetMapping("/userno1")
     public User getUsersFirst(){
         User[] users = restTemplate.getForObject("http://user-provider/users",User[].class);
         return users[0];
     }

     @GetMapping("/userno2")
     public User getUsersFirst1(){
         List<User> users = userFeignClient.getList();
         return users.get(0);
     }
 }

　　④修改主程序启动类，为其添加@EnableFeignClients注解

　　

 package cn.coreqi;

 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
 import org.springframework.cloud.client.loadbalancer.LoadBalanced;
 import org.springframework.cloud.openfeign.EnableFeignClients;
 import org.springframework.context.annotation.Bean;
 import org.springframework.web.client.RestOperations;
 import org.springframework.web.client.RestTemplate;

 @SpringBootApplication
 @EnableDiscoveryClient  //开启服务发现功能
 @EnableFeignClients(basePackages = {"cn.coreqi"})
 public class SpringbootcloudserviceconsumerApplication {

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

     @Bean
     @LoadBalanced   //使用负载均衡机制
     public RestOperations restTemplate(){
         return new RestTemplate();
     }

 }

⒊总结

　　其实通过Feign封装了HTTP调用服务方法，使得客户端像调用本地方法那样直接调用方法，类似Dubbo中暴露远程服务的方式，区别在于Dubbo是基于私有二进制协议，而Feign本质上还是个HTTP客户端。