舒服啊,给Spring贡献一波源码。

共 8113字,需浏览 17分钟

 ·

2022-03-18 07:17

你好呀,我是敖丙。

这周我在 Spring 的 github 上闲逛的时候,一个 issues 引起了我的兴趣。

这篇文章,是我顺着这个 issues 往下写,始于它,但是不止于它:

https://github.com/spring-projects/spring-framework/pull/27818

这个 issues 标题翻译过来,就是说希望 @Async 这个注解能够支持占位符或 SpEL 表达式。

而我关注到这个 issues 的原因,完全是因为我之前写过 @Async 相关的文章,看着眼熟,就随手点进来看了一下。

在这个问题里面,提到了一个编号为 27775 的 issues:

https://github.com/spring-projects/spring-framework/issues/27775

这个说的是个啥事儿呢?

估计你看一眼我截图中标注的地方也就看出来了,他想把线程池的名称放到配置文件里面去。而这个需求我觉得并不奇怪,基于 Spring 框架来说,是一个很合理的需求。

搞个 Demo

我还是先给你搞个 Demo,验收一下它想要干啥。

首先注入了一个名称为 why 的线程池。

然后有一个被 @Async 注解修饰的方法,而这个注解指定了一个值为 why 的 value,表明要使用名称为 why 的这个线程池:

接着我们还需要一个 Controller,触发一下:

最后在启动类上加上 @EnableAsync 注解,把项目启动起来。

调用下面的链接,发起调用:

http://127.0.0.1:8085/insertUser?age=18

输出结果如下:

说明配置生效了。

然后,提出 issues 的这个哥们,他想要这么一个功能:

也就是让 @Async 注解和配置文件进行联动。

目前 Spring 的版本是不支持这个东西的,比如我把项目启动起来之后触发一次:

直接抛出了 NoSuchBeanDefinitionException,说明 @Async 的 value 注解并没有解析表达式的功能。

支持一波

好的,现在需求就很明确了:目前不支持,有人在社区提出该需求,想要 Spring 支持该功能。

然后这个叫 sbrannen 的哥们出来了:

他说了两句话:

  • 1.如果提供的 BeanFactory 是 ConfigurableBeanFactory,我们似乎可以通过修改 org.springframework.aop.interceptor.AsyncExecutionAspectSupport.findQualifiedExecutor(BeanFactory,String) 的代码,使用 EmbeddedValueResolver 来支持。
  • 可以看一下 org.springframework.context.annotation.CommonAnnotationBeanPostProcessor.setBeanFactory(BeanFactory),这是一个对应的例子。

第一句话中,他提到的 findQualifiedExecutor 方法,也就是需要修改的地方的代码,在我的 5.3.16 版本中是这样的:

你先记住入参中有一个 beanFactory 就行了。

而第二句话中提到的 setBeanFactory 方法,是这样的:

他说的 “for an example” 就是我框起来的部分。

这里面关键的地方有两个:

  • ConfigurableBeanFactory
  • EmbeddedValueResolver

首先 ConfigurableBeanFactory ,在 Spring 里面是一个非常重要的类,但是不是本文重点,一句话带过:你可以把它理解为是一个巨大的、功能齐全的工厂接口。

重点是 EmbeddedValueResolver 这个东西:

从注解上可以知道这个类是用来解析占位符和表达式。相当于是 Spring 给你封装好的一个工具类吧。

EmbeddedValueResolver 里面就这一个方法:

而这个方法里面调用了一个 resolveEmbeddedValue 方法:

org.springframework.beans.factory.support.AbstractBeanFactory#resolveEmbeddedValue

这个方法就是 Spring 里面解析表达式的核心代码。

我给你演示一下。

首先我们加一点代码:

这个代码不需要解释吧,已经很清晰了。

我只需要在我们前面分析的代码这里打上断点,然后把程序跑起来:

是不是很清晰了。

入参是 ${user.age} 表达式,出参是配置文件中对应的 18。

关于如何解析的所有秘密都藏在这一行代码里面:

你以为我要给你详细讲解吗?

不可能的,指个路而已,自己看去吧。

现在我要开始拐弯了,拐回到这个老哥的回复上:

现在我先带你捋一捋啊。

首先,有个老铁说:你这个 Spring 的 @Async 注解能不能支持表达式呀,比如这样式儿的 @Async("${thread-pool.name}")

然后官方出来回复说:没问题啊,我们可以修改 findQualifiedExecutor 方法,在里面使用 EmbeddedValueResolver 这个工具类来支持。比如就像是下面这个类中的 setBeanFactory 方法一样:

接着我带你去看了一下这个方法,然后知道了 EmbeddedValueResolver 的用法。

