Redian新闻
>
Spring 6 正式“抛弃” feign

Spring 6 正式“抛弃” feign

公众号新闻

↓推荐关注↓

转自:juejin.cn/post/7173271507047546893

多数网友在对接第三方系统时,还在使用 httpclient、okhttp 等方式进行硬编码的形式实现对接。其实,我认为使用 feign 来实现更为方便快捷。feign 除了服务间的 http 调用外,还支持非服务间的 http 调用。只是,我们的一些思维还未转变过来,对 feign 的底层实现也缺乏一定的了解。
近期,Spring 6 的第一个 GA 版本发布了,其中带来了一个新的特性——HTTP Interface。这个新特性,可以让开发者将 HTTP 服务,定义成一个包含特定注解标记的方法的 Java 接口,然后通过对接口方法的调用,完成 HTTP 请求。看起来很像使用 Feign 来完成远程服务调用,这可能是 Spring “抛弃” feign 等 http 调用的一种趋势,Spring 要规范和简化这一块的实现了,让开发者更关注聚集于业务。下面我们参考官方文档来完成一个 Demo。

完成一个 Demo

首先创建一个简单的 HTTP 服务,这一步可以创建一个简单的 Spring Boot 工程来完成。
先创建一个实体类:
public class User implements Serializable {

    private int id;
    private String name;
    // 省略构造方法、Getter和Setter
    @Override
    public String toString() {
        return id + ":" + name;
    }
}

再写一个简单的 Controller:

@GetMapping("/users")
public List<User> list() {
    return IntStream.rangeClosed(110)
            .mapToObj(i -> new User(i, "User" + i))
            .collect(Collectors.toList());
}

确保启动服务之后,能够从http://localhost:8080/users地址获取到一个包含十个用户信息的用户列表。

下面我们新建一个 Spring Boot 工程。

Spring initializr
这里需要注意,Spring Boot 的版本至少需要是 3.0.0,这样它以来的 Spring Framework 版本才是 6.0 的版本,才能够包含 HTTP Interface 特性,另外,Spring Framework 6.0 和 Spring Boot 3.0 开始支持的 Java 版本最低是 17,因此,需要选择至少是 17 的 Java 版本。
另外,需要依赖 Spring Web 和 Spring Reactive Web 依赖,原因下文中会提到。
创建好新的 Spring Boot 工程后,首先需要定义一个 HTTP Interface 接口。最简单的定义如下即可:
public interface UserApiService {
    @GetExchange("/users")
    List<User> getUsers();
}

然后,我们可以写一个测试方法。

@Test
void getUsers() {
   WebClient client = WebClient.builder().baseUrl("http://localhost:8080/").build();
   HttpServiceProxyFactory factory = HttpServiceProxyFactory.builder(WebClientAdapter.forClient(client)).build();
   UserApiService service = factory.createClient(UserApiService.class);
   List<User> users = service.getUsers();
   for (User user : users) {
      System.out.println(user);
   }
}

最终回打印获取到的是个用户信息:

1:User1
2:User2
...
9:User9
10:User10

以上是一个最简单的示例,下面我们看看其中的一些细节。

GetExchange(HttpExchange)注解

上文例子中的 GetExchange 注解代表这个方法代替执行一个 HTTP Get 请求,与此对应,Spring 还包含了其他类似的注解:
GetExchange
这些注解定义在spring-web模块的org.springframework.web.service.annotation包下,除了 HttpExchange 之外,其他的几个都是 HttpExchange 的特殊形式,这一点与 Spring MVC 中的 RequestMapping/GetMapping 等注解非常相似。
以下是 HttpExchange 的源码:
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
@Reflective(HttpExchangeReflectiveProcessor.class)
public @interface HttpExchange 
{

    @AliasFor("url")
    String value() default "";

    @AliasFor("value")
    String url() default "";

    String method() default "";

    String contentType() default "";

    String[] accept() default {};

}
在上面的例子中,我们只指定了请求的资源路径。

UserApiService 实例的创建

在上面例子中,我们定义的 HTTP Interface 接口是 UserApiService,在测试方法中,我们通过 HttpServiceProxyFactory 创建了 UserApiService 的实例,这是参考了 Spring 的官方文档的写法。
你也可以将创建的过程写到一个 @Bean 方法中,从而可以将创建好的实例注入到其他的组件中。
我们再定义 UserApiService 的时候,只是声明了一个接口,那具体的请求操作是怎么发出的呢,我们可以通过 DEBUG 模式看得出来,这里创建的 UserApiService 的实例,是一个代理对象:

