Spring Cloud 学习 --- 声明式REST客户端 Fegin

2024-04-02 16:38
文章标签 java 学习 spring cloud 客户端 声明 rest fegin

本文主要是介绍Spring Cloud 学习 --- 声明式REST客户端 Fegin，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

基于上一文 Eureka服务注册与发现 中的项目，继续完成关于 Fegin 相关的代码编写。

本次学习最终实现效果：

fegin

版本信息

https://spring.io/projects/spring-cloud

  • Spring Boot 版本：2.1.11.RELEASE
  • Spring Cloud 版本：Greenwich.SR4

WHAT — 定义

来自 官网 的定义：

Feign is a declarative web service client. It makes writing web service clients easier. To use Feign create an interface and annotate it. It has pluggable annotation support including Feign annotations and JAX-RS annotations. Feign also supports pluggable encoders and decoders. Spring Cloud adds support for Spring MVC annotations and for using the same HttpMessageConverters used by default in Spring Web. Spring Cloud integrates Ribbon and Eureka, as well as Spring Cloud LoadBalancer to provide a load-balanced http client when using Feign.

Feign是一个声明性web服务客户端。它使编写web服务客户端变得更容易。使用Feign创建一个接口并对其进行注释。它有可插入的注释支持，包括外部注释和JAX-RS注释。Feign还支持可插入的编码器和解码器。Spring Cloud增加了对Spring MVC注释的支持，以及对使用Spring Web中默认使用的httpMessageConverter的支持。Spring Cloud集成了Ribbon和Eureka以及Spring Cloud LoadBalancer，在使用Feign时提供了一个负载平衡的http客户端。

什么是声明式?

声明式调用就像调用本地方法一样调用远程方法，无感知远程HTTP请求。它解决了让开发者调用远程接口就跟调用本地方法一样，无需关注与远程的交互细节，更无需关注分布式环境开发。

WHY — 特点

Feign是一个声明式的伪Http客户端，它使得写Http客户端变得更简单。

使用Feign，只需要创建一个接口并注解，它具有可插拔的注解特性，可使用Feign 注解和JAX-RS注解，Feign支持可插拔的编码器和解码器，Feign默认集成了Ribbon，并和Eureka结合，默认实现了负载均衡的效果。

Feign 具有如下特性：

  • 可插拔的注解支持，包括Feign注解和JAX-RS注解
  • 支持可插拔的HTTP编码器和解码器
  • 支持Hystrix和它的Fallback
  • 支持Ribbon的负载均衡
  • 支持HTTP请求和响应的压缩Feign是一个声明式的Web Service客户端，它的目的就是让Web Service调用更加简单。它整合了Ribbon和Hystrix，从而不再需要显式地使用这两个组件。Feign还提供了HTTP请求的模板，通过编写简单的接口和注解，就可以定义好HTTP请求的参数、格式、地址等信息。接下来，Feign会完全代理HTTP的请求，我们只需要像调用方法一样调用它就可以完成服务请求。

简而言之：Feign能干Ribbon和Hystrix的事情，但是要用Ribbon和Hystrix自带的注解必须要引入相应的jar包才可以。

HOW — 使用

入门调用
  • 步骤一：修改 pom 文件，添加 Feign 依赖
<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
  • 步骤二：修改启动类，添加开启 Feign 注解
@SpringBootApplication
@EnableEurekaClient
@EnableFeignClients  //开启Feign客户端
public class EurekaClientConsumerApplication {public static void main(String[] args) {SpringApplication.run(EurekaClientConsumerApplication.class, args);}}
  • 步骤三：编写 Feign 接口，完成远程调用，取代 dao 层
/*** @Description: 用户模块通过feign调用接口** 定义个feign接口 @FeignClient("服务名") 来确定调哪个服务*/
@FeignClient(name = "eureka-client-provider")
public interface UserFeignClient {@GetMapping("/login")String login();
}
  • 步骤四：修改 controller， 将调用 dao 修改成 feign
@RestController
public class UserController {@Autowiredprivate UserFeignClient userFeignClient;@GetMapping("/userlogin")public String login() {return "8881收到结果：" + userFeignClient.login();}
}

上面使用 fegin 为入门版，后面的几种调用更接近实际开发：多参数调用、实体类调用、图片上传。