好的,那么现在问题来了:在 findQualifiedExecutor 方法中,我们怎么使用呢?

兜兜转转一大圈,现在就回到最开始的那个 issues 里面:

这个老哥说他基于 sbrannen,也就是官方人员的提示.提交了这次修改。

怎么修改的呢?

看他的 Files changed:

修改了三个文件,其中一个测试类。

剩下两个,一个是 @Async 注解:

这里面只是修改了 Javadoc,表示这个注解支持表达式的方式进行配置。

另外一个是 AsyncExecutionAspectSupport 这个类:

在 findQualifiedExecutor 方法里面加了五行代码,就完成了这个功能。

最后,官方在 review 代码的时候,又删除一行代码:

也就是 4 行代码,其实应该是 2 行核心代码,就完成了让 @Async 支持表达式的这个需求。

而且官方是先给你说了解决方案是什么,只要你稍微你跟进一下,发动你的小脑壳思考一下,我想你写出这 4 行代码也不是什么困难的事情。

这就是给 Spring 贡献源码了,而且是一个比较有价值的贡献。如果是你抓住了这个机会,你完全可以在简历上写一句:给 Spring 贡献过源码,让 @Async 注解支持表达式的配置方式。

一般来说对 Spring 了解不深入的朋友,看到这句话的时候,只会觉得很牛逼,想着应该是个大佬。

但是实际上,2 行核心代码就搞定了。

所以你说给 Spring 贡献源码这个事儿难吗?

机会总是有的,就看你有没有上心了。

什么,你问我有没有给 Spring 贡献过源码?

我没有,我就是不上心,咋的了。

这是我写这个文章想要表达的第个观点:

给开源项目贡献源码其实不是一件特别困难的事情,不要老想着一次就提交一整个功能上去。一点点改进,都是好的。

调试技巧

前面提到的代码改进, Spring 还没有发布官方的包,但是我想要自己试验一下,怎么办呢?

你当然可以把 Spring 的源码拉下来,然后自己编译一波,最后本地改改源码试一试。

但是这个过程太过复杂了,基本上可以说是一个劝退的流程。

为了这么一个小验证,完全不值当。

所以我教你一个我自己研究出来的“骚”操作。

首先,我本地的 Spring 版本是 5.3.16,对应这部分的源码是这样的:

还是先改造一下程序:

然后把程序跑起来,触发一次调用,就会停在断点的地方:

这个时候我们可以看到 qualifier 还是一个表达式的形式。

接着骚操作就来了。

你点击这个图标,对应的快捷键是 Alt+F8:

这是 ide 提供的 Evaluate Expression 功能,在这个里面是可以写代码的。

比如这样:

它还可以偷梁换柱,我在这里把 qualifier 修改为 “yyds” 字符串:

然后跑过断点,你可以从异常信息中看到,它是真的被修改了:

那么,如果我把这次提交的这 4 行代码,利用 Evaluate Expression 功能执行一下,是不是就算是模拟了对应的修改后的功能了?

我就问你:这个方法“骚”不“骚”。

接下来,我们就实操起来。

把这几行代码,填入到 Evaluate 里面:

if (beanFactory instanceof ConfigurableBeanFactory) {
 EmbeddedValueResolver embeddedValueResolver = new EmbeddedValueResolver((ConfigurableBeanFactory)beanFactory);
 qualifier = embeddedValueResolver.resolveStringValue(qualifier);
}

输入代码片段,记得点击一下这个图标:

点击执行之后是这样的:

然后看输出日志,你可以看到这样一行:

说明我的“偷梁换柱”大法成功了。

这不比你去编译一份 Spring 源代码来的方便的多?

而且这个调试的方法,相当于是你在 debug 的时候还能再额外执行一些代码,所以有的时候真的有时候能起到奇效。

这是我写这篇文章的第二个目的,想要分享给你这个调试方法。

不同之处

细心的读者肯定发现了,官方的代码有点奇怪啊:

首先 instanceof 是 Java 的保留关键字,它的作用是测试它左边的对象是否是它右边的类的实例,返回 boolean 的数据类型。

但是我记得 instanceof 不是这样用的呀?这是个什么骚操作啊?

不慌,先粘出来,放到 ide 里面看看啥情况:

我们常用的写法都是标号为 ① 那样的,当我在我的环境里面写出标号为 ② 的代码的时候,ide 给我了一个提示:

Patterns in 'instanceof' are not supported at language level '8'

大概意思是说 instanceof 的这个用法在 JDK 8 里面是不支持的。

看到这个提示的一瞬间,我突然想起了,这个写法好像是 JDK 某个高级版本之后支持的,很久之前在某个地方瞟到过一眼。

