【微服务】5、声明式 HTTP 客户端 —— Feign

简介: 【微服务】5、声明式 HTTP 客户端 —— Feign


一、RestTemplate 不好的地方

Long userId = orderById.getUserId();
String url = "http://userservice/users/getUserById/" + userId;
User userById = http.getForObject(url, User.class);

✏️ 代码可读性差、编程体验不统一

✏️ 当发送网络请求时的请求参数特别复杂的时候,URL 难以维护


二、Feign 是什么

✏️ Github 地址:https://github.com/OpenFeign/feign

✏️ Feign 是一个声明式的 HTTP 客户端

✏️ 可帮助开发者优雅地发送 HTTP 请求


三、使用

✏️ 依赖

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

✏️ 启动开关 @EnableFeignClients

@EnableFeignClients // 开启声明式 HTTP 客户端 Feign 的使用
@MapperScan("com.gq.order.mapper")
@SpringBootApplication
public class OrderApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
}

✏️ 编写 Feign 客户端(声明远程调用的信息)

基于 SpringMVC 注解声明远程调用的信息:

① 服务名称:userservice

② 请求方式:GET

③ 请求路径:/user/{id}

④ 请求参数:Long id

⑤ 返回值类型:User

@FeignClient("userservice") // 服务名称
public interface UserFeignClient {
    
    @GetMapping("/users/getUserById/{id}")
    User getById(@PathVariable String id);
}

@Service
@Transactional
public class OrderServiceImpl implements OrderService {
    @Resource
    private OrderMapper orderMapper;
    @Resource
    private UserFeignClient userFeignClient;
    /**
     * 根据订单 id 查询订单
     */
    @Transactional(readOnly = true)
    @Override
    public Order getOrderById(Long orderId) {
        Order orderById = orderMapper.getOrderById(orderId);
        if (orderById != null) {
            Long userId = orderById.getUserId();
            // 使用 Feign 发起远程调用
            User userById = userFeignClient.getById(userId + "");
            orderById.setUser(userById);
        }
        return orderById;
    }
}


四、自定义 Feign 的配置

(1) Feign 的几个常见配置

☘️ 一般修改的都是日志级别


(2) 配置 Feign 的日志级别

① 通过配置文件

全局配置:

feign:
  client:
    config:
      default: # default 是全局配置(若写服务名称, 则是针对该微服务的配置)
        loggerLevel: FULL # 日志级别

局部配置:

feign:
  client:
    config:
      userservice: # 写服务名称表示只针对该微服务的配置
        loggerLevel: FULL # 日志级别

② Java 代码配置日志级别

必须配置下面的配置结合 Feign 的日志配置才能有效果

logging:
  level:
    com.gq: debug

📖 创建 FeignClientConfiguration

/**
 * 对 Feign 的配置(该配置类在 Feign 相关的注解中使用)
 */
public class FeignClientConfiguration {
    @Bean
    public Logger.Level feignLogLevel() {
        return Logger.Level.FULL;
    }
}

📖 若是全局配置,将 FeignClientConfiguration 配置类放在 @EnableFeignClients 注解中

// 全局配置 Feign 的日志级别
@EnableFeignClients(defaultConfiguration = FeignClientConfiguration.class)
@MapperScan("com.gq.order.mapper")
@SpringBootApplication
public class OrderApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
}

📖 若是局部配置,将 FeignClientConfiguration 配置类放在 @FeignClient 注解中

// 局部配置 Feign 的日志级别
@FeignClient(value = "userservice", configuration = FeignClientConfiguration.class)
public interface UserFeignClient {
    @GetMapping("/users/getUserById/{id}")
    User getById(@PathVariable String id);
}


五、Feign 性能优化

(1) 性能优化介绍

📔 Feign 底层的客户端实现方案:

URLConnection: 默认实现(不支持连接池)

Apache HttpClient:支持连接池

OKHttp:支持连接池

📔 以上 OKHttpURLConnectionApache HttpClient 是几种发送 HTTP 请求的客户端工具

📔 不使用连接池性能会很差


🍒 Feign 性能优化主要包括两个方面:

① 使用支持连接池的 HTTP 请求客户端 (如 Apache HttpClient、OKHttp) 代替 URLConnection

② 日志级别最好使用 BASIC或 NONE【debug 的时候才用 FULL】


(2) 修改 Feign 底层的 HTTP 请求客户端

🎁 添加 HttpClient 依赖

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

🎁 在 yaml 文件配置连接池