多参数调用
  • 步骤一：provider 中增加调用方法，完成处理逻辑
    @PostMapping("/userLoginPostParam")public String postParamLogin(@RequestParam("name") String name, @RequestParam("pwd") String pwd) {String result = "登录失败。";if (StringUtils.isNotEmpty(name) && StringUtils.isNotEmpty(pwd)) {if (name.equals("tyron") && pwd.equals("123456")) {result = "登录成功";}}return result;}
  • 步骤二：consumer 的 services 增加接口，供 controller 调用
    @PostMapping("/userLoginPostParam")String postParamLogin(@RequestParam("name") String name, @RequestParam("pwd") String pwd);
  • 步骤三：consumer 的 controller 增加方法，暴露给外部调用
    @PostMapping("/userLoginPostParam")public String postParamLogin(@RequestParam("name") String name, @RequestParam("pwd") String pwd) {return "登录结果：" + userFeignClient.postParamLogin(name, pwd);}
  • 步骤四：postman调用

postman调用

实体类调用
  • 步骤一：引入 common 项目，方便 provider 和 consumer 项目同时调用

构建 maven 项目即可！链接：

  • 步骤二：common 项目创建实体类 UserModel
@Getter
@Setter
public class UserModel {private String name;private String pwd;private int age;private Date birthday;}
  • 步骤三：provider 和 consumer 项目同时引入 common 项目
<!--common依赖-->
<dependency><groupId>com.tyron</groupId><artifactId>common</artifactId><version>1.0-SNAPSHOT</version>
</dependency>
  • 步骤四：provider 中增加调用方法，完成处理逻辑
	@PostMapping("/userLoginPostModel")public String postModelLogin(@RequestBody UserModel userModel) {String result = "登录失败。";if (StringUtils.isNotEmpty(userModel.getName()) && StringUtils.isNotEmpty(userModel.getPwd())) {if (userModel.getName().equals("tyron") && userModel.getPwd().equals("654321")) {result = "登录成功";}}return result;}
  • 步骤五：consumer 的 services 增加接口，供 controller 调用
    @PostMapping("/userLoginPostModel")String userLoginPostModel(@RequestBody UserModel userModel);
  • 步骤六：consumer 的 controller 增加方法，暴露给外部调用
    @PostMapping("/userLoginPostModel")public String postModelLogin(@RequestBody UserModel userModel) {return "登录结果：" + userFeignClient.userLoginPostModel(userModel);}
  • 步骤七：postman调用

postman调用

文件上传
  • 步骤一：provider 中增加调用方法，完成处理逻辑
@RestController
public class FileUpload {@PostMapping(value = "/uploadFile", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)public String handleFileUpload(@RequestPart(value = "file") MultipartFile file) {if (file == null) {return "文件不能为空。";}return file.getOriginalFilename() + "的文件上传成功";}
}
  • 步骤二：consumer 的 application.yml 修改配置文件
spring:application:name: eureka-client-consumer# 多个接口上的@FeignClient(“相同服务名”)会报错：name has already been defined and overriding is disabled。# 设置 为true ,即 允许 同名main:allow-bean-definition-overriding: true
  • 步骤三：provider 中增加调用方法，完成处理逻辑
@FeignClient(name = "eureka-client-provider", configuration = FileUploadClient.MultipartSupportConfig.class)
public interface FileUploadClient {@PostMapping(value = "/uploadFile", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)String handleFileUpload(@RequestPart(value = "file") MultipartFile file);public class MultipartSupportConfig {@Autowiredprivate ObjectFactory<HttpMessageConverters> messageConverters;@Beanpublic Encoder feignFormEncoder() {return new SpringFormEncoder(new SpringEncoder(messageConverters));}}
}
  • 步骤四：consumer 项目引入依赖
<dependency><groupId>io.github.openfeign.form</groupId><artifactId>feign-form</artifactId><version>3.8.0</version>
</dependency>
<dependency><groupId>io.github.openfeign.form</groupId><artifactId>feign-form-spring</artifactId><version>3.8.0</version>
</dependency>
<dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.4</version>
</dependency>
  • 步骤五：provider 中增加测试方法，完成处理逻辑
    @Autowiredprivate FileUploadClient fileUploadClient;@Test@SneakyThrowspublic void testHandleFileUpload() {File file = new File("C:\\Users\\Administrator\\Desktop\\111.txt");DiskFileItem fileItem = (DiskFileItem) new DiskFileItemFactory().createItem("file",MediaType.TEXT_PLAIN_VALUE, true, file.getName());try (InputStream input = new FileInputStream(file); OutputStream os = fileItem.getOutputStream()) {IOUtils.copy(input, os);} catch (Exception e) {throw new IllegalArgumentException("Invalid file: " + e, e);}MultipartFile multi = new CommonsMultipartFile(fileItem);log.info(fileUploadClient.handleFileUpload(multi));}
  • 步骤六：运行，观察日志输出