然后我用 “Patterns instanceof” 关键词查了一下,发现果然是 JDK 14 版本之后支持的一个新特性。

https://www.baeldung.com/java-pattern-matching-instanceof

我就直接把文章中的例子拿出来给你说一下。

我们用 instanceof 的时候,基本上都是需要检查对象的类型的场景,不同的类型对应不同的逻辑。

好,我问你,你使用 instanceof,在类型匹配上了之后,你的下一步操作是什么?

是不是对对象进行强制类型转换?

比如这样的:

在上述代码截图中,我们每种情况要通过 instanceof 判断 animal 的具体类型,然后强制类型转换声明为局部变量,接着根据具体的类型执行指定的函数。

这样的写法有很多缺点:

  • 这么写非常单调乏味,需要检测类型然后强制类型转换。
  • 每个 if 都要出现三次类型名。
  • 类型转换和变量声明可读性很差
  • 重复声明类型名意味着很容易出错,可能导致未预料到的运行时错误。
  • 每新增一个animal 类型就要修改这里的函数。

注意我加粗的地方,和原文是一样的,这波强调和细节是拉满了的:

为了解决上面提到的部分缺点,Java 14 提供了可以将参数类型检查和绑定局部变量类型合并到一起的 instanceof 操作。

就像这样式儿的:

首先在 if 代码块对 animal 的类型和 Cat 进行匹配。先看 animal 变量是否为 Cat 类型的实例,如果是,强转为 Cat 类型,并赋值给 cat。

需要注意的是变量名 cat 并不是一个真正存在的变量,只是模式变量的一个声明而已。你可以理解为固定语法。

变量 cat 和 dog 只有当模式匹配表达式的结果为 true 时才生效和赋值。所以如果你一不小心把变量用在别的地方,直接会提醒你编译错误。

所以你对比一下上面两个版本的代码,肯定是 Java 14 版本的代码更简洁,也更易懂。减少了大量的类型转换,而且可读性大大提高。

回到 Spring

你看,本来是看 Spring 的,怎么突然写到了 JDK 的新特性了呢?

那必然是我埋下的伏笔啊。

我给你看一个东西:

https://spring.io/blog/2021/09/02/a-java-17-and-jakarta-ee-9-baseline-for-spring-framework-6

官方在去年的 SpringOne 大会上就宣布了:Spring 6.0 和 Spring Boot 3 这两大框架的 JDK 基线版本是 17。

也就是说:我们很有可能在 JDK 8 之后,下一个要拥抱的版本是 JDK 17。

而我,作为一个技术爱好者的角度来说:这是好事,得支持,大力支持。

但是,作为一个写 CRUD 的 Java 从业者来说:想想升级之后各种兼容性问题就头疼,所以希望这个拥抱不要发生在我短暂的职业生涯中。去让那帮年轻力壮,刚刚入行的小伙子们去折腾吧。

而当我把视角局限在这篇文章的角度,电光火石之间,我又想到了一个给 Spring 贡献源码的“骚”操作。

历史代码中这么多用 instanceof 的地方,我只要在 6.0 分支里面,把这些地方都换成新特性的写法,那岂不是一个更简单的贡献源码的方式?

但是,在提交 issues 之前,一般流程都是要先去查询一下有没有类似的提交。

所以在干这事之前,我还是先冷静得查询了一下。

一查,我都笑了...

我都能想到,肯定其他人也能想到,果然有人已经捷足先登了。

比如这里:

https://github.com/spring-projects/spring-framework/issues?q=instanceof

这次对应提交的代码是这样的:

然后,官方还在里面小小的吐槽了一波:

简单来说就是:老哥,这样的小改进,就还是不要提 issue 了吧。你得整个大的啊,别只改一个类啊。

我觉得也是,你改你改一个模块也行呀,比如这位老哥,改了 Spring-beans 模块下的 8 个文件:

这样才是针对这类改动的正确姿势。

反正我把路指在这里了,你要是有兴趣,可以去看看 Spring 6.0 的代码是不是还有一些没有改的地方,你去试着提交一把。

这个话题又回到我最开始表达的第一个观点了:

给开源项目贡献源码其实不是一件特别困难的事情,不要老想着一次就提交一整个功能上去。一点点改进,都是好的。

提交的东西确实是和 Spring 框架关系不大,但是你至少能体验一下给开源项目做贡献的流程和感觉吧,而且越大的项目,流程越精细,肯定是能学到东西。

而这个过程中学到的东西,绝对比你提交一个 instanceof 改进大得多,所以你还能说这样的提交是没有什么营养的嘛?