代理对象
目前,Spring 还没有提供更方便的方式来创建这些代理对象,不过,之后的版本肯定会提供,如果你感兴趣的话,可以从 HttpServiceProxyFactory 的createClient方法的源码中看到一些与创建 AOP 代理相似的代码,因此,我推测 Spring 之后可能会增加类似的注解来方便地创建代理对象。

其他特性

除了上述例子中的简单使用之外,添加了 HttpExchange 的方法还支持各种类型的参数,这一点也与 Spring MVC 的 Controller 方法类似,方法的返回值也可以是任意自定义的实体类型(就像上面的例子一样),此外,还支持自定义的异常处理。

为什么需要 Spring Reactive Web 的依赖

上文中创建工程的时候,引入了 Spring Reactive Web 的依赖,在创建代理的service对象的时候,使用了其中的 WebClient 类型。这是因为,HTTP Interface 目前只内置了 WebClient 的实现,它属于 Reactive Web 的范畴。Spring 在会在后续版本中推出基于 RestTemplate 的实现。

总结

本文带你对 HTTP Interface 特性进行了简单的了解,欢迎点赞加关注。


- EOF -



推荐阅读  点击标题可跳转

0、极客专属:几十款程序员秒懂的卫衣

1、往代码里掺东西,你还敢用?再见,Notepad++

2、世界上最伟大最邪恶的软件发明

3、ChatGPT 连夜迭代:你老婆不好使了


关注「程序员的那些事」加星标,不错过圈内事

点赞和在看就是最大的支持❤️

微信扫码关注该文公众号作者

戳这里提交新闻线索和高质量文章给我们。
相关阅读
春天先遣者,冬后一阳升英国伦敦爱丁堡带孩子游记 Spring 2023Spring 6 正式“抛弃”feignChase Sapphire Preferred (CSP) 信用卡【90k Offer 将于3月19日开始!】活不起!纽约、加州正在被“抛弃” !这些州成美国人搬家首选!MLPInit:MLP的权重可以直接迁移到GNN上!一种简单的GNN训练加速方法一文详解Prompt学习和微调(Prompt Learning & Prompt Tuning)多国,“抛弃”美元!我亲爱的爸爸在北京被新冠带走了最新案例:232414 Web designer 网页设计师|225113 Marketing specialist 市场专员Chinese Professor Suspended For Racist, Homophobic Speech老干妈,“抛弃”年轻人...Jiangsu Cities Add Mechanism to Report Pregnant Minors深入剖析 Spring Boot 的 SPI 机制天赋“易昺(bǐng)”,创造历史!疫情总结,无奈和悲催替换OpenFeign,Spring 新版本自带的 HTTP 客户端工具来了!别只会 SpringMVC 了!Spring 又官宣了一个更牛逼的替代框架!越来越多的美国人重返办公室工作 纽约加州正在被”抛弃”成千上万人“背井离乡”Spring 新特性,正式“抛弃”Feign了被“抛弃”的农历:中国农历为何被公历取代?打卡,Goodbye Spring BreakSpring break发酵!众多品牌“抛弃”张继科!他曾​被曝16岁涉赌,输钱后离队出走!删除、下架、终止合作…众多品牌“抛弃”张继科!他曾​被曝16岁涉赌,输钱后离队出走!代理律师最新回应旅途中被丈夫“抛弃”荒野,女子徒步20公里求助【周末综艺会6期】Spring Garden Show 和板蓝花儿开正式启动!首批海外华人免隔离入境,亲述“丝滑经历”!PR配额或涨至22万,澳洲各界急了!澳洲恐被中国游客“抛弃”...《花开富贵》恐遭盟主“抛弃”,日本“联美制华”,中日关系面临“范式之变”瑞士卢塞恩(Lucerne),山山水水遭多国“抛弃”!“美元霸权”还能维持多久[美食] [泰国]红包HONG BAO--Mega BangNaHadoop/Spark 太重,esProc SPL 很轻正式启动!首批海外华人免隔离入境,亲述“丝滑经历”!PR配额要涨至22万,澳洲各界急了!澳洲恐被中国游客“抛弃”...一年约2400家网点“关门”,银行正在”抛弃”老年人?Agustín Hernández:中美洲建筑背景下的未来主义巨构ChatGPT火了,微软“抛弃”元宇宙电动车“抛弃”了丰田章男
logo
联系我们隐私协议©2024 redian.news
Redian新闻
Redian.news刊载任何文章,不代表同意其说法或描述,仅为提供更多信息,也不构成任何建议。文章信息的合法性及真实性由其作者负责,与Redian.news及其运营公司无关。欢迎投稿,如发现稿件侵权,或作者不愿在本网发表文章,请版权拥有者通知本网处理。