如何使用OpenAPI Generator将多个Header生成为Map形式？

我在OpenAPI 2.0定义中配置了以下两个请求头：

{
  "name": "key",
  "in": "header",
  "description": "v4 UUID ",
  "required": true,
  "type": "string",
  "format": "string",
  "x-example": "d1257cae-9814-90d0-89e0-abd9ae7b3375"
},
{
  "name": "emp-number",
  "in": "header",
  "description": "The emp number",
  "required": true,
  "type": "string",
  "x-example": "43234"
}

当前OpenAPI Generator生成的实现类方法是把这两个请求头拆成单独参数：

makeXy(String key, String emp-number)

想问能不能让生成器把这两个请求头合并成一个Map形式的参数，比如：

makeXy(Map<String, String> headers)

可以实现，具体方法如下：

• 通过全局配置参数启用
  OpenAPI Generator提供了headerAsMap这个全局配置参数，开启后就能让所有请求头合并为Map参数生成。以命令行生成为例，添加该参数即可：

  openapi-generator generate -i 你的API定义文件.yaml -g 目标语言（比如java） -o 输出目录 --global-property headerAsMap=true
  

• 注意事项

  • 这个配置是全局生效的，会改变所有接口的请求头生成逻辑，如果只需要针对特定接口调整，暂时没有直接的配置项，可能需要自定义模板或者后续二次处理。
  • 确认你的OpenAPI Generator版本支持该参数，旧版本可能没有这个功能，建议升级到较新的稳定版。
  • 生成的Map会包含所有定义的请求头（包括必填项），调用方法时要确保传入对应的键值对，避免遗漏必填参数导致报错。

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