OpenAPI Generator Maven插件configuration与configOptions标签区别及用法咨询

1. 定位差异 #

• <configuration>是Maven插件的标准通用配置根节点，属于OpenAPI Generator Maven插件的全局参数容器，参数作用和你选择的具体代码生成器无关，所有生成器通用。
• <configOptions>是<configuration>下的子节点，属于具体代码生成器的专属参数容器，里面的参数仅对当前配置的generatorName对应的生成器生效，更换生成器后这些参数可能完全不被识别。

2. 配置放置规则 #

放在外层<configuration>的通用参数 #

这类参数是插件层面的通用配置，和生成器类型无关，示例如下（对应你的配置）：

• skipValidateSpec：是否跳过OpenAPI规范文件校验
• inputSpec：OpenAPI描述文件（yaml/json）的本地路径
• generatorName：代码生成器类型，比如你用的spring
• library：生成器适配的框架库，比如spring-boot
• generateSupportingFiles：是否生成辅助工程文件
• output：生成代码的输出目录
• apiPackage：生成的API接口类的包路径
• modelPackage：生成的实体模型类的包路径

放在<configOptions>的生成器专属参数 #

这类参数是你选择的特定生成器才支持的配置，比如你用的spring生成器的专属配置如下：

• interfaceOnly：是否仅生成API接口，不生成具体实现类
• delegatePattern：是否启用委托模式实现接口逻辑
• dateLibrary：日期类型使用的类库，比如你配置的java8对应Java8的LocalDate等类型
• skipDefaultInterface：是否跳过生成接口的默认实现方法

注：你的配置里supportingFilesToGenrate存在拼写错误，正确拼写应为supportingFilesToGenerate

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