JDK 8 升級 17

簡介

從 JDK 8 升級到 JDK 17 的過程中，有幾個主要的變化，特別是 Java Platform Module System (JPMS) 的引入，以及一些包路徑的調整。以下是與 JDK 17 相關的一些重要變化：

• Java Platform Module System (JPMS)

  • 模塊化：JDK 9 引入了模塊系統(tǒng)，將標準 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 轉變?yōu)?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.*。

若繼續(xù)使用 Springboot2.x 的 redis 配置，會導致獲取不到 redis 的配置。

SpringBoot 3.x 整合 Querydsl

主要問題：springboot 升級 3.0，jpa 包路徑從 javax 改成 jakarta，在默認情況下，無法生存 Q 類，也沒辦法使用JPAQuery

解決方法：

• 引入依賴。重點：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>
  

• 引入 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，導致此錯誤的情況也不太一致?？赡艿脑蛑皇且驗榕渲昧?nbsp;goals，所以此處注釋掉 goals，其他情況不一定能適用此方式。

其他注意事項

• 依賴循環(huán)引用 報錯

  如果升級前的 Spring Boot 版本早于 2.6.0，且存在 spring ioc 對象的循環(huán)引用，則需要添加允許循環(huán)引用的配置，否則報錯

  spring:
    main:
      allow-circular-references: true
  

• WebMvcConfigurerAdapter.class 找不到報錯

  Spring Boot 3 基于 Spring Framework 6，而在 Spring Framework 5.3 中，WebMvcConfigurerAdapter 類已經被棄用，并在后續(xù)版本中移除。

  解決方案

  使用 WebMvcConfigurer 接口：

  WebMvcConfigurerAdapter 是一個抽象適配器類，用于實現 WebMvcConfigurer 接口。

  在 Spring Framework 6 中，可以直接實現 WebMvcConfigurer 接口來定制 Web MVC 的行為。

  創(chuàng)建自定義配置類：

  創(chuàng)建一個新的類，實現 WebMvcConfigurer 接口，并重寫需要的方法。

  @Configuration
  public class WebConfig implements WebMvcConfigurer {
      @Override
      public void addResourceHandlers(ResourceHandlerRegistry registry) {
          // 自定義資源處理
      }
      @Override
      public void configurePathMatch(PathMatchConfigurer configurer) {
          // 自定義路徑匹配
      }
      // 其他需要的方法
  }
  

• Spring Boot 3.x 支持優(yōu)雅退出，添加以下配置開啟

  # 打開優(yōu)雅退出
  server:
    shutdown: graceful
  # 多長時間后強制殺掉進程
  spring:
    lifecycle:
      timeout-per-shutdown-phase: 30s
  

maven 及 maven 插件的版本升級

maven 版本升級

為了確保 Maven 版本與 Java 17 兼容，應該使用一個較新的 Maven 版本。Java 17 是一個長期支持 (LTS) 版本，它是在 2021 年 9 月發(fā)布的。因此，應該使用 Maven 3.6.0 或更高版本來確保良好的兼容性。

以下是幾個推薦的 Maven 版本及其發(fā)布日期：

• Maven 3.6.0 - 發(fā)布于 2019 年 2 月 10 日
• Maven 3.6.3 - 發(fā)布于 2020 年 3 月 10 日
• Maven 3.8.1 - 發(fā)布于 2021 年 2 月 18 日
• Maven 3.8.5 - 發(fā)布于 2022 年 5 月 23 日

Maven 3.8.5 是一個較為推薦的版本，因為它包含了對 Java 17 的良好支持以及一些重要的安全修復和改進。

升級 Maven 版本

• 查看當前 Maven 版本:

  打開終端或命令提示符，運行以下命令來查看已安裝的 Maven 版本：

  mvn --version
  

  如果還沒有安裝 Maven，或者安裝的版本較舊，可以按照下面的步驟安裝或升級。

• 安裝或升級 Maven:

  • Windows 用戶:

    訪問 Apache Maven 官方下載頁面 下載最新的 Maven 版本。

    解壓下載的文件到一個目錄，例如 C:\apache-maven-3.8.5。

    將 Maven 的 bin 目錄添加到系統(tǒng)環(huán)境變量 PATH 中。

    設置 M2_HOME 環(huán)境變量，值為 Maven 的安裝目錄。

  • Linux/macOS 用戶:

    使用包管理器安裝 Maven，例如對于 Ubuntu/Debian 使用 apt-get，對于 macOS 使用 brew：

    sudo apt update && sudo apt install maven
    

    或者使用 Homebrew：

    brew install maven
    

    或者從 Apache Maven 官網下載二進制分發(fā)包，解壓縮到 /usr/local 或其他位置，并通過 mvn --version 確認安裝成功。

• 設置 Java 17 作為默認 JDK:

  • Windows 用戶:

    確保安裝了 Java 17，并將其路徑添加到環(huán)境變量 JAVA_HOME 中。

    設置 JAVA_HOME 環(huán)境變量指向 Java 17 的安裝目錄。

  • Linux/macOS 用戶:

    安裝 Java 17，例如使用 sdkman 或者直接從 Oracle 或 Adoptium 下載。

    設置 JAVA_HOME 環(huán)境變量指向 Java 17 的安裝目錄。

    確保 JAVA_HOME 和 PATH 環(huán)境變量被正確設置。

• 驗證 Maven 和 Java 版本:

  再次運行 mvn --version 命令，確保顯示的 Java 版本為 17，并且 Maven 版本為 3.8.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 的最新穩(wěn)定版本是 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，請查閱官方文檔或發(fā)布頁面以確認版本的兼容性。`

總結 

到此這篇關于關于JDK8升級17及springboot 2.x升級3.x的文章就介紹到這了,更多相關JDK8升級17及springboot2.x升級3.x內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

最新評論