当前位置：首页 > news >正文

服务间调用方式 OpenFeign 的介绍和使用

news 2026/1/30 3:40:13

文章目录

前言
1、 RestTemplate
- 1.1、通用方法 exchange
- 1.2、RestTemplate 和 OpenFeign 的区别
2、RPC 和 HTTP
- 2.1、RPC 是什么
- 2.2、RPC 调用过程示意图
- 2.3、HTTP 是什么
- 2.4、HTTP 调用过程示意图
- 2.5、对比
3 、OpenFeign
- 3.1 、OpenFeign 常用注解
- 3.2 、案例

前言

Feign 停更了，OpenFeign 是在 Feign 基础上开发出来的。

官网地址：https://spring.io/projects/spring-cloud-openfeign

1、 RestTemplate

RestTemplate 是从 Spring3.0 开始支持的一个 HTTP 请求工具，他提供了常见的 REST 请求方案的模板，例如GET请求、POST请求、PUT请求、DELETE请求以及一些通用的请求执行方法 exchange 以及execute。

RestTemplate继承自 InterceptingHttpAccessor 并且实现了 RespOperations 接口，其中 RestOperations 接口定义了基本的 RESTFUL 操作，这些操作在 RestTemplate 中都得到了实现。

1.1、通用方法 exchange

ResponseEntity<List> exchange = restTemplate.exchange(url, HttpMethod.GET, entity, List.class);

1.2、RestTemplate 和 OpenFeign 的区别

请求方式不一样

RestTemplate 需要每个请求都拼接 url + 参数 + 类文件，灵活性高但是消息封装臃肿。

OpenFeign 可以伪装成类似 SpringMVC 的 controller 一样，将 rest 的请求进行隐藏，不用再自己拼接 url 和参数，可以便捷优雅地调用HTTP API。

底层实现方式不一样

RestTemplate 在拼接url的时候，可以直接指定ip地址+端口号，不需要经过服务注册中心就可以直接请求接口，也可以指定服务名，请求先到服务注册中心（如nacos）获取对应服务的ip地址+端口号，然后经过HTTP转发请求到对应的服务接口（注意：这时候的restTemplate需要添加@LoadBalanced注解，进行负载均衡）。

Feign 的底层实现是动态代理，如果对某个接口进行了@FeignClient注解的声明，Feign就会针对这个接口创建一个动态代理的对象，在调用这个接口的时候，其实就是调用这个接口的代理对象，代理对象根据@FeignClient注解中name的值在服务注册中心找到对应的服务，然后再根据@RequestMapping等其他注解的映射路径构造出请求的地址，针对这个地址，再从本地实现HTTP的远程调用。

2、RPC 和 HTTP

2.1、RPC 是什么

RPC框架肯定是高于简单的HTTP接口的。但毋庸置疑，HTTP接口由于受限于HTTP协议，需要带HTTP请求头，导致传输起来效率或者说安全性不如RPC。（RPC 本身是一种框架，而http 是应用层的协议）

2.2、RPC 调用过程示意图

在这里插入图片描述

2.3、HTTP 是什么

http其实是一种网络传输协议，基于TCP，规定了数据传输的格式，现在客户端浏览器与服务端通信基本都是采用Http协议，也可以用来进行远程服务调用。

2.4、HTTP 调用过程示意图

在这里插入图片描述

2.5、对比

相同点

底层通讯都是基于socket，都可以实现远程调用，都可以实现服务间调用。

不同点

RPC是跨操作系统在同一编程语言内使用，Http是跨操作系统跨编程语言的远程调用框架。
当使用RPC框时限为服务调用的时候，要求服务提供方和服务消费方都必须使用统一的RPC框架，要么都是dubbo，要么都是cxf，当使用http进行服务间调用的时候，无需关注服务提供方使用的编程语言，也无需关注服务消费方使用的编程语言，服务提供方只需要提供restful风格的接口，服务消费方，按照restful的原则，请求服务即可。
RPC调用快、处理快，Http通用性强。
RPC需要满足像调用本地服务一样调用远程服务，也就是对调用过程在API层面进行封装；Http协议没有这样的要求，因此请求、响应等细节需要我们自己去实现。

3 、OpenFeign

OpenFeign 全称 Spring Cloud OpenFeign，它是 Spring 官方推出的一种声明式服务调用与负载均衡组件，它的出现就是为了替代进入停更维护状态的 Feign。

OpenFeign 是 Spring Cloud 对 Feign 的二次封装，它具有 Feign 的所有功能，并在 Feign 的基础上增加了对 Spring MVC 注解的支持，例如 @RequestMapping、@GetMapping 和 @PostMapping 等。

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

3.1 、OpenFeign 常用注解

注解	说明
@FeignClient	该注解用于通知 OpenFeign 组件对 @RequestMapping 注解下的接口进行解析，并通过动态代理的方式产生实现类，实现负载均衡和服务调用。
@EnableFeignClients	该注解用于开启 OpenFeign 功能，当 Spring Cloud 应用启动时，OpenFeign 会扫描标有 @FeignClient 注解的接口，生成代理并注册到 Spring 容器中。
@RequestMapping	Spring MVC 注解，在 Spring MVC 中使用该注解映射请求，通过它来指定控制器（Controller）可以处理哪些 URL 请求，相当于 Servlet 中 web.xml 的配置。
@GetMapping	Spring MVC 注解，用来映射 GET 请求，它是一个组合注解，相当于 @RequestMapping(method = RequestMethod.GET) 。
@PostMapping	该Spring MVC 注解，用来映射 POST 请求，它是一个组合注解，相当于 @RequestMapping(method = RequestMethod.POST) 。

3.2 、案例

启动类

package com.example.canal;import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.openfeign.EnableFeignClients;@EnableFeignClients(basePackages = "com.example.canal.feign")
@SpringBootApplication
@MapperScan(basePackages = "com.example.canal.mybatis.mapper")public class CanalApplication {public static void main(String[] args) {SpringApplication.run(CanalApplication.class,args);}
}

CouponFeignService

package com.example.canal.feign;import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.RequestMapping;@FeignClient("demo")
public interface CouponFeignService {@RequestMapping("/demo/queryOrder")public String queryOrder();
}

使用

@Override
public Map queryUser(int userId) {// 远程服务调用String queryOrder = couponFeignService.queryOrder();User user = userMapper.queryUser(userId);Map<String,Object> map = new HashMap<>();map.put("user",user);map.put("order",queryOrder);return map;
}