目录
以前利用 RestTemplate 发起远程调用的代码:
服务消费端调用服务提供端例如order调用user
@Autowired
private RestTemplate restTemplate;
//用restTemplate查询用户
User user = restTemplate.getForObject("http://localhost:8081/user/" + order.getUserId(), User.class);
缺点:
- 代码可读性差,编程体验不统一
- 参数复杂URL难以维护。不够优雅
Feign 是一个声明式的 http 客户端,官方地址:
GitHub - OpenFeign/feign: Feign makes writing java http clients easier
其作用就是帮助我们优雅的实现 http 请求的发送
1 feign使用:
首先给消费端引入依赖:
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
消费服务端启动类添加注解 @EnableFeignClients
新建一个接口,内容如下:
@FeignClient(value = "userservice") //配置访问服务名称
public interface UserClient {
@GetMapping("/user/{id}") //访问方式和路径
User findById(@PathVariable("id") Long id); //访问参数和返回值
// feign通过以上参数可以匹配到对应的controller
}
以前用RestTemplate现在就可以改成用feign了
@Autowired
private UserClient userClient;
public Order queryOrderAndUserById(Long orderId) {
// 1.查询订单
Order order = orderMapper.findById(orderId);
// 使用feign远程调用
User user = userClient.findById(order.getUserId());
// 3. 将用户信息封装进订单
order.setUser(user);
// 4.返回
return order;
}
2.自定义配置:
类型 | 作用 | 说明 |
---|---|---|
feign.Logger.Level | 修改日志级别 | 包含四种不同的级别:NONE、BASIC、HEADERS、FULL |
feign.codec.Decoder | 响应结果的解析器 | http远程调用的结果做解析,例如解析json字符串为java对象 |
feign.codec.Encoder | 请求参数编码 | 将请求参数编码,便于通过http请求发送 |
feign.Contract | 支持的注解格式 | 默认是SpringMVC的注解 |
feign.Retryer | 失败重试机制 | 请求失败的重试机制,默认是没有,不过会使用Ribbon的重试 |
2.1修改 feign 的日志级别
而日志的级别分为四种:
- NONE:不记录任何日志信息,这是默认值。
- BASIC:仅记录请求的方法,URL以及响应状态码和执行时间
- HEADERS:在BASIC的基础上,额外记录了请求和响应的头信息
- FULL:记录所有请求和响应的明细,包括头信息、请求体、元数据
一般我们用NONE(没有日志)或BASIC(请求简报)其他级别对性能有一定的影响。具体看业务需求。
日志配置的方式有两种:
1.在服务的消费端yml中配置
feign:
client:
config:
userservice: # 针对某个微服务的配置 default: 默认是全局配置
loggerLevel: FULL # 日志级别
2.config的Bean加载
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 底层发起 http 请求,依赖于其它的框架。其底层客户端实现有:
- URLConnection:默认实现,不支持连接池
- Apache HttpClient :支持连接池
- OKHttp:支持连接池
因此提高 Feign 性能的主要手段就是使用连接池代替默认的 URLConnection
另外,日志级别应该尽量用 basic/none,可以有效提高性能。
这里我们用 Apache 的HttpClient来演示连接池。
2.2.1在服务消费端添加依赖:
<!--httpClient的依赖 -->
<dependency>
<groupId>io.github.openfeign</groupId>
<artifactId>feign-httpclient</artifactId>
</dependency>
2.2.2在消费端application.yml 中添加配置
feign:
client:
config:
default: # default全局的配置
loggerLevel: BASIC # 日志级别,BASIC就是基本的请求和响应信息
httpclient:
enabled: true # 开启feign对HttpClient的支持
max-connections: 200 # 最大的连接数
max-connections-per-route: 50 # 每个路径的最大连接数
针对feign的代码与实际的服务代码有大量的重合,我们有两种方式优化:
对与feign有相同的代码和请求,我们可以向上抽取:
优点
- 简单
- 实现了代码共享
缺点
- 服务提供方、服务消费方紧耦合
- 参数列表中的注解映射并不会继承,因此 Controller 中必须再次声明方法、参数列表、注解
将 FeignClient 抽取为独立模块,并且把接口有关的 pojo、默认的 Feign 配置都放到这个模块中,提供给所有消费者使用。
- 首先创建一个 module,命名为 feign-api;
- 在 feign-api 中然后引入依赖
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
3.将消费端依赖的实体类方法抽离出来,放入新的geign-api模块中
4.在服务消费端引入geign-api的依赖:
<dependency>
<groupId>com.zj.feign</groupId>
<artifactId>feign-api</artifactId>
<version>1.0</version>
</dependency>
5.添加 order-service(服务消费) 启动类上的 @EnableFeignClients
注解
//指定包扫描地址
@EnableFeignClients(basePackages = "com.zj.feign.clients")
启动服务,会发现十分优雅。。。