如何仅使用application/json格式生成Swagger



在Swagger文件中,默认情况下包括两种响应格式,JSON:neneneba APIapplication/JSON
这会导致生成Java类时出现问题,并阻止客户端进行编译。

我用两个不同的编译器对此进行了测试
Swagger Code Generator 3.0.35https://mvnrepository.com/artifact/io.swagger.codegen.v3/swagger-codegen/3.0.35以及不同版本的
OpenAPI生成器https://mvnrepository.com/artifact/org.openapitools/openapi-generator-cli/3.3.4.

作为一种解决方法,Swagger文件目前必须手动调整,并且必须删除JSON:API格式,这会在更新过程中造成大量工作量
Swagger文件的生成是否可能只包含application/json格式?

不,这是不可能的,IMHO也不应该是可能的,因为这会破坏拥有OpenApiSchema的全部意义。

OpenApi模式文件是shopware API的规范,由于shopware提供了两种响应格式,因此生成不完整的OpenApi文件是没有意义的。作为一个不完整的规范,从定义上来说就不再是规范了。

IMHO问题在于你想要使用的代码生成器。因为他们应该跳过他们不支持的格式,而不是出错。

最新更新