使用端点框架工具生成 OpenAPI 文档时出错（文档不清晰）

Question

（简介）
我正在使用 google 文档学习一些关于 google 云端点的教程。我已经成功运行我的第一个 API 但我在使用端点框架工具

生成 OpenAPI 文档时遇到错误

(Question/Issue)
长话短说，我在尝试为我的 google 云端点项目生成 OpenAPI 文档时遇到 "unclear" 错误。官方 google 文档 (here) 说明了以下生成文件的方法：

  endpoints-framework-tools-2.0.0-beta.11/bin/endpoints-framework-tools\
 get-openapi-doc \
  --hostname=YOUR-PROJECT-ID.appspot.com \
  --war=target/echo-1.0-SNAPSHOT \
  com.example.echo.Echo

他们没有说明什么是 "com.eample.echo.Echo"。尝试通过将 com.example 替换为我的包路径来运行命令，我收到以下令人困惑的错误。

Error:  co.mydomain.eliokhattar.myapplication.backend.MyEndpoint

用任何其他包替换上面的包仍然会出现同样的错误。

任何人都可以就如何使用此端点框架工具提出建议或提供清晰的教程吗？

Answer 1

我已经解决了这个问题，这与我在调用端点框架时没有提到 -classpath 参数有关。以下命令运行良好。

endpoints-framework-tools-2.0.0-beta.11/bin/endpoints-framework-tools \
 get-openapi-doc \
 --hostname=iccloudendpoint.appspot.com \
 --war=/Users/eliokhattar/endpints-test/IcExteranlTutorialDemo/icSysBackend/src/main/webapp \
 --classpath=/Users/eliokhattar/endpints-test/IcExteranlTutorialDemo/icSysBackend/build/classes/main/ co.mydomain.eliokhattar.myapplication.backend.MyEndpoint

另一方面，我现在遇到了一个不同的无关错误。

Answer 2

您需要编译后的应用程序。你指向你的源代码。试试 "icSysBackend/build/exploded-app".

此外，您希望 class 的格式基于它在包中的位置。认为 "com.etc.etc.Class" 而不是 "com/etc/etc/Class".

使用端点框架工具生成 OpenAPI 文档时出错（文档不清晰）

Error Generating OpenAPI doc using the endpoint-framework-tools (unclear documentation)

google-app-engine

google-cloud-endpoints

google-cloud-platform

google-cloud-endpoints-v2