springcloud (Finchley版本)简易入门 | 第三课： Feign实战

一、Feign简介

1.1、feign是什么 

@EnableFeignClients

       Feign是一个声明式的伪Http客户端，它使得写Http客户端变得更简单。使用Feign，只需要创建一个接口并注解。它具有可插拔的注解特性，可使用Feign 注解和JAX-RS注解。Feign支持可插拔的编码器和解码器。Feign默认集成了Ribbon，并和Eureka结合，默认实现了负载均衡的效果。

简而言之：

• Feign 采用的是基于接口的注解
• Feign 整合了ribbon，具有负载均衡的能力
• 整合了Hystrix，具有熔断的能力。

有了 Eureka，RestTemplate，Ribbon我们就可以😃愉快地进行服务间的调用了，但是使用RestTemplate还是不方便，我们每次都要进行这样的调用。

  @Autowired
    RestTemplate restTemplate;
    //private static final String  POWER_URL="http://SERVER-POWER";
    private static final String  ORDER_URL="http://SERVER-ORDER";

    /**
     * 获取订单信息
     * @param name
     * @return
     */
    @GetMapping("/getOrder.do")
    public R getOrder(@RequestParam String name){
        //调用订单系统
       Object object = restTemplate.getForObject(ORDER_URL+"/getOrder.do?name="+name,Object.class);
       return R.success("操作成功",object);
    }

   这样每次都调用RestRemplate的API是否太麻烦，我能不能像调用原来代码一样进行各个服务间的调用呢？

  聪明的小朋友肯定想到了，那就用映射呀，就像域名和IP地址的映射。我们可以将被调用的服务代码映射到消费者端，这样我们就可以“无缝开发”啦。

OpenFeign 也是运行在消费者端的，使用 Ribbon 进行负载均衡，所以 OpenFeign 直接内置了 Ribbon。

二、实战

继续使用上节课的 服务。

2.1、在客户端(User)引入依赖：

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

2.2、在启动类上面加上注解:@EnableFeignClients

在程序的启动类ServiceFeignApplication ，加上@EnableFeignClients注解开启Feign的功能：

2.3、定义一个feign接口

定义一个feign接口，通过@ FeignClient（“服务名”），来指定调用哪个服务。比如在代码中调用了server-order服务的/getOrder.do”接口，代码如下：

/**
 * 订单微服务 feign 调用封装
 *
 * @Author: dukun0210
 * @Date: 2021/1/8 17:27
 */
// 使用 @FeignClient 注解来指定提供者的名字
@FeignClient(value = "server-order")
public interface OrderFeignClient {


    // 这里一定要注意需要使用的是提供者那端的请求相对路径，这里就相当于映射了
    @RequestMapping(value = "/getOrder.do", method = RequestMethod.GET)
    public Map getOrder(@RequestParam(value = "name") String name);

//    @RequestMapping(value = "/provider/xxx",
//            method = RequestMethod.POST)
//    CommonResponse<List<Plan>> getPlans(@RequestBody planGetRequest request);
}

2.4、然后我们在Controller就可以像原来调用Service层代码一样调用它了。

@RestController
public class UserController {

    @Autowired
    OrderFeignClient orderFeignClient;

    /**
     * 通过feign调用微服务
     * @param name
     * @return
     */
    @GetMapping("/getOrderFeign.do")
    public R getOrderFeign(@RequestParam String name){
        //调用订单系统
        Map result =orderFeignClient.getOrder(name);
        return R.success("操作成功",result);
    }

}

看完上面的代码什么感觉？是不是感觉整个世界都干净了，没有底层的建立连接、构造请求、解析响应的代码，直接就是用注解定义一个 FeignClient接口，然后调用那个接口就可以了。人家FeignClient会在底层根据你的注解，跟你指定的服务建立连接、构造请求、发起靕求、获取响应、解析响应，等等。这一系列脏活累活，人家Feign全给你干了。

那么问题来了，Feign是如何做到这么神奇的呢？很简单，Feign的一个关键机制就是使用了动态代理。咱们一起来看看下面的图，结合图来分析：

• 首先，如果你对某个接口定义了@FeignClient注解，Feign就会针对这个接口创建一个动态代理

• 接着你要是调用那个接口，本质就是会调用 Feign创建的动态代理，这是核心中的核心

• Feign的动态代理会根据你在接口上的@RequestMapping等注解，来动态构造出你要请求的服务的地址

• 最后针对这个地址，发起请求、解析响应