SpringCloud Feign 远程调用（史上最详细讲解）

谁借莪１个温暖的怀抱￠ 2024-04-07 13:10 21阅读 0赞

> 作者：[大三的土狗][Link 1]  
> 专栏：[SpringCloud][]  
> ![在这里插入图片描述][c3d674d122e8490686a667ef2264ffd4.png]

#### 快速导航 ####

*  前言
 *   *  1、Feign 介绍
     *  2、Feign 的使用
     *   *   *  1、引入依赖
             *  2、添加注解
             *  3、编写Feign的客户端
             *  4、测试
     *  3、Feign的自定义配置
     *  4、Feign的优化使用
     *   *   *  1、引入依赖
             *  2、配置连接池
     *  5、Feign的最佳实践
     *   *  1、继承方式
         *  2、抽取方式
 *  总结

## 前言 ##

>   Feign是声明式的 web service 客户端，它让微服务的调用变得更简单了，帮助我们优雅的实现 http 请求的发送。SpringCloud集成了Ribbon和Eureka，可在使用Feign时提供负载均衡的http客户端。
> 
> ![在这里插入图片描述][0300faa742fd4a6291608e171e51cd80.png]

### 1、Feign 介绍 ###

利用RestTemplate发起远程调用代码如下：

//url
    String url = "http://user-service:8081/user/" + order.getUserId();
    //发起调用
    User user = restTemplate.getForObject(url,User.class);

此时代码可读性差，参数复杂 URL 难以维护。

而 Feign 是一个声明式的http客户端，其作用就是帮助我们优雅的实现 http 请求的发送。

官方地址：https://github.com/OpenFeign/feign

![在这里插入图片描述][8f765635cb1c481baabbb241270d4d1a.png]

### 2、Feign 的使用 ###

Feign替代RestTemplate的步骤如下：

##### 1、引入依赖 #####

在调用其他微服务的微服务order-service的pom.xml中添加。

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

##### 2、添加注解 #####

在调用其他微服务的微服务order-service的启动类添加注解开启Feign的功能。

@SpringBootApplication
    @EnableFeignClients
    public class OrderApplication {
        
    
        public static void main(String[] args) {
        
            SpringApplication.run(OrderApplication.class, args);
        }
    
        @Bean
        @LoadBalanced
        public RestTemplate restTemplate() {
        
            return new RestTemplate();
        }
    
    }

##### 3、编写Feign的客户端 #####

新建一个接口，代码如下。

@FeignClient("user-service")
    public interface UserClient {
        
        @GetMapping("/user/{id}")
        User findById(@PathVariable("id") Long id);
    }

这个客户端主要是基于SpringMVC的注解来声明远程调用的信息，Feign就可以帮助我们发送http请求，无需自己使用RestTemplate来发送了。

##### 4、测试 #####

修改order-service中的queryOrderById方法，使用Feign客户端代替RestTemplate。

@Autowired
        private UserClient userClient;
    
        public Order queryOrderById(Long orderId) {
        
            // 1.查询订单
            Order order = orderMapper.findById(orderId);
            //url
            //String url = "http://localhost:8081/user/" + order.getUserId();
            //String url = "http://user-service:8081/user/" + order.getUserId();
            //发起调用
            //User user = restTemplate.getForObject(url,User.class);
    
            //3、Feign实现
            User user = userClient.findById(order.getUserId());
    
            //3.存入order
            order.setUser(user);
            // 4.返回
            return order;
        }

![在这里插入图片描述][11ce93ee76bd43a08100c9cef7ba0ce3.png]

### 3、Feign的自定义配置 ###

Feign可以支持很多的自定义配置，一般情况下，默认值就能满足我们使用，如果要自定义时，只需要创建自定义的@Bean覆盖默认Bean即可，如下表所示：

