2023年主流的选择仍是Feign, http客户端Feign还能再战

👳我亲爱的各位大佬们好😘😘😘
♨️本篇文章记录的为 微服务组件之http客户端Feign 相关内容，适合在学Java的小白,帮助新手快速上手,也适合复习中，面试中的大佬🙉🙉🙉。
♨️如果文章有什么需要改进的地方还请大佬不吝赐教❤️🧡💛
👨‍🔧 个人主页 : 阿千弟
🔥 上期内容👉👉👉 : 魔法反射–java反射初入门(基础篇)

近期，Spring 6 的第一个 GA 版本发布了，其中带来了一个新的特性——HTTP Interfac,这个新特性，可以让开发者将 HTTP 服务，定义成一个包含特定注解标记的方法的 Java 接口，然后通过对接口方法的调用，完成 HTTP 请求。看起来很像使用 Feign 来完成远程服务调用，这可能是 Spring “抛弃” feign 等 http 调用的一种趋势😕😕😕

2023年了, 总有一些人会说什么Feign已经过时了, 但是话说回来 Spring6只支持jdk17+的版本, 以国内的大多数互联网公司发展来讲, 目前已有的技术既然可以稳定使用, 为什么要费尽心思的迭代升级呢, 这个成本也是相当高的, 愿意为这项技术升级应该不少目前国内的主流趋势, 所以呢, 还是综合各种因素来讲, Feign可能在很长的一段时间内都不会过时, 还是老老实实的使用我们的Feign吧.😃😃😃

请添加图片描述

文章目录

- 下面再来介绍一下Feign的概念
- Feign的老前辈RestTemplate
- - RestTemplate的使用步骤
  - - 1. 创建RestTemplate对象
    - 2. 发送HTTP请求
    - 3. 处理响应
- Feign : 没错正是在下
- - Feign的优点
  - 快速使用
  - 关于解决url路径复杂问题
  - 自定义Feign的配置
- 一般需要配置的就是日志级别。
- - yaml配置feign的日志级别
  - Java代码方式配置feign的日志级别
  - 配置Feign客户端

下面再来介绍一下Feign的概念

Feign并没有过时。Feign是一个基于HTTP的客户端，它可以帮助开发人员轻松地编写RESTful API客户端。它提供了一种简单的方式来定义和使用RESTful服务，而不需要手动编写HTTP请求和解析响应。Feign还提供了负载均衡和服务发现的支持，使得它在微服务架构中非常有用。虽然现在有一些新的HTTP客户端库出现，但Feign仍然是一个非常流行和可靠的选择👍👍👍。

为什么要说它可以帮助开发人员轻松地编写RESTful API客户端?

在此之前, 我们通常使用的是Spring框架提供的一个用于访问RESTful服务的客户端工具类RestTemplate。它封装了HTTP请求的细节，使得我们可以通过简单的API调用来发送HTTP请求并处理响应。

Feign的老前辈RestTemplate

RestTemplate的使用步骤

使用RestTemplate发送HTTP请求的步骤如下：

1. 创建RestTemplate对象

可以通过new关键字创建RestTemplate对象，也可以通过Spring容器注入RestTemplate对象。

2. 发送HTTP请求

RestTemplate提供了多个方法用于发送HTTP请求，例如getForObject、postForObject、exchange等。这些方法的参数包括请求URL、请求方法、请求头、请求体等。

3. 处理响应

RestTemplate的HTTP请求方法返回的是响应体的数据，可以将响应体的数据转换为Java对象，也可以直接获取响应体的字符串。

以下是一个使用RestTemplate发送GET请求的示例代码：

RestTemplate restTemplate = new RestTemplate();
String url = "http://example.com/api/users/{id}";
User user = restTemplate.getForObject(url, User.class, 1);

在这个示例中，我们创建了一个RestTemplate对象，然后使用getForObject方法发送了一个GET请求，请求的URL是http://example.com/api/users/1，返回的响应体数据将被转换为User对象。

用起来看着很简单对不对

但是呢, 如果我们的请求路径的url比如长下面这个样子

https://www.baidu.com/link?url=Lx79smwh7or_e9MRQwSO37XaXIz3TkOT13bFjoyJraYTrxjrp-RAfXcncQ3rlsoSIXZieeFe_X4abq7QNw8gxlMaqjSLge9iVUSgB9yxK&wd=&eqid=bb5fafd50014d82d00000002644628ee

我们也都看到了, 这玩意写起来挺折磨人的
RestTemplate缺点:

代码可读性差，编程体验不统一
参数复杂URL难以维护

所以呢, 我们必须找一个更好的东西来代替

请添加图片描述

Feign : 没错正是在下

Feign的优点

代码简洁：Feign的接口定义非常简单，只需要定义一个接口，就可以轻松地调用远程服务。
自动化：Feign自动处理负载均衡和服务发现，可以轻松地将请求分发到不同的服务实例。
易于扩展：Feign可以轻松地扩展，可以添加拦截器和解码器，以满足不同的需求。
支持多种协议：Feign支持多种协议，包括HTTP、HTTPS、TCP和UDP等。

快速使用

Feign是一个声明式的Web服务客户端，它使得编写Web服务客户端变得更加容易。

举个例子, 如果我们要在一个微服务中调用另一个微服务, 比如我们现在想通过订单微服务去查询用户的信息, 显然正常情况下, 我们通常会将订单和用户拆分成两个不同的模块, 查询信息的思路无非是用订单微服务的controller调用用户微服务的controller, 思路其实很简单