比如我去年的一篇文章中,就提到了 Dubbo 在对响应报文进行解码的时候有一个没必要的重复操作,可以删除一行校验相关的代码。

我没有去提对应的 pr,但是我写在了文章中。

有个读者看到后,当天中午就去提交了,官方也很快入库了。

去年年底的时候 Dubbo 社区搞了一个回馈活动,就给他送了一个咖啡杯:

意外惊喜,一行代码,不仅可以学点知识,还可以免费得个咖啡杯,就问香不香。

升华一下

好了,回顾一下这篇文章。

我从 @Async 支持表达式作为引子,引到了 instanceof 的新特性,接着又引到了 Spring 6 会以 JDK 17 作为基线版本。

其实我写这篇文章的时候,脑海中一直在萦绕着一句话:大风起于青萍之末。

instanceof,是青萍之末。

大风就是 JDK 17 作为基线版本。

关于为什么要用 JDK 17 作为基线版本,其实这是风华正茂的 Java 的一次渡劫。渡劫是否成功,关系着我们每一个从业者。

在云原生的“喧哗”之下,走在前面的人已经感受到:大风已经吹起来了。

比如周志明博士在一次名为《云原生时代,Java 的危与机》中说了这样的一段话:

https://icyfenix.cn/tricks/2020/java-crisis/qcon.html

未来一段时间,是 Java 重要的转型窗口期,如果作为下一个 LTS 版的 Java 17,能够成功集 Amber、Portola、Valhalla、Loom 和 Panama 的新能力、新特性于一身,GraalVM 也能给予足够强力支持的话,那 Java 17 LTS 大概率会是一个里程碑式的版本,带领着整个 Java 生态从大规模服务端应用,向新的云原生时代软件系统转型。

可能成为比肩当年从面向嵌入式设备与浏览器 Web Applets 的 Java 1,到确立现代 Java 语言方向(Java SE/EE/ME 和 JavaCard)雏形的 Java 2 转型那样的里程碑。

但是,如果 Java 不能加速自己的发展步伐,那由强大生态所构建的护城河终究会消耗殆尽,被 Golang、Rust 这样的新生语言,以及 C、C++、C#、Python 等老对手蚕食掉很大一部分市场份额,以至被迫从“天下第一”编程语言的宝座中退位。

Java 的未来是继续向前,再攀高峰,还是由盛转衰,锋芒挫缩,你我拭目以待。

而我,还只是看到了青萍之末。

好了,那本文的技术部分就到这里啦。

下面这个环节叫做[荒腔走板],技术文章后面我偶尔会记录、分享点生活相关的事情,和技术毫无关系。我知道看起来很突兀,但是我喜欢,因为这是一个普通博主的生活气息。

你要不喜欢,退出之前记得文末点个“在看”哦。

荒腔走板

这期的荒腔走板,既然都提到了“大风起于青萍之末”,那就给大家推荐一本书吧。

《万历十五年》,以人物入手,看似人物事迹是主要内容,时代反而沦为了背景。但是细细思考之下,又会发现个人的命运在时代的背景下又是那么的渺小。

我个人把这本书的写法叫做:“大风起于青萍之末”的写法。

我的时候有些地方会感到有点生涩难懂,没有读懂的地方也没有深挖。

只是觉得当皇帝好惨啊,至少万历皇帝是这样的。自己虽然贵为天子,但是手上的权利都被文官集团所限制,被繁文缛节所限制。当自己想当个明君的时候,又被束缚的难以展开拳脚。

读到万历皇帝步行到天坛求雨的时候,我还有点沾沾自喜,因为他去求雨的时候站的回音壁的中心的那块地板砖我也去站过。

戚继光,第二次在书里看到这个名字。第一次应该是初中历史书上看见的。以前只知道戚家军多么牛逼,读了书之后才知道,是真的牛逼,而且戚继光击退的不是匈奴而是倭寇。以前只是知道这个名字,感觉是至少公元前的人物,读完才知道,原来,也就不到500年前的人。

最后一章,李贽的时候,讲到了格物致知,我一下想起了王阳明。原来,格物致知不是他提出的,他只是一个提出了观点的人,在他之前是朱熹,他们的观点大不一样。而格物致知是儒家的理论之一。

正确的顺序是格物,致知,诚意,正心,修身,齐家,治国,平天下。

书里全是知识点,翻去吧。

最后说一句(求关注)

好了,看到了这里了, 转发、在看、点赞 随便安排一个吧,要是你都安排上我也不介意。写文章很累的,需要一点正反馈。

给各位读者朋友们磕一个了:

敖丙这5年面经总结

浏览 25
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报