From 689b30c04cf5a5ae92264b76c9b40b6e753dd7c7 Mon Sep 17 00:00:00 2001 From: feng0207 <1647919872@qq.com> Date: Thu, 17 Sep 2026 19:05:07 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E5=BF=BD=E7=95=A5=20.trae/.zcode=20?= =?UTF-8?q?=E5=B7=A5=E5=85=B7=E5=85=83=E6=95=B0=E6=8D=AE=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../nine_surplus-springboot升级方案.md | 99 ------------------- ...ss_2b7f7712-b48d-4809-b5dc-b642e2df80ce.md | 23 ----- 2 files changed, 122 deletions(-) delete mode 100644 .trae/documents/nine_surplus-springboot升级方案.md delete mode 100644 .zcode/plans/plan-sess_2b7f7712-b48d-4809-b5dc-b642e2df80ce.md diff --git a/.trae/documents/nine_surplus-springboot升级方案.md b/.trae/documents/nine_surplus-springboot升级方案.md deleted file mode 100644 index 17459e1..0000000 --- a/.trae/documents/nine_surplus-springboot升级方案.md +++ /dev/null @@ -1,99 +0,0 @@ -# nine_surplus 升级方案：Spring Boot 化 + 可执行 Jar + JDK 升级 - -## Context（背景与目标） - -`nine_surplus`（11.1 万行、900 个 Java 文件）目前是一个基于 **Spring 4.1 + SpringMVC + Hibernate 4.2 + javax.servlet/JSP + 外部 Tomcat 8.5** 的 Web 应用，技术栈停留在 2013 年。当前部署方式是打成 `lotteryServer.war` 丢进 `apache-tomcat-8.5.100`，且此项目还在本机用 JDK8 运行。 - -用户明确诉求： -1. **集成 Spring Boot**，引入内嵌 Tomcat -2. **打包成可一键执行 `java -jar` 的 jar**，不再依赖外部 Tomcat -3. **JDK 升级到 11/17** -4. 本次只升级 `nine_surplus`，另外两个模块（lotteryCapture/lotteryOpen）不动 - -推荐技术选型（已和用户目标对齐）： -- **Spring Boot 2.7.x**（Spring 5.3 + javax.servlet 命名空间，与现有 `javax.*` 代码完全兼容，避免 11 万行改名） -- **Hibernate 5.6.x**（Boot 2.7 配套，替换已从 spring-orm 移除的 hibernate4 支持） -- **内嵌 Tomcat 9.x**（由 spring-boot-starter-web 提供） -- **JDK 11**（先升 11 稳妥运行，17 作为后续可选） -- **JSP/HTML 页面与现有 Spring XML 配置尽量保留**，降低改动面 - -> 注意：不采用 Spring Boot 3（jakarta 命名空间），否则全部 `javax.*` 要改名，风险不可控。 - ---- - -## 升级要点（改造点梳理） - -### 1. 保留不动的内容（大块存量） -- **59 个 JSP + 119 个 HTML 静态页**，原样保留（Boot 内嵌 Tomcat 可直接加载） -- **spring-config.xml / spring-mvc.xml** 的 XML bean 定义，通过主类 `@ImportResource` 引导加载，不改业务 bean -- **6 个支付/加密 system scope 黑盒 jar**：`cryptix-jce-provider`、`lzma-4.63-jio`、`dinpayRsaSignAPI`、`beecloud-java-sdk`、`yst_api`、`lzma`。这些是黑盒支付 SDK，改造时**不碰它们的实现**，仅确保能打进可执行 jar 的 classpath - -### 2. 必须修改的部分 - -#### A. pom.xml 重构 -| 项 | 现状 | 改后 | -|----|------|------| -| packaging | `war` | `jar` | -| parent | 无 | `spring-boot-starter-parent:2.7.x` | -| spring | 4.1.0.RELEASE | 由 Boot 2.7 管理（Spring 5.3.x，去掉显式 ``） | -| hibernate | 4.2.13.Final | 5.6.x（Boot 管理，去掉 ``） | -| 依赖 | 各 spring/hibernate 手动声明 | 合并为 starter：`spring-boot-starter-web`、`spring-boot-starter-data-jpa` 或保留 jdbc/hibernate；redis 用 `spring-boot-starter-data-redis` 或保留 spring-data-redis+jedis | -| system scope jar | cryptix/lzma/dinpay/beecloud/yst | 保留，但需处理打入 jar（Boot 默认不打包 system scope，需 `maven-jar-plugin` 或 spring-boot-maven-plugin 的 exclude/include 配置） | -| maven-jar-plugin mainClass | 无 | 填 `com.xxx.LotteryServerApplication` | -| Web 插件 | `maven-war-plugin` / `tomcat7-maven-plugin` | 移除，改用 `spring-boot-maven-plugin` | - -**关键坑**：`LocalSessionFactoryBean` 从 `org.springframework.orm.hibernate4` 改为 `org.springframework.orm.hibernate5`。 - -#### B. 新增 Spring Boot 启动主类 -新建 `LotteryServerApplication`（`@SpringBootApplication` + `@ImportResource("classpath:config/spring/spring-config.xml")`），并在其中： -- `@Bean` 配置 spring-mvc 的 DispatcherServlet 映射（或通过配置类 `implements WebMvcConfigurer` 引入 spring-mvc.xml） -- `@Bean` 注册 CharacterEncodingFilter、springSessionRepositoryFilter（替代 web.xml 中的 filter） -- 可选：让主类 `extends SpringBootServletInitializer` 以保留双部署能力 - -#### C. Hibernate 5 适配（核心工作量） -集中在 DAO 基类，量小但关键： -- [HibernateSuperDao.java](file:///c:/data/src/lottery/nine_surplus/nine_surplus/src/main/java/javautils/jdbc/hibernate/HibernateSuperDao.java) -- [HibernateSuperReadDao.java](file:///c:/data/src/lottery/nine_surplus/nine_surplus/src/main/java/javautils/jdbc/hibernate/HibernateSuperReadDao.java) -- 关注点：`getCurrentSession()`、`createCriteria`、`sessionFactory` 注入、事务管理器适配（`HibernateTransactionManager` → hibernate5 包） -- spring-config.xml 中 3 个 `LocalSessionFactoryBean`（write/read/autoLoad）的 class 改为 hibernate5，`hibernate.cache.provider_class` 等属性检查 - -#### D. WebSocket 适配 -- [WebSocketConfig.java](file:///c:/data/src/lottery/nine_surplus/nine_surplus/src/main/java/lottery/web/websocket/WebSocketConfig.java) 用 `@EnableWebSocket`（Spring 自带，非原生 javax.websocket），Boot 2.7 兼容，基本无需改；仅确认 handler 依赖的容器对象注入方式 - -#### E. 资源/配置加载 -- `EncryptPropertyPlaceholderConfigurer`（显式读取 `.properties` + 解密）在 Boot 下需适配为 `PropertySourcesPlaceholderConfigurer` 风格或保留自定义类，确认 `${...}` 占位符在 Boot 环境正常解析 -- 确认 `config/datasource/*.properties`、`config/hibernate/*` 的 classpath 路径在打包 jar 后仍在类路径上 - ---- - -## 推荐实施步骤（分批执行） - -1. **备份**：先对 `nine_surplus` 目录做完整备份 / 用 git 分支，确保可回滚 -2. **pom 改造 + 主类骨架**：改 packaging、引入 Boot parent/starter、新增 `LotteryServerApplication`，先让应用能`mvn spring-boot:run` 起来（不急着全功能） -3. **Hibernate 5 适配**：替换 DAO 基类与 spring-config 中的 hibernate4→hibernate5，编译通过 -4. **Filter/DispatcherServlet 注册**：把 web.xml 里的 filter、servlet 迁移到 Boot 主类/配置类 -5. **system jar 打包确认**：验证支付 SDK 能被可执行 jar 正确加载 -6. **JDK 11 验证**：`mvn clean package` 产出可执行 jar，`java -jar lotteryServer.jar` 启动成功，访问登录页 -7. **回归测试**：登录、下单、余额/报表等核心链路 + Redis 会话 + WebSocket - -## 代表性关键文件 -- `nine_surplus/pom.xml`（重构） -- `nine_surplus/src/main/webapp/WEB-INF/web.xml`（配置迁移参照，可删除） -- `nine_surplus/src/main/resources/config/spring/spring-config.xml`、`spring-mvc.xml`（保留 + hibernate5 适配） -- 新增 `LotteryServerApplication.java` -- `javautils/jdbc/hibernate/HibernateSuperDao.java`、`HibernateSuperReadDao.java`（Hibernate5 适配） -- `lottery/web/websocket/WebSocketConfig.java`（确认兼容） - ---- - -## 验证方式 -1. `mvn -f pom.xml clean package` 成功产出可执行 jar -2. `java -jar target/lotteryServer.jar`（JDK11）启动，无 ClassNotFound/NoSuchMethod 异常 -3. 浏览器访问 `http://localhost:8080/`（或配置端口）能返回登录页（原 war 是 8080） -4. 确认 Redis 会话、WebSocket、支付回调等核心链路可用 -5. 用 `jvisualvm`/启动日志确认内嵌 Tomcat 正常监听端口 - -## 风险与明确边界 -- **不会做**：不搬到 Spring Boot 3 / jakarta、不迁移 Thymeleaf、不重写 11 万行业务代码、不处理另两个模块 -- **高危点**：Hibernate 4→5 的 API 差异（主要在 2 个 DAO 基类 + 事务管理器）、system 支付 jar 的兼容性、`EncryptPropertyPlaceholderConfigurer` 解密在 Boot 环境的解析 -- **如遇 system jar 在 JDK11 上不兼容**（黑盒无从修改）：降级方案是仅 JDK 升级到 11、保留 war，Boot 化分阶段单独进行，避免一次全上 \ No newline at end of file diff --git a/.zcode/plans/plan-sess_2b7f7712-b48d-4809-b5dc-b642e2df80ce.md b/.zcode/plans/plan-sess_2b7f7712-b48d-4809-b5dc-b642e2df80ce.md deleted file mode 100644 index 4b1d38a..0000000 --- a/.zcode/plans/plan-sess_2b7f7712-b48d-4809-b5dc-b642e2df80ce.md +++ /dev/null @@ -1,23 +0,0 @@ -把 lotteryCapture 和 lotteryOpen 跑起来，与已运行的 nine_surplus 组成完整三进程系统。 - -## 1. 配置改造（两个模块同样处理） -- `lotteryCapture/src/main/resources/config/datasource/db.properties`：127.0.0.1:3306 → 127.0.0.1:33206（docker lottery-mysql），密码复用 nine_surplus 里已生成好的 druid 加密串（devpass123） -- `lotteryOpen/.../db.properties`：同上 -- `lotteryCapture/.../redis.properties`：host/port 是 DES 加密值（`|e` 后缀）→ 直接改成明文 127.0.0.1 / 36379（EncryptPropertyPlaceholderConfigurer 对无 `|e` 后缀的值原样透传，nine_surplus 就是这么用的） -- `lotteryOpen/.../redis.properties`：6379 → 36379 - -## 2. 构建并启动 -- JDK8 + 本地 Maven 分别 `mvn package`（jar，主类 lottery.bin.StartUp） -- 后台 `java -jar`（或 mvn exec）启动 lotteryOpen —— 核心验证对象 -- 启动 lotteryCapture —— 预期其外部爬虫请求失败（站点已死），但要确认进程活着、只有爬虫报错 - -## 3. 验证链路 -- 观察 lotteryOpen 日志：自主彩开奖 Job（SelfLotteryLastOpenCodeJob 等）每 30 秒生成号码 -- Redis 出现 `OPEN_CODE:jsmmc` 等 key；MySQL `lottery_open_code` 表有新数据 -- lotteryOpen 的 LotteryOpenJob 每 5 秒扫描未开奖注单 -- 用 zz 账号在 jsmmc 上下一注测试注单，观察结算：user_bets 状态变化、user_bill 出现"派奖"记录、余额到账 -- Web 页面（8080）上该彩种开奖号码自动刷新（WebSocket 推送） - -## 4. 收尾 -- 把两个进程的启动/停止命令补进 dev.bat 和 DEV-README.md -- 明确记录：外部爬虫目标站已失效属预期现象，自主彩链路是可验证的部分 \ No newline at end of file