声明式服务调用 Feign
前言
在以往的单工程项目，所有代码都融合在一起，业务相互调用只需要引入共有的工具类或者对应模块的
service。
但是到了微服务时代，已然不能使用这种方式，我们需要寻找新的解决方案。
若每个模块都把需要调用模块的service拷贝一份，那会令代码非常冗余，影响整个工程的健壮性。
稍大一些的系统，会分成多个库，比如用户库、订单库分开，订单服务想要取到用户的相关信息，由于不能
连接到用户的库，所以无法直接新建数据库查询以达到目的。
这个时候，远程调用方案出现，订单服务只需调用用户服务的API，就可以获取所需信息，非常方便。
我们下面来学习，如何使用SpringCloud的Feign来进行微服务远程调用。

1.Feign简介

Feign是一种声明式、模板化的HTTP客户端。在Spring Cloud中使用Feign, 我们可以做到使用HTTP请求远程服 务时能与调用本地方法一样的编码体验,开发者完全感知不到这是远程方法,更感知不到这是个HTTP请求。

2.代码示例

  1. 我们以 blade-demo 中的服务为例，让我们的 blade-desk 可以调用到 blade-demo 的API
  2. 在 blade-demo-api 工程中创建一个新的 package ， feign

image.png

  1. 在 package ， feign 下创建一个接口类，命名为 BlogClient

  2. 增加如下代码

    1. package org.springblade.demo.feign; 
    2. import org.springblade.common.constant.CommonConstant;
    3. import org.springblade.core.tool.api.R;
    4. import org.springblade.demo.entity.Blog; 
    5. import org.springframework.cloud.openfeign.FeignClient; 
    6. import org.springframework.web.bind.annotation.GetMapping;
    7. import org.springframework.web.bind.annotation.RequestParam;
    8. @FeignClient( //定义Feign指向的service-id value = CommonConstant.APPLICATION_DEMO_NAME )
    9.  public interface BlogClient{ 
    10.      /*
    11.      *
    12.      * 接口前缀 */ 
    13.      String API_PREFIX = "/api/blog";
    14.      /*
    15.      *
    16.      * 获取详情
    17.      *
    18.      * @param id 主键
    19.      * @return */
    20.      @GetMapping(API_PREFIX + "/detail") 
    21.      R<Blog> detail(@RequestParam("id") Integer id); 
    22.  }

  3. 返回 blade-demo ，增加feign的实现类 BlogClientImpl

image.png

  1. 增加代码如下，因为Feign本质上是HTTP客户端，所以我们创建的 BlogClientImpl 其实就是 SpringMVC 的 Controller ，所以需要加上 @RestController 注解。 

    1. package org.springblade.demo.feign;
    2. import lombok.AllArgsConstructor;
    3. import org.springblade.core.tool.api.R; 
    4. import org.springblade.demo.entity.Blog; 
    5. import org.springblade.demo.service.BlogService; 
    6. import org.springframework.web.bind.annotation.GetMapping; 
    7. import org.springframework.web.bind.annotation.RestController;
    8. @RestController 
    9. @AllArgsConstructor 
    10. public class BlogClientImpl implements BlogClient {
    11.  private BlogService service;
    12.  @Override
    13.  @GetMapping(API_PREFIX + "/detail") 
    14.  public R<Blog> detail(Integer id) { 
    15.      return R.data(service.getById(id));
    16.  } 
    17. }

  2. 在 blade-desk 模块的 pom.xml 文件引入 blade-demo 的API包

image.png

  1. 找到 DashboardController ，新增如下代码

    1. private BlogClient client;
    2. @GetMapping("/blog-detail") 
    3. public R<Blog> blogDetail(Integer id) { 
    4.  R<Blog> result = client.detail(id);
    5.  return result;
    6. }

  2. 启动 blade-desk 并使用Postman调用查看API远程调用成功

image.png

  1. 我们再来看下控制台日志，请求先到了 /dashboard/blog-detail ，由于调用了 Feign ，程序又根 据 Feign 的配置去查找名为 blade-demo 的服务，并调用对应方法，最后返回了所需数据，整个流程 非常清晰

image.png