是否可以向 OpenAPI 添加方法？

Question

我有一个问题：是否可以将具有某些逻辑的方法添加到由 open-api 生成的 DTO。

例如我有一个 openapi DTO：

CarDTO:
   type: object
   properties:
     id:
       type: string
       format: uuid
     isEngineWorks:
       type: boolean
       default: false
     isFuelFull:
       type: boolean
       default: false

我使用 maven 插件（openapi-generator-maven-plugin），它为我生成了一个 java 类：

public class CarDTO {
    @JsonProperty("id")
    @Valid
    private UUID id;

    @JsonProperty("isEngineWorks")
    private Boolean isEngineWorks = false;

    @JsonProperty("isFuelFull")
    private Boolean isFuelFull = false;
}

是否可以在openapi中添加一个方法，所以它将在我的DTO中生成？ 结果，我想要：

public class CarDTO {
    @JsonProperty("id")
    @Valid
    private UUID id;

    @JsonProperty("isEngineWorks")
    private Boolean isEngineWorks = false;

    @JsonProperty("isFuelFull")
    private Boolean isFuelFull = false;
    
    public boolean isCarReadyToDrive {
        return isEngineWorks && isFuelFull;  
    }

}

Answer 1

当然，这是可能的。

您必须覆盖与您正在使用的 OpenAPI 生成器相关的pojo.mustache文件。

我通常会这样做，这里是官方的 OpenAPI 定制指南。