1. 前言

最近一直想把我的開(kāi)源項(xiàng)目maple-boot升級(jí)到j(luò)dk17版本，然后接入Spring AI。拖延癥犯了一直拖拖拖，最近時(shí)間空閑較多，開(kāi)始陸續(xù)著手升級(jí)。

整個(gè)升級(jí)過(guò)程 計(jì)劃分為3步。

• step1：先將項(xiàng)目升級(jí)到j(luò)dk17，使用正常
• step2：生成代碼的模板類升級(jí)到Jdk17對(duì)應(yīng)的版本
• step3：功能陸續(xù)驗(yàn)證

本文主要記錄step1將項(xiàng)目升級(jí)過(guò)程中牽扯到依賴變動(dòng)升級(jí)，當(dāng)然項(xiàng)目用到的依賴并不算多，項(xiàng)目之外的這里不做記錄。

2. 準(zhǔn)備環(huán)境

原項(xiàng)目版本：Jdk8 + springboot 2.7.12

升級(jí)后版本：Jdk17 + springboot 3.3.9

這里新建一個(gè)maple-boot-17的項(xiàng)目，然后將maple-boot下[base-manage]分支的代碼原封不動(dòng)的復(fù)制進(jìn)來(lái)。

接下來(lái)開(kāi)始修改。

3. 版本升級(jí)

3.1 基礎(chǔ)依賴升級(jí)

1.首先把項(xiàng)目環(huán)境切換到Jdk17上

2.父級(jí)pom文件中spring-boot-starter-parent版本升級(jí)到3.3.9

3.項(xiàng)目配置中的java.version由8升級(jí)到17

4.maven編譯相關(guān)maven.compiler.source、maven.compiler.target由8升到17

5.由于在jdk17中移除了javax的部分包，所以很多javax.xxx都需要修改jakarta.xxx

這里主要包含：

(1) javax.servlet

(2) javax.annotation

其它javax.net,javax.sql等則繼續(xù)保留著。

6.lombok版本由1.16.18 升級(jí) 1.18.30

3.2 相關(guān)組件升級(jí)

1.redis相關(guān)

? yml文件配置由spring.redis 變?yōu)?code>spring.data.redis，多了一級(jí)data

2.mybatis plus相關(guān)

• mybatis plus版本升級(jí)，由3.5.2升級(jí)到3.5.9，pom依賴artifactId由mybatis-plus-boot-starter變?yōu)?code>mybatis-plus-spring-boot3-starter
• 分頁(yè)插件剝離，新增分頁(yè)依賴com.baomidou:mybatis-plus-jsqlparser
• 多數(shù)據(jù)源依賴升級(jí)，由3.5.2升級(jí)為4.0.0，pom依賴artifactId由dynamic-datasource-spring-boot-starter變?yōu)?code>dynamic-datasource-spring-boot3-starter
• TODO：生成工具暫未調(diào)整，不確定是否有變化

3.對(duì)象轉(zhuǎn)化工具dozer版本升級(jí)，由6.2.0升級(jí)至7.0.0

4.httpclient版本升級(jí)，升級(jí)至4.5.14

5.接口文檔knife4j升級(jí)

由com.github.xiaoymin:knife4j-spring-boot-starter:2.0.7變更為com.github.xiaoymin:knife4j-openapi3-jakarta-spring-boot-starter:4.0.0，Knife4jConfiguration配置類變更

package com.maple.rest.config;

import io.swagger.v3.oas.annotations.OpenAPIDefinition;
import io.swagger.v3.oas.annotations.info.Info;
import io.swagger.v3.oas.annotations.servers.Server;
import org.springframework.context.annotation.Configuration;

/**
 * @author 笑小楓-https://www.xiaoxiaofeng.com
 * @date 2022/6/28
 */
@Configuration
@OpenAPIDefinition(
        info = @Info(title = "笑小楓管理平臺(tái)接口",
                description = "管理平臺(tái) API 文檔",
                version = "1.0"),
        servers = @Server(url = "https://www.xiaoxiaofeng.site/api/")
)
public class Knife4jConfiguration {

}

注解變更

更多的變動(dòng)可以參考官網(wǎng)，這里暫時(shí)沒(méi)有做進(jìn)一步深究

4. 功能測(cè)試

大體試了下，功能都還健在，后續(xù)整理生成工具時(shí)，會(huì)陸續(xù)測(cè)試功能細(xì)節(jié)。

5. 升級(jí)總結(jié)

本次項(xiàng)目版本依賴升級(jí)大致如下，可能有一些沒(méi)有記錄到。

6. 注意事項(xiàng)

1.JDK版本與Spring Boot版本對(duì)應(yīng)

Spring Boot不同版本支持的JDK版本如下：

2.Maven版本與Spring Boot版本對(duì)應(yīng)

Maven作為構(gòu)建工具，與Spring Boot的兼容性如下：

3.我用的idea 2021.3款的，不支持過(guò)高的maven版本，我這里使用的是maven 3.8.1。條件允許建議可以換更高版本的idea，感覺(jué)2024版的使用起來(lái)也更絲滑…

7.小結(jié)

升級(jí)過(guò)程中，程序可能會(huì)出現(xiàn)各種各式報(bào)錯(cuò)，牽扯到相關(guān)依賴版本變更需要調(diào)整。

到此這篇關(guān)于Springboot項(xiàng)目由JDK8升級(jí)至JDK17詳細(xì)教程的文章就介紹到這了,更多相關(guān)Springboot JDK版本升級(jí)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論