SpringCloud -- OpenFeign/Feign的使用及详解

2023-11-28 08:34:22

1. OpenFeign简介

Feign是一个声明式的Web Service客户端。它的出现使开发Web Service客户端变得很简单。使用Feign只需要创建一个接口加上对应的注解，比如：FeignClient注解。Feign有可插拔的注解，包括Feign注解和JAX-RS注解。
Feign也支持编码器和解码器，Spring Cloud Open Feign对Feign进行增强支持Spring MVC注解，可以像Spring Web一样使用HttpMessageConverters等。
Feign是一种声明式、模板化的HTTP客户端。在Spring Cloud中使用Feign，可以做到使用HTTP请求访问远程服务，就像调用本地方法一样的，开发者完全感知不到这是在调用远程方法，更感知不到在访问HTTP请求。

1.1 Feign

Feign是Spring Cloud组件中一个轻量级RESTful的HTTP服务客户端，Feign内置了Ribbon，用来做客户端负载均衡，去调用服务注册中心的服务。Feign的使用方式是：使用Feign的注解定义接口，调用接口，就可以调用服务注册中心的服务。

Feign的依赖：

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

1.2 OpenFeign

OpenFeign是Spring Cloud在Feign的基础上支持了SpringMVC的注解，如@RequestMapping等等。OpenFeign的@FeignClient可以解析SpringMVC的@RequestMapping注解下的接口，并通过动态代理的方式产生实现类，实现类中。

OpenFeign的依赖：

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

1.3 说明

SpringCloud F 及F版本以上 SpringBoot 2.0 以上基本上使用OpenFeign，OpenFeign 如果从框架结构上看就是2019年Feign停更后出现版本，也可以说大多数新项目都用OpenFeign ，2018年以前的项目在使用Feign。

2. OpenFeign的功能

可插拔的注解支持，包括Feign注解和JAX-RS注解。
支持可插拔的HTTP编码器和解码器（Gson，Jackson，Sax，JAXB，JAX-RS，SOAP）。
支持Hystrix和它的Fallback。
支持Ribbon的负载均衡。
支持HTTP请求和响应的压缩。
灵活的配置：基于 name 粒度进行配置
支持多种客户端：JDK URLConnection、apache httpclient、okhttp，ribbon）
支持日志
支持错误重试
url支持占位符
可以不依赖注册中心独立运行

3. OpenFeign的使用

效果： Feign = RestTemplate+Ribbon+Hystrix

3.1 添加依赖

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

3.2 启动类开启Feign

启动类使⽤注解@EnableFeignClients添加Feign⽀持

@SpringBootApplication 
@EnableDiscoveryClient // 开启服务发现
@EnableFeignClients	// 开启Feign
public class OpenfeignApplication {

	public static void main(String[] args) { 	
		SpringApplication.run(OpenfeignApplication.class, args);
	}

}

3.3 配置yml文件

在 application.yml 中进行配置，使项目注册到 Eureka 上：

server:
  port: 8021
  servlet:
    context-path: /

spring:
  profiles:
    active: dev
  application:
    name: openfeign

#注册到Eureka服务中心
eureka:
  client:
    service-url:
      # 注册到集群，就把多个EurekaServer地址使用逗号连接起来即可；注册到单实例（非集群模式），那就写一个就ok
      defaultZone: http://localhost:8761/eureka

未完待续，持续更新。

码农公寓