<table> 
 <thead> 
  <tr> 
   <th>类型</th> 
   <th>作用</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td><strong>feign.Logger.Level</strong></td> 
   <td>修改日志级别</td> 
   <td>包含四种不同的级别：NONE、BASIC、HEADERS、FULL</td> 
  </tr> 
  <tr> 
   <td>feign.codec.Decoder</td> 
   <td>响应结果的解析器</td> 
   <td>http远程调用的结果做解析，例如解析json字符串为java对象</td> 
  </tr> 
  <tr> 
   <td>feign.codec.Encoder</td> 
   <td>请求参数编码</td> 
   <td>将请求参数编码，便于通过http请求发送</td> 
  </tr> 
  <tr> 
   <td>feign. Contract</td> 
   <td>支持的注解格式</td> 
   <td>默认是SpringMVC的注解</td> 
  </tr> 
  <tr> 
   <td>feign. Retryer</td> 
   <td>失败重试机制</td> 
   <td>请求失败的重试机制，默认是没有，不过会使用Ribbon的重试</td> 
  </tr> 
 </tbody> 
</table>

自定义配置 有 配置文件方式 和 Java代码方式 两种方式，在此不展开讲述了。

### 4、Feign的优化使用 ###

##### 1、引入依赖 #####

在order-service的pom文件中引入Apache的HttpClient依赖：

<dependency>
        <groupId>io.github.openfeign</groupId>
        <artifactId>feign-httpclient</artifactId>
    </dependency>

##### 2、配置连接池 #####

在order-service的application.yml中添加配置：

feign:
      client:
        config:
          default: # default全局的配置
            loggerLevel: BASIC # 日志级别，BASIC就是基本的请求和响应信息
      httpclient:
        enabled: true # 开启feign对HttpClient的支持
        max-connections: 200 # 最大的连接数
        max-connections-per-route: 50 # 每个路径的最大连接数

Feign的**优化**：日志级别尽量用basic；使用HttpClient或OKHttp代替URLConnection。

### 5、Feign的最佳实践 ###

#### 1、继承方式 ####

1）定义一个API接口，利用定义方法，并基于SpringMVC注解做声明。

2）Feign客户端和Controller都集成改接口

![在这里插入图片描述][2a19fe0e1fb9494aae721f9993f0e34b.png]

优点：

*  简单
 *  实现了代码共享

缺点：

*  服务提供方、服务消费方紧耦合
 *  参数列表中的注解映射并不会继承，因此Controller中必须再次声明方法、参数列表、注解

#### 2、抽取方式 ####

将Feign的Client抽取为独立模块，并且把接口有关的POJO、默认的Feign配置都放到这个模块中，提供给所有消费者使用。

![在这里插入图片描述][8db5608bafe742b496b47483dcd06cc8.png]

## 总结 ##

>   其实Feign就是一个声明式的http客户端，帮助我们实现**优雅**的http请求的发送。以上就是Feign实现远程调用的全部内容，仅供参考，最后送上一句，每日毒鸡汤：“半夜給你留燈的，只有自動售貨機。”

[Link 1]: https://blog.csdn.net/qq_53463544?type=blog
[SpringCloud]: https://blog.csdn.net/qq_53463544/category_11977470.html?spm=1001.2014.3001.5482
[c3d674d122e8490686a667ef2264ffd4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/07be678ebe8b4244ab33cc1034ef3d5e.png
[0300faa742fd4a6291608e171e51cd80.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/05a4fb8dc3a14aaa8ff27f824ef19ec4.png
[8f765635cb1c481baabbb241270d4d1a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/fd4562c6fc3040b29bbee69778eb7a9c.png
[11ce93ee76bd43a08100c9cef7ba0ce3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/e860cf480af7460ba739b0b8854ed91e.png
[2a19fe0e1fb9494aae721f9993f0e34b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/23acea75d2264d06ac347d4ce5943463.png
[8db5608bafe742b496b47483dcd06cc8.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/07/80d32fc454894aedaa35bdc58ff48898.png