使用 Maven 为 Google Cloud Endpoints 应用程序自动生成 OpenApi 规范

Question

我使用 Java 和 Maven 框架创建了一个新的 Google Cloud Endpoints 应用。它有一个 servlet，只有一个基本的doGet 方法

public void doGet ... etc.

我应该能够使用以下方法生成端点文档：

mvn endpoints-framework:openApiDocs

这在Google documentation中有描述

我只是收到一条包含文本的消息：

Generates an OpenAPI document

Usage: <Endpoints tool> get-openapi-doc <options> <service class>...

在另一个包含许多服务的现有端点项目中，运行 mvn endpoints-framework:openApiDocs 有效，我收到消息：

OpenAPI document written to C:\myFolder\my-project\target\openapi-docs\openapi.json

我需要创建一个基本的 OpenApi 文档结构。 mvn endpoints-framework:openApiDocs 是否仅在我的端点中定义了服务时才有效？我对命令为什么起作用感到困惑，并在现有项目中创建了一个openapi.json，而不是另一个。我需要为mvn endpoints-framework:openApiDocs 做什么才能创建openapi.json？或者可以使用get-openapi-doc 指令以某种方式执行此操作吗？

Answer 1

我终于找到了执行此操作的 Google 文档：

Adding API Management