汇元开放平台代码生成

要解决的问题

对接汇元开放平台时，API 字段多、嵌套对象深，手工从接口文档翻译成 Java 请求类、响应类、测试类和联调页面容易出错，尤其 @JsonProperty 注解、字段类型映射和多次追加生成到同一 Maven 项目时容易不一致。

技能如何工作

这个技能面向明确的接口代码生成场景：当用户提到 API 方法编码，例如 pay.heepay.bank.apply，或描述“支付”“订单”“发票”等业务对象时，可触发代码生成流程。它会围绕 reference/hyw-demo/ 这个 Maven 示例项目，保持包路径、命名和注解风格一致。

关键步骤包括：

• 询问输出路径：生成前确认项目放在哪个目录，默认输出到 generated/hyw-demo/。
• 拉取 API 元数据：通过 Python 脚本获取 data.info、data.request_fields、data.response_fields，据此规划请求类、响应类和嵌套对象。
• 生成项目骨架与 Java 代码：首次生成补齐 pom.xml、Application.java、lib/、logback.xml 等文件，并将 VO 类写入 com.hyw.demo.vo。
• 生成测试与联调入口：为每个 API 生成测试类、HTML 测试页面、TestController，并维护 index.html 接口列表。
• 执行校验：检查字段完整性、括号匹配、类型匹配、import 和 @JsonProperty("原始json_name") 注解。

适用边界与注意点

该技能适合已有明确汇元开放平台方法编码的 Java/Maven 工程生成，不直接负责真实支付、发票或投诉业务的最终业务规则设计。使用前需要确认接口方法编码准确，输出路径可写，并且能接受多次生成会追加到同一个 hyw-demo 项目结构中。若接口字段含义、枚举值或业务权限不确定，仍需对照开放平台文档人工复核。