该技能用于把 Neo Java 应用从 Java 8/11 与 Java EE 迁移到 Java 25 与 Jakarta EE 10。
用途: 升级 Java 运行时,并将 javax.* 命名空间迁移到 jakarta.*,以兼容现代应用服务器与 Cloud Foundry buildpack。
检测条件: 若在 pom.xml 中发现 Java 8 或 11 的 maven.compiler.source/target,或在 Java 源文件中发现 javax.* 导入(如 javax.servlet.、javax.persistence.、javax.annotation.、javax.mail.、javax.ejb.*),则该技能适用。
前置条件: 无(通常这是第一步迁移);已安装 Maven 3.6+;PATH 中有 Java 25+。
主要步骤:
- 先创建应用目录的副本(同级文件夹,命名为 <原目录名>-cf-migration),所有迁移工作在副本中进行,原目录保持不变;在副本内创建 .migration/ 目录并保存迁移配置。
- 更新 pom.xml 中的 Java 版本,将 maven.compiler.source/target 改为 25。并强调必须在 mtad 中固定运行时 JRE,否则应用每个请求都会返回 500;需确保两个环境变量 JBP_CONFIG_COMPONENTS 与 JBP_CONFIG_SAP_MACHINE_JRE(版本 25.+)同时存在。
- 运行 OpenRewrite 迁移配方(UpgradeToJava25 与 JakartaEE10),自动更新 Java 语言特性、替换 javax.* 导入、更新废弃 API、迁移 web.xml 命名空间。注意 -Drewrite.activeRecipes 只能传递一次,需使用逗号分隔列表。
- 修复 OpenRewrite 产生的副作用:将 jakarta.servlet-api 恢复为 provided scope;若存在 javax.servlet:jstl 则替换为 Jakarta JSTL 依赖。
- 处理 OpenCMIS 例外:OpenCMIS 库未迁移到 Jakarta EE,需添加特定排除项。
- 更新 web.xml 命名空间及常见导入(javax.* → jakarta.*)。
- 处理 Jackson JAX-RS provider 变更,并手动更新 web.xml 中的 JAX-RS provider 引用与 Maven 依赖。
- 若使用 CXF Swagger 2,则迁移到 OpenAPI v3,包括替换依赖、注解、Feature 类,并修正 jakarta.xml.ws-api 的 scope;若为 JAX-RS(Jersey)应用,需在运行时打包 JAX-RS API 与实现依赖。
适用场景: 需要将既有 Neo Java 应用升级到 Java 25 与 Jakarta EE 10,以便兼容现代应用服务器与 Cloud Foundry buildpack 的场景。
限制: 前提是已在 pom.xml 或源码中检测到相应旧版本或 javax.* 使用;OpenRewrite 不会迁移旧 JSTL 库,也不会更新 web.xml 中的类引用;OpenCMIS 未迁移到 Jakarta EE,需排除;CXF Swagger 2 到 OpenAPI v3 的迁移是有条件的,仅在检测到相关使用时执行。