openapi生成器/maven插件生成带有«、»字符的无效java代码

Question

我只是将代码从swagger代码生成器迁移到open api代码生成器。我通过maven插件使用生成器。我需要它为一个外部API（在我的控制之外）生成一个客户端，这里给出了使用的swagger文件。

我的插件设置如下：

<plugin>
    <groupId>org.openapitools</groupId>
    <artifactId>openapi-generator-maven-plugin</artifactId>
    <version>4.3.1</version>
    <executions>
        <execution>
            <goals>
                <goal>generate</goal>
            </goals>
            <configuration>
                <generateApiTests>false</generateApiTests>
                <generateModelTests>false</generateModelTests>
                <generateSupportingFiles>false</generateSupportingFiles>
                <environmentVariables>
                    <supportingFiles>
                        ApiClient.java,Authentication.java,OAuth.java,ApiKeyAuth.java,HttpBasicAuth.java,RFC3339DateFormat.java
                    </supportingFiles>
                </environmentVariables>
                <inputSpec>${project.basedir}/src/main/resources/api-tpz.json</inputSpec>
                <generatorName>java</generatorName>
                <configOptions>
                    <library>resttemplate</library>
                    <dateLibrary>java8</dateLibrary>
                </configOptions>
            </configuration>
        </execution>
    </executions>
</plugin>

为了有一个最小的例子，我把昂首阔步的来源去掉了：

{
    "swagger": "2.0",
    "info": {
        "description": "Api Documentation",
        "version": "1.0",
        "title": "Api Documentation",
        "termsOfService": "urn:tos",
        "contact": {

        },
        "license": {
            "name": "Apache 2.0",
            "url": "http://www.apache.org/licenses/LICENSE-2.0"
        }
    },
    "securityDefinitions": {
        "basicAuth": {
            "type": "basic"
        }
    },
    "security": [
        {
            "basicAuth": []
        }
    ],
    "host": "example.com",
    "basePath": "/api",
    "tags": [
    ],
    "paths": {
    },
    "definitions": {
        "GenericRow": {
            "type": "object",
            "title": "GenericRow",
            "additionalProperties": {
                "type": "object"
            }
        },
        "ResultList«GenericRow»": {
            "type": "object",
            "properties": {
                "offset": {
                    "type": "integer",
                    "format": "int64"
                },
                "overallCount": {
                    "type": "integer",
                    "format": "int64"
                },
                "results": {
                    "type": "array",
                    "items": {
                        "$ref": "#/definitions/GenericRow"
                    }
                }
            },
            "title": "ResultList«GenericRow»"
        }
    }
}

当生成器运行正常时，代码无效

@Override
  public boolean equals(java.lang.Object o) {
    if (this == o) {
      return true;
    }
    if (o == null || getClass() != o.getClass()) {
      return false;
    }
    ResultListGenericRow resultList«GenericRow» = (ResultListGenericRow) o;
    return Objects.equals(this.offset, resultList«GenericRow».offset) &&
        Objects.equals(this.overallCount, resultList«GenericRow».overallCount) &&
        Objects.equals(this.results, resultList«GenericRow».results);
  }

结果列表«GenericRow»完全错误。

另一方面，类的名称是正确生成的ResultListGenericRow只有变量名称处理错误。

如何解决这个问题？

编辑：

我无法控制给定的规范文件。我需要生成一个有效的客户端。大摇大摆的代码gen工作得很好（只是删除了特殊字符）。《迁移指南》中没有关于这方面的提示。如何使用新生成器获得等效代码？

Answer 1

当从swagger-codegen-cli切换到openapi-Generer-cli时，我也遇到了类似的问题。就我而言，在Swagger配置中添加forCodeGenerationin这样做有帮助：

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.SWAGGER_2)
            .select()
            .apis(RequestHandlerSelectors.any())
            .paths(PathSelectors.any())
            .build()
            .forCodeGeneration(true);
   }
}