从JDK8升级到JDK11,看这篇就足够了
【从JDK8升级到JDK11,看这篇就足够了】原文地址:https://blog.codefx.org/java/java-11-migration-guide/。 在原文的基础上,增加了一些我遇到的具体的坑还有在特定场景下的解决方案,供大家参考一些背景 在背景知识,我们会讨论一些关于新的JDK Release周期,OpenJDK特性归一化,LTS(Long-term support长期支持版本)的事情。
1. 新的发布周期 这个就可以长话短说了,反正我们知道如下两点就好:
- 每六个月发布一个大更新(就是每年的3月还有9月)
- 对于每个大版本更新,会有两次小版本更新(在发布后一个月或者四个月之后)
我们可以在线上使用OpenJDK,开发时,使用任意的JDK。
3. LTS(Long-term support长期维护)版本 对于商业版的JDK,不同的厂商都将长期维护版本定在JDK 11/17/23/...
对于OpenJDK,社区说,对于这些版本,至少会提供四年的维护更新时间。每个长期维护版本都会有一个固定的管理者,对于OpenJDK11,应该就是红帽社区。现在源代码搞定了,但是,我们应该从哪里获取编译好的OpenJDK呢?这个可以交给AdoptOpenJDK,它会一直收集不同版本的OpenJDK以及全平台的build好的OpenJDK
4. Amazon Corretto AWS也提供了自己的OpenJDK,Amazon Corretto:
- 基于OpenJDK,采取GPL+CE协议,做了一些安全性,性能和稳定性优化,并且修复了一些bug
- 支持linux,MAC OS还有Windows操作系统
- 长期支持Java 8并且至少到2023年
- 从2019年开始支持Java 11并且至少到2024
- 季度更新,并且伴随一些紧急bug修复的更新
准备迁移 1. 更新好开发环境以及编译环境 各种常用工具,建议升级到如下版本以后:
- IntelliJ IDEA: 2018.2
- Eclipse: Photon 4.9RC2 with Java 11 plugin
- Maven: 3.5.0
- Maven compiler plugin: 3.8.0
- surefire and failsafe: 2.22.0
- Gradle: 5.0
- FindBugs(静态代码bug发现): 用SpotBugs替换。
- Cobertura(代码测试覆盖率):用Jacoco替换
- 对于直接操作字节码的库,如果你升级了JDK,那么最好也跟着升级这些库:ASM (7.0), Byte Buddy (1.9.0), cglib (3.2.8), or Javassist (3.23.1-GA).这些版本是OpenJDK11适用的版本
- 如果你使用的库依赖了上面提到的操作字节码的库,那么也需要注意下版本依赖,看依赖的操作字节码的库是否升级到了上面提到的版本。对于Spring,最好采用5.1以后的版本, Mockito则是2.20.0以后的版本
如果你的项目中使用了这些类,那么在编译阶段就会报错,例如:
error: package javax.xml.bind does not exist
import javax.xml.bind.JAXBException;
^
如果你是用JDK 8编译成功,拿到JDK 11运行,就会报错:
Exception in thread "main" java.lang.NoClassDefFoundError: javax/xml/bind/JAXBException
at monitor.Main.main(Main.java:27)
Caused by: java.lang.ClassNotFoundException: javax.xml.bind.JAXBException
at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:582)
at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:185)
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:496)
... 1 more
以下是相关移除列表还有解决方案
- JavaBeans Activation Framework (JAF) (javax.activation)变成了一个独立的框架,maven依赖:
com.sun.activation
javax.activation
1.2.0
- CORBA(java.corba)在JEP 230已经不复存在了,在你的项目中如果遇到,证明你的项目太古老了。移除掉吧
- JTA (java.transaction)变成了独立依赖:
javax.transaction
javax.transaction-api
1.2
- JAXB和JAX-WS:
javax.xml.bind
jaxb-api
2.2.8
com.sun.xml.bind
jaxb-core
2.2.8
com.sun.xml.bind
jaxb-impl
2.2.8
com.sun.xml.ws
jaxws-ri
2.3.0
pom
- Common Annotations:
javax.annotation
javax.annotation-api
1.3.1
一个建议就是,在你的项目中如果没有冲突,建议都加上这些依赖。
2.2. 模块可见性导致的内部API不能调用的问题
这个在我另一篇文章也说过:https://zhanghaoxin.blog.csdn.net/article/details/90514045
在Java9之后引入了模块化的概念,是将类型和资源封装在模块中,并仅导出其他模块要访问其公共类型的软件包。如果模块中的软件包未导出或打开,则表示模块的设计人员无意在模块外部使用这些软件包。 这样的包可能会被修改或甚至从模块中删除,无需任何通知。 如果仍然使用这些软件包通过使用命令行选项导出或打开它们,可能会面临破坏应用程序的风险!
对于这种限制,在编译阶段,可能会有类似下面的报错:
error: package com.sun.imageio.plugins.jpeg is not visible
import com.sun.imageio.plugins.jpeg.JPEG;
^
(package com.sun.imageio.plugins.jpeg is declared
in module java.desktop, which does not export it)
如果是反射的调用,可能在运行阶段有类似于如下的报警:
WARNING: An illegal reflective access operation has occurred
WARNING: Illegal reflective access by j9ms.internal.JPEG
(file:...) to field com.sun.imageio.plugins.jpeg.JPEG.TEM
WARNING: Please consider reporting this
to the maintainers of j9ms.internal.JPEG
WARNING: Use --illegal-access=warn to enable warnings
of further illegal reflective access operations
WARNING: All illegal access operations will be denied in a future release
# here's the reflective access to the static field com.sun.imageio.plugins.jpeg.JPEG.TEM
对于这种错误,我们最好是更换API,如果难以实现,则可以通过添加编译以及启动参数解决。
我们需要的参数是:
-
--add-exports
选项:模块声明中的exports语句将模块中的包导出到所有或其他模块,因此这些模块可以使用该包中的公共API。 如果程序包未由模块导出,则可以使用-add-exports
的命令行选项导出程序包:
--add-exports /=
如果设置target-module-list为ALL-UNNAMED,那么所有Classpath下的module,都可以访问source-module中的pakage包下的公共API
-
--add-opens
选项: 模块声明中的opens语句使模块里面的包对其他模块开放,因此这些模块可以在运行期使用深层反射访问该程序包中的所有成员类型。 如果一个模块的包未打开,可以使用--add-opens命令行选项打开它。 其语法如下:
--add-opens /=
如果设置target-module-list为ALL-UNNAMED,那么所有Classpath下的module,都可以访问source-module中的pakage包下的所有成员类型
对于编译阶段,也就是javac命令,我们只需要添加
--add-exports
,对于上面的例子,就是:javac --add-exports java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED
对于运行阶段,也就是java命令,我们最好把
--add-exports
和--add-open
都加上,对于上面的例子,就是:java --add-exports java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED --add-open java.desktop/com.sun.imageio.plugins.jpeg=ALL-UNNAMED
这样,在运行阶段,首先不会有禁止访问报错,同时也不会有警告。
同时,为了在运行期能找到所有需要添加的模块和包,可以通过添加
--illegal-access=${value}
来检查。这个value可以填写:- permit: 未来可能会移除。仅在第一次反射调用内部api的时候报警
- warn:每次次反射调用内部api的时候报警
- debug:在warn的基础上,加上堆栈输出
- deny: 拒绝所有非法反射访问内部api
--illegal-access=deny
来知道我们需要添加的所有--add-export
和--add-open
包。2.3 通过JDK11内置jdeps工具查找过期以及废弃API以及对应的替换
这个也在我另一篇文章提到过:
https://zhanghaoxin.blog.csdn.net/article/details/100732605
jdeps --jdk-internals -R --class-path 'libs/*' $project
libs是你的所有依赖的目录,$project是你的项目jar包,示例输出:
...
JDK Internal APISuggested Replacement
-------------------------------------
sun.misc.BASE64EncoderUse java.util.Base64 @since 1.8
sun.reflect.ReflectionUse java.lang.StackWalker @since 9
在这里简单提一些在JDK11过期,但是JDK8使用的API:
- sun.misc.Base64 (替换成 java.util.Base64)
- com.sun.java.swing.plaf.nimbus.NimbusLookAndFeel (替换成 javax.swing.plaf.nimbus.NimbusLookAndFeel)
- java.util.LogManager, java.util.jar.Pack200.Packer类 Unpacker: addPropertyChangeListener 和 removePropertyChangeListener这两个方法已经移除
- java.lang.Runtime类: methods getLocalizedInputStream 和 getLocalizedOutputStream方法已经移除
- SecurityManager的操作方法已经整体移除
Java 8的ClassLoader流程:
- bootstrap classloader加载rt.jar,jre/lib/endorsed
- ext classloader加载jre/lib/ext
- application classloader加载-cp指定的类
- bootstrap classloader加载lib/modules
- ext classloader更名为platform classloader,加载lib/modules
- application classloader加载-cp,-mp指定的类
一般热部署,插件部署,都会使用到
AppClassLoader
,例如Spring-Boot的热部署,老版本的会报异常:Exception in thread "main" java.lang.ClassCastException: java.base/jdk.internal.loader.ClassLoaders$AppClassLoader cannot be cast to java.base/java.net.URLClassLoader
at org.springframework.boot.devtools.restart.DefaultRestartInitializer.getUrls(DefaultRestartInitializer.java:93)
at org.springframework.boot.devtools.restart.DefaultRestartInitializer.getInitialUrls(DefaultRestartInitializer.java:56)
at org.springframework.boot.devtools.restart.Restarter.(Restarter.java:140)
at org.springframework.boot.devtools.restart.Restarter.initialize(Restarter.java:546)
at org.springframework.boot.devtools.restart.RestartApplicationListener.onApplicationStartingEvent(RestartApplicationListener.java:67)
at org.springframework.boot.devtools.restart.RestartApplicationListener.onApplicationEvent(RestartApplicationListener.java:45)
at org.springframework.context.event.SimpleApplicationEventMulticaster.doInvokeListener(SimpleApplicationEventMulticaster.java:172)
at org.springframework.context.event.SimpleApplicationEventMulticaster.invokeListener(SimpleApplicationEventMulticaster.java:165)
at org.springframework.context.event.SimpleApplicationEventMulticaster.multicastEvent(SimpleApplicationEventMulticaster.java:139)
at org.springframework.context.event.SimpleApplicationEventMulticaster.multicastEvent(SimpleApplicationEventMulticaster.java:122)
at org.springframework.boot.context.event.EventPublishingRunListener.starting(EventPublishingRunListener.java:69)
at org.springframework.boot.SpringApplicationRunListeners.starting(SpringApplicationRunListeners.java:48)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:292)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1118)
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1107)
at com.asofdate.AsofdateMain.main(AsofdateMain.java:18)
这是主要是因为AppClassLoader不再是URLClassLoader的子类导致的。
之前对于动态加载的类,我们总是通过将这个类通过反射调用URLClassLoader加到classpath里面进行加载。这么加载在JDK11中已经无法实现,并且这样加载的类不能卸载。
对于动态加载的类,我们在OpenJDK11中只能自定义类加载器去加载,而不是通过获取APPClassLoader去加载。同时,这么做也有助于你随时能将动态加载的类卸载,因为并没有加载到APPClassLoader。
建议使用自定义的类加载器继承
SecureClassLoader
去加载类:java.security.SecureClassLoader
最后,如果你想访问classpath下的内容,你可以读取环境变量:
String pathSeparator = System
.getProperty("path.separator");
String[] classPathEntries = System
.getProperty("java.class.path")
.split(pathSeparator);
2.5. 过期启动参数修改
JDK 8 到JDK 11有很多参数变化,可以总结为两类参数的变化,一是GC相关的(GC配置调优更加简单),二是日志相关的,日志统一到了一起,不像之前那么混乱
具体请参考:
- https://docs.oracle.com/en/java/javase/11/tools/java.html#GUID-4856361B-8BFD-4964-AE84-121F5F6CF111
- https://docs.oracle.com/javase/9/tools/java.htm#JSWOR-GUID-4856361B-8BFD-4964-AE84-121F5F6CF111
- https://docs.oracle.com/javase/10/tools/java.htm#GUID-3B1CE181-CD30-4178-9602-230B800D4FAE__REMOVEDJAVAOPTIONS-A4E6F213
- Obsolete Java Options: 参数可以被接受但是忽略掉了,但是会有警告,一般这种参数有替代写法,请用替代的写法
- Deprecated Java Options: 参数可以被接受并有效,但是会有警告,一般这种参数有替代写法,请用替代的写法
- Removed Java Options: 参数被移除,并且使用的话会有报错
- OpenJDK11与Spring Cloud Finchley的不兼容问题与解决: https://blog.csdn.net/zhxdick/article/details/102314886
- Lombok编译异常: 升级到1.18.+的版本才可以
- Spring Cloud Hystrix ThreadPool的bug:https://zhanghaoxin.blog.csdn.net/article/details/103299527
推荐阅读
- Docker应用:容器间通信与Mariadb数据库主从复制
- 一个人的碎碎念
- 我从来不做坏事
- jhipster|jhipster 升级无效问题
- 从蓦然回首到花开在眼前,都是为了更好的明天。
- 西湖游
- 改变自己,先从自我反思开始
- leetcode|leetcode 92. 反转链表 II
- 从我的第一张健身卡谈传统健身房
- 自媒体形势分析