SpringCloud Feign 声明式服务调用

服务调用有2种方式：REST、RPC，SpringCloud一般用RestTemplate来实现REST调用，

此外SpringCloud还可以使用Feign来调用服务，Feign是声明式的服务调用，所谓声明式就是通过服务接口来调用，和RPC相似。

REST使用HTTP协议，RPC使用TCP协议，Feign只是伪RPC调用，因为Feign底层使用的协议是HTTP。

Eureka、Ribbon、Feign都是Netflix旗下的项目，都被SpringCloud集成了。

此处写一个feign的demo，获取用户的所有订单，user-service调用order-service

---

服务消费者user-service

（1）创建时勾选Spring Cloud Routing -> OpenFeign，当然Eureka Client、Spring Web等等也要勾选，不用勾选Ribbon，Eureka Client中已经包含了Ribbon的依赖

也可以收手动加feign的依赖：

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

（2）引导类上加 @EnableFeignClients

  

（3）新建包feign用来存放feign服务调用的接口，包下新建接口OrderFeignService

@FeignClient("order-service") //参数指定要调用的服务名称。feign也内置了ribbon，会自动实现负载均衡
public interface OrderFeignService {

    @GetMapping("/api/v1/order/list") //该服务要调用的地址，不需要使用RESTful风格
    List<Order> findOrdersByUserId(@RequestHeader("user_id") Integer user_id); //使用参数表传递参数

}

一个要调用的服务对应一个接口，如果要调用多个服务，写多个接口。

使用参数表传递参数，每个参数前都要加注解。

启动应用时检测到引导类上有@EnableFeignClients，会扫描@FeignClient标注的接口，给该接口生成动态代理（使用RestTemplate来代理），放在Spring容器中。

调用服务时，底层还是使用RestTemplate来调用服务，使用的还是HTTP协议。

（4）controller

@Controller
@RequestMapping("/api/v1/user")
public class UserController {
    //注入要调用的服务接口，实际是注入动态代理生成的RestTemplate
　　@Resource
    private OrderFeignService orderFeignService;
//根据用户id查找用户所有订单
    @GetMapping("/order/{user_id}")
    @ResponseBody
    public List<Order> findOrdersByUserId(@PathVariable Integer user_id){
        //调用Feign客户端（接口）的方法，传入需要的参数
        List<Order> orderList = orderFeignService.findOrdersByUserId(user_id);
        return orderList;
    }

}

实际写代码时要在service层调用服务。

Feign比RestTemplate要麻烦些，底层还是调用RestTemplate，还要包装为代理对象，时间、资源开销都增加了；

一会儿用RESTful风格传参，一会@RequestHeader传参，不统一，如果要在被调者中使用RESTful风格，还需要再写一个方法映射为RESTful风格。

但把服务调用写成接口，使得服务调用也是面向接口编程的，消费者、提供者没有耦合在业务方法（类）中，使用接口对接降低了耦合；

升级时只需修改feign包下的feign接口，不必到处修改RestTemplate的调用，好维护，所以feign也很常用。

---

服务提供者

@Controller
@RequestMapping("/api/v1/order")
public class OrderController {

    //根据用户id查找该用户的所有订单
    @GetMapping("/list")  //请求方式、映射地址都要和消费者中的Feign接口对应
    @ResponseBody
    public List<Order> findAllByUserId(@RequestHeader("user_id") Integer user_id){ //参数表要和消费者中Feign接口中方法的参数表对应
        //一些列操作
        //......
        return orderList;
    }

}

Feign有一个很不好地方的：传参方式不统一，消费者用@RequestHeader传参，提供者也要用这个来接收，难以统一使用RESTful

---

消费者使用@RequestHeader传，提供者只能使用@RequestHeader、@RequestParam来接收。

消费者使用@RequestBody传，提供者只能使用@RequestBody、@RequestParam来接收。

@RequestParam是通用的，请求头、请求体中的数据都可以接收。

一般地，少量数据比如int、String使用@RequestHeader传输，大量数据比如Map、User对象使用@RequestBody来传输。

使用@RequestBody时，映射方式要使用@PostMapping，不能使用@GetMapping，因为体积大，要使用post。

@RequestHeader是将数据绑定到请求头，使用Get方式传输，或者从请求头中获取数据；

@RequestBody是将数据绑定大请求体，使用Post方式传输，或者从请求体中获取数据。

@PathVariable是接收Restful风格的url中的参数。

Restful有个缺点：能传递的数据类型有限，毕竟要写在url中，不能是User之类的对象。

映射方式：

@RequestMapping可以接收、处理所有请求方式中的某一种，需使用method属性指定，不指定时默认为 RequestMethod.GET

@GetMapping只接收、处理GET方式的请求，是@RequestMapping(method=RequestMethod.GET)的简写

@PostMapping只接收、处理POST方式的请求，是@RequestMapping(method=RequestMethod.POST)的简写

@PutMapping

@DeleteMapping