JDK 8 升级 17 及 springboot 2.x 升级 3.x 指南

JDK 8 升级 17

简介

从 JDK 8 升级到 JDK 17 的过程中,有几个主要的变化,特别是 Java Platform Module System (JPMS) 的引入,以及一些包路径的调整。以下是与 JDK 17 相关的一些重要变化:

  • Java Platform Module System (JPMS)

    • 模块化:JDK 9 引入了模块系统,将标准 Java 库划分为多个模块。这影响了 JDK 17 中的包结构和类的组织方式。
    • 模块路径:JDK 11 引入了 --module-path--add-modules 选项,允许用户指定模块路径和加载特定模块。
  • Java EE APIs 移除

    • JAX-RSjavax.ws.rs.* 包现在不在标准 Java SE 平台上。
    • JAX-WSjavax.xml.ws.* 包现在不在标准 Java SE 平台上。
    • JAX-Bjavax.xml.bind.* 包现在不在标准 Java SE 平台上。
  • 其他变化

    • JavaFX:JavaFX 已经从标准 Java SE 平台中移除,现在作为一个独立的模块存在。

      如果应用使用了 JavaFX,确保已经添加了 JavaFX 模块到应用中

    • JSR 355:JSR 355 定义了一些与 JavaFX 相关的包,这些包也不再包含在标准 Java SE 平台上。

  • JDK 17 中的新特性

    • JEP 391: Foreign Function & Memory API (Incubator):提供了与外部代码和内存交互的能力。
    • JEP 403: Sealed Classes:允许类声明为密封,以限制继承。
    • JEP 404: Pattern Matching for switch (Preview):引入了模式匹配支持到 switch 语句中。
    • JEP 414: Vector API (Fourth Incubator):提供了一种利用向量硬件指令的途径。

javax.* 包移到 jakarta.*

  • Jakarta EE 技术栈:随着 Java EE 转变为 Jakarta EE,许多 javax.* 包已经被迁移到 jakarta.*包下。这对于使用 Java Persistence API (JPA)、JSF、EJB 等技术的应用尤为重要。

    • javax.persistence.* -> jakarta.persistence.*
    • javax.faces.* -> jakarta.faces.*
    • javax.ejb.* -> jakarta.ejb.*
    • javax.servlet.* -> jakarta.servlet.*
    • javax.servlet.jsp.* -> jakarta.servlet.jsp.*
    • javax.websocket.* -> jakarta.websocket.*
    • javax.naming.* -> jakarta.naming.*
    • javax.sql.* -> jakarta.sql.*
    • javax.transaction.* -> jakarta.transaction.*

    JDK 8 升级到 JDK 17 需确保代码中引用了正确的包名。应该使用 jakarta.* 而不是 javax.*


maven pom 中更新 java 版本

  • 建议在父项目添加全局变量 java.version,然后在 maven-compiler-plugin 引用

    <properties>
        <java.version>17</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    </properties>
    
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.10.1</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
        </plugins>
    </build>
    

springboot 2.x 升级 3.x

spring-boot 与 cloud、alibaba-cloud 的版本对应


redis 默认配置调整

在 Springboot 2.x 的版本中,redis 的默认配置是 spring.redis.*,升级成 Springboot 3.x 以后,redis 的默认配置调整为了spring.data.redis.*

若继续使用 Springboot2.x 的 redis 配置,会导致获取不到 redis 的配置。


SpringBoot 3.x 整合 Querydsl

主要问题:springboot 升级 3.0,jpa 包路径从 javax 改成 jakarta,在默认情况下,无法生存 Q 类,也没办法使用JPAQuery

解决方法

  1. 引入依赖。重点:classifier 标签

    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-jpa</artifactId>
        <classifier>jakarta</classifier>
        <version>5.0.0</version>
    </dependency>
    
    <dependency>
        <groupId>com.querydsl</groupId>
        <artifactId>querydsl-apt</artifactId>
        <version>5.0.0</version>
        <scope>provided</scope>
        <optional>true</optional>
        <classifier>jakarta</classifier>
    </dependency>
    
  2. 引入 maven plugin

     <plugin>
        <groupId>com.mysema.maven</groupId>
        <artifactId>apt-maven-plugin</artifactId>
        <version>1.1.3</version>
        <executions>
            <execution>
    		<!--<goals>-->
    		<!--	<goal>process</goal>-->
    		<!--</goals>-->
                <configuration>
                    <outputDirectory>target/generated-sources</outputDirectory>
                    <processor>com.querydsl.apt.jpa.JPAAnnotationProcessor</processor>
                </configuration>
            </execution>
        </executions>
    </plugin>
    
    

    注意:每个项目配置可能会有差别,在编译时可能会报错:Attempt to recreate a file for type xxx,导致此错误的情况也不太一致。可能的原因之一是因为配置了 goals,所以此处注释掉 goals,其他情况不一定能适用此方式。


