Swagger: maven 插件不生成 Api ZA559B87068921EEC0584086CE54Z5E

Question

我正在尝试使用仅 ApiModel 的代码优先方法生成 YAML 和 JSON 文件。 我希望 swagger-maven-plugin 只生成这个。 我没有任何 web 服务。 但它不会像 output 那样产生任何东西。 当我添加 web 服务时，它会正确生成文件。

@ApiModel(value="BatchModel", description="Batch model for the documentation")
public class BatchD {

  private Long batchId;

  private String reference;

  private List<BatchStateD> batchStateList;

  public BatchD() {
    batchStateList = new ArrayList<>();
  }

  @ApiModelProperty(required = true, value = "The identification number of the batch.")
  @JsonProperty("id")
  @NotNull
  public Long getBatchId() {
    return batchId;
  }

  public void setBatchId(Long batchId) {
    this.batchId = batchId;
  }

  @ApiModelProperty(required = true, value = "The reference number of batch")
  @JsonProperty("reference")
  @NotNull
  public String getReference() {
    return reference;
  }

 <build>
    <plugins>
      <plugin>
        <groupId>io.swagger.core.v3</groupId>
        <artifactId>swagger-maven-plugin</artifactId>
        <configuration>
          <outputFileName>openapi</outputFileName>
          <outputPath>${project.build.directory}/generatedtest</outputPath>
          <outputFormat>JSONANDYAML</outputFormat>
          <prettyPrint>TRUE</prettyPrint>
        </configuration>
        <executions>
          <execution>
            <phase>compile</phase>
            <goals>
              <goal>resolve</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>

Answer 1

Swagger - 它是一个 API 规范，描述了您的 Web 服务。 如果没有至少一个 Web 服务，就不能拥有 Web 服务规范。

@ApiModel注释仅描述了 Web 服务中使用的 model 的结构。 在Web服务中不使用这个model，这个注解是没有用的。

因此，您将获得预期的结果 - 如果您没有至少一个 Web 服务，则没有 Swagger 规范。