feign:
  client:
    config:
      default:
        loggerLevel: BASIC # 打印基本的请求和响应信息
  httpclient:
    enabled: true # 开启 Feign 对 HttpClient 的支持
    max-connections: 168
    max-connections-per-route: 39 # 每个路径的最大连接数

六、Feign 的最佳实践

(1) 方式一:继承(不好,不推荐)

🎄 给消费者的 FeignClient 和提供者的 Controller 定义统一的父接口作为标准

(2) 方式二:抽取

🎄 将 Feign 抽取为独立的模块

当定义的 FeignClient 不在 SpringBootApplication 的扫描包范围时,FeignClient 将无法使用(解决方法如下)

🚀 指定 FeignClient 所在包

@EnableFeignClients(basePackages = {"com.guoqing.feign"})

🚀 指定 FeignClient 字节码

@EnableFeignClients(clients = {UserFeignClient.class})
相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
相关文章
|
3天前
|
机器学习/深度学习 负载均衡 Java
【SpringBoot系列】微服务远程调用Open Feign深度学习
【4月更文挑战第9天】微服务远程调度open Feign 框架学习
|
8天前
|
安全 Java 网络安全
Servlet 教程 之 Servlet 客户端 HTTP 请求 2
Servlet教程介绍了如何在Servlet中处理HTTP请求,包括获取Cookie、头信息、参数、Session等。方法如:`getCookies()`、`getAttributeNames()`、`getHeaderNames()`、`getParameterNames()`等。还能获取身份验证类型、字符编码、MIME类型、请求方法、远程用户信息、URL路径、安全通道状态以及请求内容长度等。此外,可通过`getSession()`创建或获取Session,并以`Map`形式获取参数。
21 8
|
1天前
|
Go 开发者
Golang深入浅出之-HTTP客户端编程:使用net/http包发起请求
【4月更文挑战第24天】Go语言的`net/http`包在HTTP客户端编程中扮演重要角色,但使用时需注意几个常见问题:1) 检查HTTP状态码以确保请求成功;2) 记得关闭响应体以防止资源泄漏;3) 设置超时限制,避免长时间等待;4) 根据需求处理重定向。理解这些细节能提升HTTP客户端编程的效率和质量。
11 1
|
4天前
|
JSON 测试技术 API
Python的Api自动化测试使用HTTP客户端库发送请求
【4月更文挑战第18天】在Python中进行HTTP请求和API自动化测试有多个库可选:1) `requests`是最流行的选择,支持多种请求方法和内置JSON解析;2) `http.client`是标准库的一部分,适合需要低级别控制的用户;3) `urllib`提供URL操作,适用于复杂请求;4) `httpx`拥有类似`requests`的API,提供现代特性和异步支持。根据具体需求选择,如多数情况`requests`已足够。
9 3
|
1月前
|
监控 网络安全 C++
Qt 5.14.2 网络编程揭秘:构建高效HTTP客户端与文件下载器
Qt 5.14.2 网络编程揭秘:构建高效HTTP客户端与文件下载器
|
1月前
|
存储 负载均衡 Java
【Spring底层原理高级进阶】微服务 Spring Cloud 的注册发现机制:Eureka 的架构设计、服务注册与发现的实现原理,深入掌握 Ribbon 和 Feign 的用法 ️
【Spring底层原理高级进阶】微服务 Spring Cloud 的注册发现机制:Eureka 的架构设计、服务注册与发现的实现原理,深入掌握 Ribbon 和 Feign 的用法 ️
|
1月前
|
存储 JSON Go
ElasticSearch的HTTP操作 和Go客户端
【2月更文挑战第13天】ElasticSearch的HTTP操作 和Go客户端操作
40 0
|
1月前
|
JSON Go API
Go语言网络编程:HTTP客户端开发实战
【2月更文挑战第12天】本文将深入探讨使用Go语言开发HTTP客户端的技术细节,包括发送GET和POST请求、处理响应、错误处理、设置请求头、使用Cookie等方面。通过实例演示和代码解析,帮助读者掌握构建高效、可靠的HTTP客户端的关键技术。
|
19天前
|
Java
java原生发送http请求
java原生发送http请求
|
26天前
|
网络协议 Linux iOS开发
推荐:实现RTSP/RTMP/HLS/HTTP协议的轻量级流媒体框架,支持大并发连接请求
推荐:实现RTSP/RTMP/HLS/HTTP协议的轻量级流媒体框架,支持大并发连接请求
56 1

热门文章

最新文章