其他注意事项

  • 依赖循环引用 报错

    如果升级前的 Spring Boot 版本早于 2.6.0,且存在 spring ioc 对象的循环引用,则需要添加允许循环引用的配置,否则报错

    spring:
      main:
        allow-circular-references: true
    
  • WebMvcConfigurerAdapter.class 找不到报错

    Spring Boot 3 基于 Spring Framework 6,而在 Spring Framework 5.3 中,WebMvcConfigurerAdapter 类已经被弃用,并在后续版本中移除。

    解决方案

    1. 使用 WebMvcConfigurer 接口

      WebMvcConfigurerAdapter 是一个抽象适配器类,用于实现 WebMvcConfigurer 接口。

      在 Spring Framework 6 中,可以直接实现 WebMvcConfigurer 接口来定制 Web MVC 的行为。

    2. 创建自定义配置类

      创建一个新的类,实现 WebMvcConfigurer 接口,并重写需要的方法。

      @Configuration
      public class WebConfig implements WebMvcConfigurer {
          @Override
          public void addResourceHandlers(ResourceHandlerRegistry registry) {
              // 自定义资源处理
          }
          @Override
          public void configurePathMatch(PathMatchConfigurer configurer) {
              // 自定义路径匹配
          }
          // 其他需要的方法
      }
      
  • Spring Boot 3.x 支持优雅退出,添加以下配置开启

    # 打开优雅退出
    server:
      shutdown: graceful
    # 多长时间后强制杀掉进程
    spring:
      lifecycle:
        timeout-per-shutdown-phase: 30s
    

maven 及 maven 插件的版本升级

maven 版本升级

为了确保 Maven 版本与 Java 17 兼容,应该使用一个较新的 Maven 版本。Java 17 是一个长期支持 (LTS) 版本,它是在 2021 年 9 月发布的。因此,应该使用 Maven 3.6.0 或更高版本来确保良好的兼容性。

以下是几个推荐的 Maven 版本及其发布日期:

  • Maven 3.6.0 - 发布于 2019 年 2 月 10 日
  • Maven 3.6.3 - 发布于 2020 年 3 月 10 日
  • Maven 3.8.1 - 发布于 2021 年 2 月 18 日
  • Maven 3.8.5 - 发布于 2022 年 5 月 23 日

Maven 3.8.5 是一个较为推荐的版本,因为它包含了对 Java 17 的良好支持以及一些重要的安全修复和改进。


升级 Maven 版本

  1. 查看当前 Maven 版本:

    打开终端或命令提示符,运行以下命令来查看已安装的 Maven 版本:

    mvn --version
    

    如果还没有安装 Maven,或者安装的版本较旧,可以按照下面的步骤安装或升级。

  2. 安装或升级 Maven:

    • Windows 用户:

      1. 访问 Apache Maven 官方下载页面 下载最新的 Maven 版本。
      2. 解压下载的文件到一个目录,例如 C:\apache-maven-3.8.5
      3. 将 Maven 的 bin 目录添加到系统环境变量 PATH 中。
      4. 设置 M2_HOME 环境变量,值为 Maven 的安装目录。
    • Linux/macOS 用户:

      1. 使用包管理器安装 Maven,例如对于 Ubuntu/Debian 使用 apt-get,对于 macOS 使用 brew

        sudo apt update && sudo apt install maven
        

        或者使用 Homebrew:

        brew install maven
        
      2. 或者从 Apache Maven 官网下载二进制分发包,解压缩到 /usr/local 或其他位置,并通过 mvn --version 确认安装成功。

  3. 设置 Java 17 作为默认 JDK:

    • Windows 用户:
      1. 确保安装了 Java 17,并将其路径添加到环境变量 JAVA_HOME 中。
      2. 设置 JAVA_HOME 环境变量指向 Java 17 的安装目录。
    • Linux/macOS 用户:
      1. 安装 Java 17,例如使用 sdkman 或者直接从 Oracle 或 Adoptium 下载。
      2. 设置 JAVA_HOME 环境变量指向 Java 17 的安装目录。
      3. 确保 JAVA_HOMEPATH 环境变量被正确设置。
  4. 验证 Maven 和 Java 版本:

    再次运行 mvn --version 命令,确保显示的 Java 版本为 17,并且 Maven 版本为 3.8.5 或更高。

  5. 配置 Maven 以使用 Java 17:

    pom.xml 文件中指定 Java 17 编译和源代码版本,详见 maven-compiler-plugin 版本升级


maven-compiler-plugin 版本升级

  • 为了确保 Maven 编译插件 (maven-compiler-plugin) 与 Java 17 兼容并支持 Spring Boot 3 的需求,需要选择一个合适的 maven-compiler-plugin 版本。

    截至2023年,maven-compiler-plugin 的最新稳定版本是 3.10.1。该版本与 Java 17 兼容,并且适用于 Spring Boot 3。

  • 下面是 maven-compiler-plugin 的一个示例配置,用于确保使用 Java 17 进行编译:

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.10.1</version>
                <configuration>
                    <source>17</source>
                    <target>17</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
    

    这里的关键配置点包括:

    • <source><target> 都设置为 17,以指示使用 Java 17 进行编译。
    • <version> 设置为 3.10.1,这是与 Java 17 兼容的一个版本。

    **请注意,需要根据实际的 Maven 和 Spring Boot 版本进行适当的调整。**如果需要使用特定版本的 maven-compiler-plugin,请查阅官方文档或发布页面以确认版本的兼容性。`

评论 201
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

墨鸦_Cormorant

大家喜欢的话可以点个关注投币哟

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值