在使用swagger-codegen生成代码时，我们经常需要使用自定义属性来生成我们需要的代码。swagger-codegen使用了mustache模板引擎来生成代码，而在mustache模板文件中，我们可以通过配置swagger规范文档中的自定义属性来生成我们需要的代码。本篇文章将从第三级标题开始，详细介绍如何在swagger-codegen的mustache模板文件中配置自定义属性。
一、swagger规范文档中的自定义属性
在swagger规范文档中，我们可以通过使用"x-"前缀来定义自定义属性。例如，我们可以在swagger规范文档中定义以下属性：
swagger: ‘2.0’ info: version: 1.0.0 title: Swagger Petstore description: A sample API that uses a petstore as an example to demonstrate features in the swagger-2.0 specification termsOfService: http://swagger.io/terms/ contact: name: Swagger API Team email: [email protected] url: http://swagger.io license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html host: petstore.swagger.io basePath: /v2 tags:
- name: pet description: Everything about your Pets x-custom-property: custom value 在上面的示例中，我们定义了一个"x-custom-property"属性，并将其设置为"custom value"。在我们生成代码时，我们可以使用这个属性来生成我们需要的代码。
二、mustache模板文件中的自定义属性
在mustache模板文件中，我们可以通过使用"{{x-custom-property}}"来引用swagger规范文档中定义的自定义属性。例如，我们可以在mustache模板文件中定义以下代码：
{{#operations}} {{#x-custom-property}} // custom property: {{x-custom-property}} {{/x-custom-property}} {{/operations}} 在上面的示例中，我们使用了"x-custom-property"属性来生成我们需要的代码。在我们生成代码时，mustache模板引擎会自动将"x-custom-property"属性替换为我们在swagger规范文档中定义的值。
在swagger规范文档中，我们也可以定义一个API的版本号、作者、创建时间等等。这些属性可以在mustache模板中使用，来生成代码中的注释、类名、方法名等等。下面是一个例子：
swagger: ‘2.0’ info: version: 1.0.0 title: My API description: My API description x-author: John Doe x-created-at: ‘2021-08-01T00:00:00Z’ paths: /users: get: summary: Get a list of users description: Returns a list of users responses: ‘200’: description: A list of users schema: type: array items: $ref: ‘#/definitions/User’ definitions: User: type: object properties: id: type: integer format: int64 name: type: string 在这个例子中，我��定义了两个自定义属性，x-author和x-created-at。我们可以在mustache模板中使用这些属性，比如说我们可以在生成的代码中添加一个注释：
/**
- Generated by swagger-codegen
- API version: {{info.version}}
- Created by {{info[‘x-author’]}} on {{info[‘x-created-at’]}} */ 在这个注释中，我们使用了info.version、info[‘x-author’]和info[‘x-created-at’]三个属性。这些属性在mustache模板中使用时，需要使用双括号来包裹，比如说{{info.version}}。
除了使用自定义属性，我们还可以在mustache模板中使用一些内置的属性，比如说{{apiPackage}}、{{modelPackage}}、{{classname}}等等。这些属性可以帮助我们生成更加灵活的代码。
swagger-codegen的使用方法及常见参数配置 swagger-codegen的模板文件mustache中，classname，description，notes如何赋值
标签：自定义,custom,codegen,mustache,swagger,模板,属性 From： https://www.cnblogs.com/bigleft/p/18136586