当前位置： 首页 > news >正文

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

news 来源：原创 2024/9/19 10:03:18

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-RS：javax.ws.rs.* 包现在不在标准 Java SE 平台上。
    • JAX-WS：javax.xml.ws.* 包现在不在标准 Java SE 平台上。
    • JAX-B：javax.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 的版本对应

  • spring-cloud 与 spring-boot 的版本对应详见 spring-cloud 官方文档

    在这里插入图片描述

  • spring-alibaba-cloud 与 spring-cloud、spring-boot 的版本对应详见 spring-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 {@Overridepublic void addResourceHandlers(ResourceHandlerRegistry registry) {// 自定义资源处理}@Overridepublic 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_HOME 和 PATH 环境变量被正确设置。

  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，请查阅官方文档或发布页面以确认版本的兼容性。`

相关文章：

  • 北京网站建设多少钱？
  • 辽宁网页制作哪家好_网站建设
  • 高端品牌网站建设_汉中网站制作
  • C语言 柔性数组 详解
  • 锅总详解开源组织之ASF
  • Fiddler学习笔记
  • 基于java的人居环境整治管理系统（源码+lw+部署文档+讲解等)
  • 公布一批神马爬虫IP地址，真实采集数据
  • 防止xss（跨站脚本攻击）
  • golang中struct的tag -简记
  • 枚举知识点（完结）
  • 从零开始学习机器学习，掌握AI未来的关键！
  • 嵌入式人工智能（40-基于树莓派4B的水滴传感器和火焰传感器）
  • c语言（8.1）
  • 二进制搭建 Kubernetes v1.20（中）
  • 【优秀python案例】基于Python的豆瓣电影TOP250爬虫与可视化设计与实现
  • Flutter 初识：数据表格和卡片
  • 介绍Servlet后端中两种接收参数方式req.getAttributer和req.getParameter的区别
  • 「面试题」如何实现一个圣杯布局？
  • 【391天】每日项目总结系列128（2018.03.03）
  • C语言笔记（第一章：C语言编程）
  • echarts的各种常用效果展示
  • go append函数以及写入
  • laravel5.5 视图共享数据
  • Netty 4.1 源代码学习：线程模型
  • Redis学习笔记 - pipline（流水线、管道）
  • Webpack 4 学习01（基础配置）
  • Web设计流程优化：网页效果图设计新思路
  • 阿里云应用高可用服务公测发布
  • 得到一个数组中任意X个元素的所有组合 即C(n,m)
  • 基于Android乐音识别(2)
  • 开年巨制！千人千面回放技术让你“看到”Flutter用户侧问题
  • 前端技术周刊 2019-02-11 Serverless
  • 日剧·日综资源集合（建议收藏）
  • 没有任何编程基础可以直接学习python语言吗？学会后能够做什么？ ...
  • ​Java基础复习笔记 第16章：网络编程
  • ​批处理文件中的errorlevel用法
  • ​软考-高级-信息系统项目管理师教程 第四版【第23章-组织通用管理-思维导图】​
  • ​探讨元宇宙和VR虚拟现实之间的区别​
  • ​虚拟化系列介绍（十）
  • （2）空速传感器
  • （Oracle）SQL优化基础（三）：看懂执行计划顺序
  • (zt)基于Facebook和Flash平台的应用架构解析
  • （二）linux使用docker容器运行mysql
  • (过滤器)Filter和(监听器)listener
  • （九）c52学习之旅-定时器
  • (十五)使用Nexus创建Maven私服
  • (收藏）Git和Repo扫盲——如何取得Android源代码
  • (原創) 未来三学期想要修的课 (日記)
  • .NET Conf 2023 回顾 – 庆祝社区、创新和 .NET 8 的发布
  • .net 获取url的方法
  • .Net 中Partitioner static与dynamic的性能对比
  • .NET使用存储过程实现对数据库的增删改查
  • @test注解_Spring 自定义注解你了解过吗？
  • [.NET 即时通信SignalR] 认识SignalR (一)
  • [1525]字符统计2 (哈希)SDUT
  • [20150904]exp slow.txt
  • [acm算法学习] 后缀数组SA