如何将现有Maven桌游项目与SpringBoot对接搭建Web应用

问题背景 #

• 已完成基于Maven的纯后端桌游逻辑开发，需改造为可对外访问的Web应用
• 已获取初始SpringBoot项目，项目自带测试接口，启动类核心代码如下：

@SpringBootApplication
@RestController
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @GetMapping("/hello")
    public String hello(@RequestParam(value = "name", defaultValue = "World") String name) {
        return String.format("Hello %s!", name);
    }
}

• 核心诉求：打通SpringBoot前端Web层与原有Maven桌游后端逻辑层，明确两个模块的具体连通实现方式，完成Web应用搭建。

具体对接步骤 #

1. 合并项目结构与依赖 #

• 最简便的合并方式：将原有桌游项目的源码包整体拷贝到SpringBoot项目的src/main/java目录下，保证原有桌游代码的包路径是SpringBoot启动类所在包的子路径（例如启动类路径为com.example.demo，桌游代码放在com.example.demo.boardgame路径下），SpringBoot默认会自动扫描该路径下的所有类，无需额外配置扫描规则。
• 打开原有桌游项目的pom.xml，将其中声明的所有业务依赖，复制到SpringBoot项目pom.xml的<dependencies>节点下。如果出现依赖版本冲突，优先使用SpringBoot官方依赖管理中指定的版本，避免类版本不兼容导致的启动报错。
• 合并完成后直接启动DemoApplication，控制台无报错即代表基础代码、依赖合并生效。

2. 将原有桌游核心逻辑托管给Spring容器 #

• 找到原有桌游项目中的核心逻辑类（包括游戏流程控制、房间管理、牌堆操作、玩家状态管理等类），在类上添加@Service或@Component注解，让Spring容器在项目启动时自动实例化、管理这些类，后续Web层可以直接注入使用，无需手动new对象。

注意：如果原有逻辑中已经实现了单例模式、或者是纯静态方法的工具类，无需强行修改加注解，Web层直接调用静态方法也可正常运行，将类托管给Spring仅为了更方便后续扩展日志、参数校验、事务等能力。

3. 编写Web层接口对接逻辑层 #

• 不要将所有业务接口都写在启动类DemoApplication中，单独创建controller包存放Web层接口类，按业务维度拆分接口类（例如房间操作类、游戏流程类、玩家信息类）。
• 在Controller类中通过构造方法注入的方式，引入已经被Spring托管的桌游核心逻辑类，直接调用对应方法处理业务即可，最简示例代码如下：

@RestController
@RequestMapping("/game")
public class GameController {
    // 注入原有桌游项目的核心逻辑类
    private final BoardGameCoreService boardGameCoreService;

    // Spring 4.3+ 版本构造方法注入无需加@Autowired注解
    public GameController(BoardGameCoreService boardGameCoreService) {
        this.boardGameCoreService = boardGameCoreService;
    }

    // 开始游戏接口示例
    @PostMapping("/start")
    public String startGame(@RequestParam Long roomId) {
        // 直接调用原有桌游逻辑中已实现的开始游戏方法
        return boardGameCoreService.startGame(roomId);
    }
}

• 接口参数直接使用Spring提供的参数绑定注解接收前端传参，逻辑层返回的结果可以直接返回给前端，如果需要统一返回格式，自行封装通用返回对象即可，不影响核心对接逻辑。

4. 联调验证 #

• 启动SpringBoot项目，先调用自带的/hello接口，确认Web服务本身运行正常。
• 再调用自行编写的业务接口，传入测试参数，验证是否能正常触发原有桌游逻辑、返回预期结果，无报错即代表两层连通成功。

常见避坑点 #

• 如果选择将原有桌游项目作为独立Maven模块通过pom依赖引入，而非直接拷贝源码，需要在启动类的@SpringBootApplication注解上添加scanBasePackages配置，把原有桌游项目的包路径加入扫描范围，否则Spring无法识别到逻辑类，启动时会报找不到Bean的错误。
• 如果原有桌游逻辑包含长阻塞流程（例如等待玩家出牌的轮次等待），不要直接在Tomcat默认请求线程中执行，需要配合异步接口或者WebSocket做长连接通信，避免占满Web服务线程池导致服务不可用。
• 如果需要部署前端静态页面，将html、js、css等静态资源放到SpringBoot项目的resources/static目录下，启动后即可直接通过端口访问，无需额外配置静态资源映射。

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