# RPG 迁移分析器分析来自 AS/400 和 IBM i 系统的遗留 RPG 程序 (RPG III/IV/ILE)，以便迁移到现代 Java 应用程序，提取业务逻辑、数据结构、文件操作，并生成可操作的迁移策略。 ## 概述该技能为 RPG（报告程序生成器）应用程序提供全面的分析和迁移规划。它提取程序规范，将 RPG 数据类型转换为 Java 等效项，将文件操作映射到现代数据库访问模式，并生成可实现的 Java 代码结构。 **关键迁移焦点**：RPG 到 Java，正确处理压缩小数 (BigDecimal)、数据结构 (POJO)、文件操作 (JPA/JDBC)、指标（布尔变量）和业务逻辑保留。 ## 何时使用此技能在以下情况下使用此技能： * 分析 RPG 源文件（.rpg、.rpgle、.RPGLE）以实现现代化 * 规划从 AS/400 或 IBM i 系统迁移到 Java * 将 RPG 数据结构（D-specs）转换为 Java 类 * 将 RPG 文件操作（F 规范）映射到数据库访问模式 * 了解RPG程序依赖关系和调用链 * 从 RPG 业务逻辑生成等效的 Java 代码 * 估计 RPG 迁移项目的复杂性和工作量 * 创建迁移文档和策略报告 * 将遗留大型机应用程序现代化为微服务 * 用户提及：RPG 分析、AS/400 迁移、IBM i 现代化、报告程序生成器、压缩十进制转换 ## 核心能力 ### 1\.程序分析提取并分析RPG程序组件： * **规范类型** ：H-spec（标头/控制）、F-spec（文件定义）、D-spec（数据定义）、C-spec（计算/逻辑）、P-spec（过程） * **数据结构**：具有嵌套结构、数组 (DIM)、外部引用 (EXTNAME)、限定符 (LIKEDS、QUALIFIED) 的 D 规范 * **文件定义**：物理文件、逻辑文件、显示文件（WORKSTN）、打印机文件 * **业务逻辑**：计算规范、控制结构（IF/ELSE/DO/FOR）、表达式（EVAL） * **指标** ：传统指标（*IN01-*IN99）、内置指标（*INLR、*INOF） * **内置函数**：字符串函数（%SUBST、%TRIM、%SCAN）、日期函数（%DATE、%DAYS）、数学函数（%DEC、%INT）、文件状态（%EOF、%FOUND、%ERROR） * **错误处理**：%ERROR、%STATUS、ON-ERROR 块 ### 2\.数据结构映射将 RPG 数据定义转换为 Java 等效项： * **D-spec 转换** ：数据结构定义到 Java 类 (POJO) * **数据类型映射** : * 压缩十进制 (P) → `BigDecimal` （保留精度） * 分区十进制 (S) → `BigDecimal` （带符号的十进制） * 字符 (A) → `字符串` * 日期 (D) → `本地日期` * 时间 (T) → `本地时间` * 时间戳 (Z) → `LocalDateTime` * 指示符 (N) → `布尔值` * 二进制整数 (I) → `int` 或 `long` * **数组 (DIM)** : 转换为 Java `List` 或数组 `T[]` * **嵌套数据结构** ：将 LIKEDS 转换为嵌套 Java 类 * **外部数据结构 (EXTNAME)** ：从数据库表定义生成 JPA 实体 * **初始化 (INZ)** ：映射到 Java 字段初始值设定项或构造函数 ### 3\.文件操作解析 RPG 文件 I/O 并将其转换为现代数据库访问： * **文件类型**：物理文件（DISK）、逻辑文件（密钥访问）、显示文件（WORKSTN）、打印机文件（PRINTER） * **访问方式**：顺序（完全读取）、键控（通过键直接访问）、到达顺序 * **I/O 操作** : * READ/READE → JPA查询方法，JDBC ResultSet迭代 * 写入 → JPA persist()、JDBC INSERT * 更新 → JPA 合并()、JDBC 更新 * 删除 → JPA 删除()、JDBC 删除 * CHAIN → JPA findById()，可选模式 * SETLL/READE 循环 → JPA findBy...() 带排序的查询 * **文件状态** : %EOF（文件结束）、%FOUND（找到记录）、%ERROR（I/O 错误）→ Java 异常或可选 * **事务边界** ：识别提交边界（COMMIT操作代码） ### 4\. Java迁移策略生成现代 Java 实现模式： * **POJO** ：来自 D 规范数据结构的普通旧 Java 对象 * **JPA Entities** ：数据库表的 @Entity 注释（来自 EXTNAME 文件） * **存储库模式**：用于文件操作的 Spring Data JPA 存储库 * **服务方法**：来自过程和子例程的业务逻辑 * **Bean 验证** ：来自 RPG 字段验证的 @NotNull、@Size、@DecimalMin/Max * **异常处理** ：将 %ERROR 模式转换为具有自定义异常的 try-catch 块 * **Collections** ：来自 RPG 数组和数据结构的 Java Collections API（List、Map、Set） * **DTO** ：服务边界的数据传输对象 * **事务管理**：提交边界的@Transactional注释 ### 5\.依赖性分析映射程序关系和外部依赖关系： * **程序调用** ：CALLB（绑定过程调用）、CALLP（原型过程调用） * **服务程序**：BNDDIR（绑定目录），*SRVPGM 对象 * **文件依赖** : 程序访问的所有物理/逻辑文件 * **数据库表** ：引用的 DB2 for i 表 (EXTNAME) * **/COPY Members** : 包含文件、复制源成员、原型 * **调用链** ：识别调用程序和被调用程序 * **共享数据区域** : *DTAARA 使用 * **消息队列**：QMHSNDPM（发送程序消息） ## 说明按照以下步骤分析 RPG 程序并将其迁移到 Java： ### 第 1 步：找到 RPG 源文件查找 RPG 源文件（RPG III/IV/ILE 自由格式的 .rpg、.rpgle、.RPGLE 扩展名）。寻找。 -名称“*.rpg”-o -名称“*.rpgle”-o -名称“*.RPGLE” ### 步骤 2：分析程序结构提取规范（H、F、D、C、P）、数据结构、文件定义、过程和依赖关系。 **自动化**：运行 `scripts/extract-struct.py` 进行自动提取。 ### 步骤 3：映射数据类型将 RPG 转换为 Java 类型 - **CRITICAL** ：始终使用“BigDecimal”作为压缩/分区小数（绝不是浮点/双精度）。角色扮演游戏类型 | Java 类型 |要点 ---|---|--- `nP m`（打包）| `BigDecimal` | **必须**保持精度 `nS m`（分区）| `BigDecimal` |带符号的小数 `A`（字符）| `字符串` |角色数据 `D/T/Z`（日期/时间）| `本地日期/本地时间/本地日期时间` |日期字段 `N`（指示符）| `布尔值` |真/假标志 `I`（整数）| `int` 或 `long` |二进制整数 `DIM(n)`（数组）| `List` 或 `T[]` |数组 ### 步骤 4：转换代码模式将 RPG 操作转换为 Java - 关键转换： * **计算** ：EVAL 表达式 → BigDecimal 算术方法 * **文件 I/O** ：CHAIN → `findById()` 以及可选、READ → 查询方法 * **数组** ：调整从 1 开始的 (RPG) 到从 0 开始的 (Java) 索引 * **字符串** : %SUBST(从 1 开始) → 子字符串(从 0 开始) * **指标** : *IN01 → 命名布尔变量有关全面的转换模式，请参阅 [pseudocode-rpg-rules.md]()。 ### 步骤 5：生成 Java 实现创建： 1. 来自 D-spec 数据结构的 POJO (`scripts/generate-java-classes.py`) 2. 数据库表的JPA实体 3. 存储库接口（Spring Data JPA） 4. 业务逻辑的服务方法 5. 异常处理和验证 ### 第 6 步：分析依赖关系映射程序调用 (CALLB/CALLP)、文件依赖项、/COPY 成员、服务程序。 **自动化**：运行 `scripts/analyze-dependency.sh` 或 `.ps1` ### 第 7 步：创建迁移报告生成包含程序概述、依赖关系、数据映射、Java 设计和复杂性估计的文档。 **模板** ：使用 `assets/migration-report-template.md` ### 第 8 步：验证和测试验证：BigDecimal 的使用、索引调整、事务边界、错误处理、使用 AS/400 数据样本进行单元测试。 ## 快速参考 ### 关键迁移规则 1. **始终对 RPG 压缩 (P) 和分区 (S) 小数使用 BigDecimal** - 切勿使用浮点/双精度 2. **调整索引** ：RPG 使用从 1 开始的数组/字符串，Java 使用从 0 开始的数组/字符串 3. **替换指示符** ：将*IN01-*IN99转换为描述性布尔变量 4. **文件操作** : CHAIN → findById(), READ → 带有Optional的查询方法 5. **字符串函数** : %SUBST(1:10) → substring(0, 10) - 调整位置 6. **日期操作**：RPG日期函数→ LocalDate/LocalTime API 7. **Transactions** ：识别 COMMIT 操作 → @Transactional 注解 8. **错误处理** : %ERROR/%STATUS → try-catch 自定义异常 ### 示例：数据结构到 Java 类 **RPG D 规格：** D 员工 DS D EmpId 6 0 D 员工姓名 30 A D 工资 63 2P **Java POJO：** 公共类员工{ 私有 int empId；私有字符串 empName；私人BigDecimal工资； // 6 位数字，2 位小数 // 获取器/设置器 } ### 示例：文件操作转换 **角色扮演链：** C custId 链 CUSTFILE C IF %找到（CUSTFILE） **Java 与 JPA：** customerRepository.findById(custId).ifPresent(客户 -> { // 处理客户 }); // 服务使用公共类客户服务{ @Autowired 私人客户存储库客户存储库；公共可选<客户> findCustomer(Integer custId) { 返回 customerRepository.findById(custId); } } ## 边缘情况 ### 情况 1：压缩十进制精度 **问题**：使用 double/float 会导致精度错误。 **解决方案**：始终使用字符串文字中的 `BigDecimal`：`new BigDecimal("123.45")` ### 情况 2：数组索引移位 **问题**：基于 RPG 1，基于 Java 0。 **解决方案**：调整所有数组/字符串索引引用。彻底测试。 ### 案例 3：外部数据结构 **问题**：EXTNAME 没有 DDL 源。 **解决方案**：使用DSPFDD命令，查询DB2 SYSTABLES/SYSCOLUMNS，或者从运行时数据创建实体。 ### 案例 4：遗留指标 **问题**：*IN01-*IN99 用于控制流。 **解决方案**：替换为描述性布尔值：`boolean invalidAmount = false;` ### 案例 5：日期世纪处理 **问题**：2 位数年份 (Y2K)。 **解决方案**：使用 4 位 LocalDate，应用世纪窗口逻辑，记录假设。 ## 指南 1. **BigDecimal 强制**：对于压缩/分区小数，切勿使用 float/double 2. **命名布尔值** ：将 *IN01-99 替换为描述性名称 3. **数据库访问**：将文件I/O映射到JPA/JDBC操作 4. **JPA 实体**：从 EXTNAME 物理文件定义创建 5. **异常处理** : 将%ERROR/%FOUND转换为异常/可选 6. **使用 AS/400 数据进行测试**：使用实际遗留系统数据进行验证 7. **事务**：识别COMMIT操作→@Transactional 8. **记录规则**：提取并记录隐式业务逻辑 9. **字符编码**：验证 EBCDIC → Unicode 转换 10. **批处理**：将批处理作业转换为Spring Batch框架 ## 错误处理 ### 类型 1：文件 I/O 错误 **检测**：%ERROR 或%STATUS 检查。 **处理** ：使用 try-catch 处理自定义异常（`CustomerNotFoundException`、`DataAccessException`） ### 类型 2：算术溢出 **检测**：视野大小不足。 **处理**：具有适当比例/精度的 BigDecimal，捕获 `ArithmeticException` ### 类型 3：缺少依赖项 **检测**：缺少/COPY 成员。 **处理** ：跟踪所有包含、创建共享接口、使用 Maven/Gradle 依赖项 ## 其他资源请参阅“references/”目录中的详细文档： ### RPG翻译规则（按主题整理） RPG 翻译规则被组织成有重点的、特定于主题的文件，以便于导航： * **[pseudocode-rpg-rules.md]()** \- **主索引** 带有快速入门指南和文件导航 * **[pseudocode-rpg-core-rules.md]()** \- 基础：规格、数据类型、基本操作、文件 I/O * **[pseudocode-rpg-functions.md]()** \- 内置函数 (BIF)：字符串、日期/时间、数学、数组函数 * **[pseudocode-rpg-data-structs.md]()** \- 数据结构模式：QUALIFIED、LIKEDS、OVERLAY、I/O 规范 * **[pseudocode-rpg-patterns.md]()** \- 常见习语、翻译模式、陷阱、关键规则 * **[pseudocode-rpg-advanced.md]()** \- ILE RPG、嵌入式 SQL、Web 服务、IFS、XML/JSON、线程 * **[pseudocode-rpg-migration-guide.md]()** \- 迁移工作流程、最佳实践、重构策略 ### 其他参考文档 * **[pseudocode-common-rules.md]()** \- 通用伪代码语法和约定 * **[testing-strategy.md]()** \- RPG 到 Java 迁移验证的测试方法 * **[transaction-handling.md]()** \- AS/400 事务模式到 Java 事务管理 * **[performance-patterns.md]()** \- 迁移代码的性能优化模式 * **[messaging-integration.md]()** \- IBM i 系统的消息队列和集成模式 ### 脚本用于在 `scripts/` 中进行自动分析的 Python 和 shell 脚本： * `analyze-dependency.sh/ps1` \- 扫描 RPG 源中的 CALLB、CALLP、/COPY；生成依赖图 * `extract-struct.py` \- 解析 RPG 规范（H、F、D、C、P）；输出结构化 JSON * `generate-java-classes.py` \- 从具有适当类型的 RPG 数据结构创建 Java POJO * `estimate-complexity.py` \- 计算迁移复杂度分数和工作量估计 ### 模板 * **[migration-report-template.md]()** \- 迁移分析报告的标准格式 * **[java-class-template.java]()** \- 生成的 Java 类的模板 **分析依赖项.sh / .ps1** * 扫描 RPG 源文件中的 CALLB、CALLP、/COPY 引用 * 生成JSON格式的依赖图 * 识别循环依赖用途： ./scripts/analyze-dependency.sh /path/to/rpg/source **提取结构.py** * 提取程序结构（H/F/D/C/P 规格） * 列出所有变量、数据结构、文件 * 识别子程序和过程 * 输出JSON结构文件用途： python脚本/extract-struct.py PROGRAM.rpgle --输出struct.json **生成java-classes.py** * 从 RPG 数据结构生成 Java POJO 类 * 创建适当的字段类型（BigDecimal 用于压缩小数） * 添加 getter、setter、构造函数 * 生成Bean验证注解用途： python 脚本/generate-java-classes.py Structure.json --output-dir ./src/main/java **估计复杂度.py** * 计算迁移复杂度分数 * 分析LOC、依赖关系、文件操作 * 提供工作量估算（小时/天） * 生成优先级排名用途： python脚本/estimate-complexity.py结构.json--报告复杂度-report.md ### 模板使用迁移报告模板以获得一致的文档： * [migration-report-template.md]() \- 迁移分析报告的标准格式 * [java-class-template.java]() \- 生成具有正确结构的 Java 类的模板 ## 与开发工具集成该技能与各种开发和分析工具集成： ### IBM i / AS/400 工具 * **源代码输入实用程序 (SEU)** ：从 AS/400 中提取源代码 * **编程开发经理 (PDM)** ：访问成员列表和源文件 * **WRKMBRPDM** ：与源成员合作 * **DSPFFD** ：显示文件字段描述，用于数据库结构分析 * **DSPPGMREF** ：显示程序引用和依赖项 ### 数据库工具 * **DB2 for i** ：查询系统目录（SYSTABLES、SYSCOLUMNS）以获取元数据 * **IBM Data Studio**：可视化数据库设计和 SQL 开发 * **DBeaver** ：支持 DB2 的通用数据库工具 ### 现代开发环境 * **IntelliJ IDEA** ：支持 Spring Boot 的 Java 开发 * **Eclipse**：带有 JPA 工具的 Java IDE * **VS Code** ：带有 Java 扩展的轻量级编辑器 * **Git** ：遗留源代码和新 Java 代码的版本控制 ### 迁移支持工具 * **Spring Initializr** ：引导 Spring Boot 项目 * **JPA Buddy** ：用于 JPA 实体生成的 IntelliJ 插件 * **Liquibase/Flyway** ：数据库迁移版本控制 * **Maven/Gradle** ：构建自动化和依赖管理 ### 测试和验证 * **JUnit 5**：单元测试框架 * **Spring Boot Test** ：集成测试支持 * **Mockito** ：单元测试的模拟框架 * **TestContainers** ：与容器的数据库集成测试

Rpg 迁移分析器

包含技能