java - 是否可以向 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 文件。

我通常这样做，这里是 the official OpenAPI customization guide .