文件上传

参考

  • OpenFeign/feign
  • 官方Feign文件上传
  • tyronczt/Spring-Cloud-Learning 提交记录
  • Spring Cloud中如何优雅的使用Feign调用接口
  • 学习SpringCloud Feign带你从0到1
  • Spring Cloud Feign的文件上传实现

这篇关于Spring Cloud 学习 --- 声明式REST客户端 Fegin的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/870508。

相关文章

HarmonyOS学习(七)——UI（五）常用布局总结

HarmonyOS学习(七)——UI（五）常用布局总结

自适应布局 1.1、线性布局（LinearLayout） 通过线性容器Row和Column实现线性布局。Column容器内的子组件按照垂直方向排列，Row组件中的子组件按照水平方向排列。 属性说明space通过space参数设置主轴上子组件的间距，达到各子组件在排列上的等间距效果alignItems设置子组件在交叉轴上的对齐方式，且在各类尺寸屏幕上表现一致，其中交叉轴为垂直时，取值为Vert
阅读更多...
Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya-AI分享的他在OpenAI学习到的15个提示工程技巧

Ilya（不是本人，claude AI）在社交媒体上分享了他在OpenAI学习到的15个Prompt撰写技巧。 以下是详细的内容： 提示精确化:在编写提示时,力求表达清晰准确。清楚地阐述任务需求和概念定义至关重要。例:不用"分析文本",而用"判断这段话的情感倾向:积极、消极还是中性"。 快速迭代:善于快速连续调整提示。熟练的提示工程师能够灵活地进行多轮优化。例:从"总结文章"到"用
阅读更多...
JVM 的类初始化机制

JVM 的类初始化机制

前言 当你在 Java 程序中new对象时，有没有考虑过 JVM 是如何把静态的字节码（byte code）转化为运行时对象的呢，这个问题看似简单，但清楚的同学相信也不会太多，这篇文章首先介绍 JVM 类初始化的机制，然后给出几个易出错的实例来分析，帮助大家更好理解这个知识点。 JVM 将字节码转化为运行时对象分为三个阶段，分别是：loading 、Linking、initialization
阅读更多...
Spring Security 基于表达式的权限控制

Spring Security 基于表达式的权限控制

前言 spring security 3.0已经可以使用spring el表达式来控制授权，允许在表达式中使用复杂的布尔逻辑来控制访问的权限。 常见的表达式 Spring Security可用表达式对象的基类是SecurityExpressionRoot。 表达式描述hasRole([role])用户拥有制定的角色时返回true （Spring security默认会带有ROLE_前缀）,去
阅读更多...
浅析Spring Security认证过程

浅析Spring Security认证过程

类图 为了方便理解Spring Security认证流程，特意画了如下的类图，包含相关的核心认证类 概述 核心验证器 AuthenticationManager 该对象提供了认证方法的入口，接收一个Authentiaton对象作为参数; public interface AuthenticationManager {Authentication authenticate(Authenti
阅读更多...
Spring Security--Architecture Overview

Spring Security--Architecture Overview

1 核心组件 这一节主要介绍一些在Spring Security中常见且核心的Java类，它们之间的依赖，构建起了整个框架。想要理解整个架构，最起码得对这些类眼熟。 1.1 SecurityContextHolder SecurityContextHolder用于存储安全上下文（security context）的信息。当前操作的用户是谁，该用户是否已经被认证，他拥有哪些角色权限…这些都被保
阅读更多...
Spring Security基于数据库验证流程详解

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明（认真看哦） AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证，则会调用 #attemptAuthentica
阅读更多...
Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
Java架构师知识体认识

Java架构师知识体认识

源码分析 常用设计模式 Proxy代理模式Factory工厂模式Singleton单例模式Delegate委派模式Strategy策略模式Prototype原型模式Template模板模式 Spring5 beans 接口实例化代理Bean操作 Context Ioc容器设计原理及高级特性Aop设计原理Factorybean与Beanfactory Transaction 声明式事物
阅读更多...
【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【课程链接】 AntV G6：深入图形与图形分组、自定义节点、节点动画（下）_哔哩哔哩_bilibili 本章十吾老师讲解了一个复杂的自定义节点中，应该怎样去计算和绘制图形，如何给一个图形制作不间断的动画，以及在鼠标事件之后产生动画。（有点难，需要好好理解） <!DOCTYPE html><html><head><meta charset="UTF-8"><title>06
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2