用途:适用于采用 API-first / OpenAPI-first 方式的 Spring Boot 项目,即先编写 OpenAPI 规范,再据此生成控制器接口、DTO 和客户端代码。
主要能力:通过 openapi-generator-maven-plugin(示例版本 7.5.0)从 src/main/resources/openapi.yaml 生成 Spring 代码,可配置 apiPackage、modelPackage、delegatePattern、useSpringBoot3、useTags、dateLibrary、serializationLibrary、openApiNullable、skipDefaultInterface 等选项,输出到 target/generated-sources/openapi。
使用方式:在 Maven 中配置 generate 目标并指定 inputSpec 与 generatorName=spring;规范中定义 paths、operationId、请求/响应 schema 与 components。生成 OrdersApi 接口及 delegate 后,编写实现类(如 OrdersApiDelegateImpl)实现业务逻辑,返回 ResponseEntity。
限制与注意事项:绝不修改生成代码,应实现 delegate;需设置 useSpringBoot3=true 以避免旧 javax.* 导入;生成文件应加入 .gitignore(target/generated-sources/openapi/)并在构建时生成;建议 skipDefaultInterface=true,避免默认方法掩盖缺失实现;生成模型与手写模型应保持分离。