基于JAX-RX的遗留项目迁移至Spring Boot的整合方案咨询

针对无main方法的大型WebSphere Liberty JAX-RS项目，迁移到Spring Boot可以按以下步骤逐步整合，兼顾兼容性与可维护性：

1. 依赖重构与基础配置 #

• 移除WebSphere Liberty专属依赖（如com.ibm.websphere.appserver.api.*），在项目构建文件（pom.xml/build.gradle）中引入Spring Boot核心依赖：
  • 必选：spring-boot-starter-web（基础Web支持），若要保留JAX-RS兼容，添加spring-boot-starter-jersey（Jersey是JAX-RS参考实现，Spring Boot原生支持）
  • 配置Spring Boot Parent来统一依赖版本，避免版本冲突
• 若遗留代码暂无法移除Liberty特有API，可临时添加provided scope的Liberty API依赖，但需制定后续替换计划（比如用标准JEE API或Spring等价实现替代）

2. 添加Spring Boot启动入口 #

由于遗留代码无main方法，手动创建启动类作为应用入口：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

@SpringBootApplication(scanBasePackages = {"com.your.legacy.root.package", "com.your.spring.config.package"})
public class LegacyApiBootstrap extends SpringBootServletInitializer {
    public static void main(String[] args) {
        SpringApplication.run(LegacyApiBootstrap.class, args);
    }
}

• scanBasePackages需覆盖遗留代码的根包路径，确保Spring能扫描到所有JAX-RS资源类与服务组件
• 继承SpringBootServletInitializer是为了支持WAR包部署（若仅需JAR包部署可省略）

3. 整合JAX-RS资源到Spring Boot #

方案一：保留JAX-RS注解，用Jersey集成（推荐大型项目） #

通过Jersey实现JAX-RS与Spring Boot的无缝兼容，无需修改遗留代码的注解：

import org.glassfish.jersey.server.ResourceConfig;
import org.springframework.context.annotation.Configuration;

@Configuration
public class JerseyResourceConfig extends ResourceConfig {
    public JerseyResourceConfig() {
        // 扫描遗留JAX-RS资源所在包，自动注册所有带@Path的类
        packages("com.your.legacy.jaxrs.resources");
        // 若有自定义JAX-RS Provider（如异常处理器、消息转换器），直接注册
        // register(CustomExceptionMapper.class);
    }
}

Spring Boot会自动识别该配置类，将Jersey作为Web服务实现，原有@Path、@GET、@POST等注解完全生效。

方案二：逐步迁移到Spring MVC（长期迭代方案） #

若计划逐步替换JAX-RS为Spring MVC：

• 保留遗留JAX-RS资源类不动，新增Spring MVC的@RestController实现相同接口，逐步切换流量
• 对存量接口，可通过Spring的@RequestMapping与JAX-RS注解共存，待完全验证后再替换原有注解
• 适合模块级迁移，避免一次性重构带来的风险

4. 适配遗留组件与配置 #

• 数据源/资源适配：将Liberty的JNDI配置替换为Spring Boot的配置文件（application.properties/application.yml），例如：

spring.datasource.url=jdbc:mysql://your-db-host:3306/legacy_db
spring.datasource.username=db_user
spring.datasource.password=db_pass
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

• 过滤器/拦截器适配：JAX-RS的ContainerRequestFilter可注册到Jersey配置类中；Servlet过滤器可通过@WebFilter或Spring的FilterRegistrationBean注册
• 事务管理：替换Liberty的JTA事务为Spring的@Transactional注解，配置Spring事务管理器（如DataSourceTransactionManager）

5. 测试与渐进式迁移 #

• 启动Spring Boot应用后，优先验证核心JAX-RS接口的功能一致性，对比原有Liberty环境的输出
• 大型项目建议分模块迁移：先迁移独立API模块，再逐步整合依赖的服务层、DAO层，避免一次性重构的风险
• 利用Spring Boot Actuator监控应用状态、健康指标，快速排查启动或运行时问题

6. 部署到Azure #

• 推荐打包为可执行JAR包，直接部署到Azure App Service（选择Java运行时环境），或通过Azure Kubernetes Service（AKS）进行容器化部署
• 若需WAR包部署，确保启动类继承SpringBootServletInitializer，部署到Azure的Tomcat容器或App Service的Java Web环境

内容的提问来源于stack exchange，提问作者Kailash