以下是使用Feign的一些步骤：

添加Feign依赖

在Maven项目中，可以在pom.xml文件中添加以下依赖：

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

创建Feign客户端接口

创建一个接口，用于定义要调用的Web服务的方法。例如：
在OrderService中创建client.UserClient接口

在这里插入图片描述

UserClient 内容如下

@FeignClient(value = "userservice")
public interface UserClient {

    @GetMapping("/user/{id}")
    User findById(@PathVariable("id") Long id);
}

在上面的代码中，@FeignClient注解指定了要调用的服务的名称。接口中的方法定义了要调用的Web服务的HTTP方法和路径。

这里注意:
UserClient中findById方法的请求路径必须和user-service微服务模块中的UsersController的queryById方法的请求路径保持一致, @PathVariable不能省去

@Slf4j
@RestController
@RequestMapping("/user")
// @RefreshScope
public class UserController {
	@Resource
    private UserService userService;
    /**
     * 路径： /user/101
     * @param id 用户id
     * @return 用户
     */
    @GetMapping("/{id}")
    public User queryById(@PathVariable("id") Long id,
                          @RequestHeader(value = "Truth", required = false) String truth) {
        System.out.println("truth: " + truth);
        return userService.queryById(id);
    }
}

注入Feign客户端

在需要调用Web服务的类中，注入Feign客户端接口。例如：

@Service
public class OrderService {

    @Resource
    private OrderMapper orderMapper;

    @Resource
    private UserClient userClient;

    public Order queryOrderById(Long orderId) {
        // 1.查询订单
        Order order = orderMapper.findById(orderId);
        // 2.用Feign远程调用
        User user = userClient.findById(order.getUserId());
        // 3.封装user到Order
        order.setUser(user);
        // 4.返回
        return order;
    }
}

在上面的代码中，OrderService 类注入了UserClient 接口，并使用它来调用Web服务。

在这里插入图片描述
我们对结果对结果进行测试, 发现已成功响应

在这里插入图片描述

这里我起了两个user-service微服务, 经过以上的多次请求order-service微服务发现两个user-service微服务均有结果响应, 说明它不仅解决了远程调用问题, 还解决了服务调用间的负载均衡问题.

关于解决url路径复杂问题

是否记得我们上面接受请求参数使用的是@PathVariable注解, feign客户端是基于注解的形式来写参数的 , 那这就好办了, 不管url路径中的参数多么复杂, 我们一个@PathVariable给路径中的参数接过来就可以了

自定义Feign的配置

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

一般情况下，默认值就能满足我们使用，如果要自定义时，只需要创建自定义的@Bean覆盖默认Bean即可。

请添加图片描述

一般需要配置的就是日志级别。

NONE：不记录任何日志信息，这是默认值。
BASIC：仅记录请求的方法，URL以及响应状态码和执行时间
HEADERS：在BASIC的基础上，额外记录了请求和响应的头信息
FULL：记录所有请求和响应的明细，包括头信息、请求体、元数据。

yaml配置feign的日志级别

基于配置文件修改feign的日志级别可以针对单个服务：

feign:  
  client:
    config: 
      userservice: # 针对某个微服务的配置
        loggerLevel: FULL #  日志级别

也可以针对所有服务：

feign:  
  client:
    config: 
      default: # 这里用default就是全局配置，如果是写服务名称，则是针对某个微服务的配置
        loggerLevel: FULL #  日志级别

Java代码方式配置feign的日志级别

也可以基于Java代码来修改日志级别，先声明一个类，然后声明一个Logger.Level的对象：

public class DefaultFeignConfiguration  {
    @Bean
    public Logger.Level feignLogLevel(){
        return Logger.Level.BASIC; // 日志级别为BASIC
    }
}

如果要全局生效，将其放到启动类的@EnableFeignClients这个注解中：

@EnableFeignClients(defaultConfiguration = DefaultFeignConfiguration .class)

如果是局部生效，则把它放到对应的@FeignClient这个注解中：

@FeignClient(value = "userservice", configuration = DefaultFeignConfiguration .class)

配置Feign客户端

Feign底层的客户端实现：

URLConnection：默认实现，不支持连接池
Apache HttpClient ：支持连接池
OKHttp：支持连接池

因此优化Feign的性能主要包括：

使用连接池代替默认的URLConnection
日志级别，最好用basic或none

可以通过配置文件来配置Feign客户端的一些属性，例如连接超时时间、重试次数等。

例如：
Feign添加HttpClient的支持：
引入依赖：

<!--httpClient的依赖 -->
<dependency>    
	<groupId>io.github.openfeign</groupId>   
	 <artifactId>feign-httpclient</artifactId>
</dependency>

httpclient配置

example-service:
  ribbon:
    ReadTimeout: 5000
    ConnectTimeout: 5000
  feign:
    client:
      config:
        default:
          loggerLevel: BASIC # 日志级别，BASIC就是基本的请求和响应信息 
          retryer: com.netflix.client.retry.DefaultLoadBalancerRetryer
          readTimeout: 5000
          connectTimeout: 5000
  httpclient:
   enabled: true # 开启feign对HttpClient的支持  
   max-connections: 200 # 最大的连接数    
   max-connections-per-route: 50 # 每个路径的最大连接数