1.查找springboot3官方要求
这里查的是springboot 3.2.6版本的
2.升级jdk到17
Java EE 8之后,Oracle在19年把javax捐给了eclipse基会,但不允许使用javax的命名空间,所以eclipse才发展成为现在的Jakarta ee标准。Springboot3后使用Jakarta api,要求servlet6.0及以上,javax*的接口都无法使用报红。
所以依赖加入以下包:
<dependency>
<groupId>jakarta.annotation</groupId>
<artifactId>jakarta.annotation-api</artifactId>
<version>2.1.1</version>
</dependency>
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.30</version>
</dependency>
<dependency>
<groupId>jakarta.servlet</groupId>
<artifactId>jakarta.servlet-api</artifactId>
<version>6.0.0</version>
</dependency>
代码中:
所有resouce替换成import jakarta.annotation.Resource;
所有PostConstruct替换成import jakarta.annotation.PostConstruct;
所有servlet、filter相关javax的都需要重新导成jakarta下的包。
Base64修改:
BASE64Encoder encoder = new BASE64Encoder();
return encoder.encode(data);
改为:
Base64.Encoder encoder = Base64.getEncoder();
return encoder.encodeToString(data);
3.springboot升级
3.1 版本引入
参考Using the Plugin :: Spring Boot
3.2 相关包升级
之前所有的spring相关包版本升级到对应的6.1.6
groovy-all也需要升级:
<dependency>
<groupId>org.codehaus.groovy</groupId>
<artifactId>groovy-all</artifactId>
<version>3.0.7</version>
</dependency>
这里有个坑,大家需要注意,如果你没使用spring的parent,升级到了3.2.5。需要在pom maven-compiler-plugin中加入parameters,否则参数地址都是访问不了。这是因为LocalVariableTableParameterNameDiscoverer已在 6.1 中删除。因此,Spring 框架和 Spring 组合框架中的代码不再尝试通过解析字节码来推断参数名称。如果您遇到依赖项注入、属性绑定、SpEL 表达式或其他依赖于参数名称的用例的问题,则应使用通用 Java 8+ 标志-parameters来保留参数名称来编译 Java 源代码(而不是依赖于-debug编译器)标志)以便与StandardReflectionParameterNameDiscoverer. Groovy 编译器还支持-parameters用于相同目的的标志。对于 Kotlin 编译器,请使用该-java-parameters标志。
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>${maven_compiler_plugin_version}</artifactId>
<version>3.11.0</version>
<configuration>
<parameters>true</parameters>
<source>17</source>
<target>17</target>
<compilerArgs>
<arg>-Xlint:deprecation</arg>
<arg>-Xlint:options</arg>
<arg>-Xlint:path</arg>
<arg>-Xlint:unchecked</arg>
</compilerArgs>
<forceJavacCompilerUse>true</forceJavacCompilerUse>
</configuration>
</plugin>
3.3 升级后编译问题
HandlerInterceptorAdapter在springboot3中已经移除,所有Interceptor原来继承HandlerInterceptorAdapter,都改为实现HandlerInterceptor接口。
3.4 web.xml转换
springboot没有web.xml配置,需要把web.xml中监听器、过滤器、servlet等转换为springboot configBean形式。
3.5 如果原有工程有循环依赖启用循环依赖
springboot2.6禁用了循环依赖,如果代码工程中有,需要开启,yml配置:
spring:
main:
#springboot从2.6之后默认禁用了循环依赖,由于项目中有循坏依赖,故开启
allow-circular-references: true