服务调用OpenFeign

OpenFeign

  • OpenFeign 介绍
  • OpenFeign 的使用
  • OpenFeign 参数传递
  • OpenFeign 超时控制
  • OpenFeign 日志设置
  • OpenFeign 的工作流程

OpenFeign 介绍

Feign 是 SpringCloud组件中一个轻量级RESTful的HTTP服务客户端,Feign集成了Ribbon、RestTemplate 实现了负载均衡的执行Http调用,对原有的方式(Ribbon+RestTemplate)进行了封装,对远程调用进行了简化,更加符合面向接口编程。
OpenFeign 是 springcloud 在 Feign 的基础上支持了 SpringMVC 的注解,如 @RequestMapping等。OpenFeign的 @FeignClient 可以解析 SpringMVC的 @RequestMapping 注解下的接口,并通过动态代理的方式产生实现类,实现类中做负载均衡并调用其他服务。

服务调用OpenFeign_第1张图片

OpenFeign 的使用

服务的消费者远程调用服务的提供者提供的接口,在服务的消费者中引入 OpenFeign 的依赖。

<dependency>
	<groupId>org.springframework.cloudgroupId>
	<artifactId>spring-cloud-starter-openfeignartifactId>
dependency>

在启动类上添加注解@EnableFeignClients,开启openFeign功能。

@SpringBootApplication
@EnableFeignClients
public class OrderApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
}

编写接口,使用@FeignClient注解。value 属性指定了服务提供者在注册中心的服务名。

@FeignClient(value = "userservice")
public interface UserClient {
    @GetMapping("/user/{id}")
    User findById(@PathVariable("id") Long id);
}

服务提供者接口程序,FeignClient 的请求路径,方式和参数要和被调用的服务路径保持一致。

@RestController
@RequestMapping("/user")
public class UserController {
    @Autowired
    private UserService userService;
    
    @GetMapping("/{id}")
    public User queryById(@PathVariable("id") Long id) {
        return userService.queryById(id);
    }
}

通过以上的配置,服务的消费者通过@FeignClient声明接口,就可以像调用本地方法一样,调用远程服务。

@Service
public class OrderService {
    @Autowired
    private OrderMapper orderMapper;
    @Autowired
    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;
    }
}

OpenFeign 参数传递

传递JSON数据,通过@RequestBody标识入参。

@FeignClient(value = "openFeign-provider")
public interface OpenFeignService {
    /**
     * 参数默认是 @RequestBody 标注的,这里的 @RequestBody 可以不填
     * 方法名称任意
     */
    @PostMapping("/openfeign/provider/order")
    Order createOrder(@RequestBody Order order);
}

POJO表单传参,参数使用POJO对象接收。openFeign提供了一个注解@SpringQueryMap完美解决POJO表单传参。

@FeignClient(value = "openFeign-provider")
public interface OpenFeignService {
    /**
     * 参数默认是@RequestBody标注的,如果通过POJO对象传参的,使用@SpringQueryMap标注
     */
    @PostMapping("/openfeign/provider/order")
    Order createOrder(@SpringQueryMap Order order);
}

URL中携带参数,此种方式针对restful方式中的GET请求。注解@PathVariable接收url中的占位符。

@FeignClient(value = "openFeign-provider")
public interface OpenFeignService {
    @GetMapping("/openfeign/provider/test/{id}")
    String get(@PathVariable("id")Integer id);
}

普通表单参数,此种方式传参不建议使用

@FeignClient(value = "openFeign-provider")
public interface OpenFeignService {
    /**
     * 必须要@RequestParam注解标注,且value属性必须填上参数名
     * 方法参数名可以任意,但是@RequestParam注解中的value属性必须和provider中的参数名相同
     */
    @PostMapping("/openfeign/provider/test")
    String test(@RequestParam("id") String arg1, @RequestParam("name") String arg2);
}

OpenFeign 超时控制

Feign客户端调用远程接口时,默认会等待1秒钟,如果服务端处理,超过1秒钟则会报错。
可以在 application.yaml 配置文件中设置超时时长。

#设置feign客户端超时时间(OpenFeign默认支持ribbon)
ribbon:
# 表示建立连接后从服务器读取到可用资源,所用时间
 ReadTimeout:  5000
# 表示建立连接时间,适用于网络正常的情况下,两端连接所用时间
 ConnectTimeout: 5000

OpenFeign 日志设置

通过日志可以对 Feign 接口的调用情况进行监控和输出。通过配置,调整日志级别,从而了解 Feign 中 Http 请求的细节。openFeign 默认是不显示任何日志的。

openFeign的日志级别如下:

  • NONE:默认的,不显示任何日志
  • BASIC:仅记录请求方法、URL、响应状态码及执行时间
  • HEADERS:除了BASIC中定义的信息之外,还有请求和响应的头信息
  • FULL:除了HEADERS中定义的信息之外,还有请求和响应的正文及元数据

使用配置类,进行日志级别设置

import feign.Logger;
import org.springframework.context.annotation.Bean;
@Configuration
public class FeignClientConfiguration{
    @Bean
    public Logger.Level logLevel(){
        return Logger.Level.FULL;
    }
}

全局配置,在启动类设置。

@EnableFeignClients(defaultConfiguration = FeignClientConfiguration.class) 

局部配置,放到对应的接口类中。

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

yaml 文件中设置接口日志级别

logging:
  level:
    com.feign.service: debug

com.feign.service 是 openFeign 接口所在的包名

使用配置文件设置日志级别

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

局部配置

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

OpenFeign 的工作流程

OpenFeign 使用了一种动态代理技术来封装远程服务调用的过程,在上面的UserClient接口中已经对服务的名称、接口类型、访问路径已经通过注解做了声明。
OpenFeign 通过解析这些注解标签生成一个动态代理类,这个代理类会将接口调用转化为一个远程服务调用的 Request,并发送给目标服务。

OpenFeign 远程调用过程
服务调用OpenFeign_第2张图片

  1. 从指定的目录下扫描并加载所有被 @FeignClient 注解修饰的接口。
  2. 对每一个 FeignClient 接口生成一个动态代理对象,即图中的 FeignProxyService
  3. 动态代理对象会被添加到 Spring 中,并注入到对应的服务里,也就是图中的 LocalService 服务
  4. LocalService 会发起底层方法调用。实际上这个方法调用会被 OpenFeign 生成的代理对象接管,由代理对象发起一个远程服务调用,并将调用的结果返回给 LocalService。

你可能感兴趣的:(微服务技术,微服务,openfeign)