4.7.4. 配置 JBoss EAP 以提供静态 OpenAPI 文档

流程

1. 在应用程序源树中创建目录：

   $ mkdir APPLICATION_ROOT/src/main/webapp/META-INF

   Copy to Clipboard Toggle word wrap

   APPLICATION_ROOT 是含有应用的 pom.xml 配置文件的目录。

2. 查询 OpenAPI 端点，将输出重定向到文件中：

   $ curl http://localhost:8080/openapi?format=JSON > src/main/webapp/META-INF/openapi.json

   Copy to Clipboard Toggle word wrap

   默认情况下，端点提供 YAML 文档 format=JSON 指定返回 JSON 文档。

3. 配置应用程序，以便在处理 OpenAPI 文档模型时跳过注解扫描：

   $ echo "mp.openapi.scan.disable=true" > APPLICATION_ROOT/src/main/webapp/META-INF/microprofile-config.properties

   Copy to Clipboard Toggle word wrap

4. 重新构建应用程序：

   $ mvn clean install

   Copy to Clipboard Toggle word wrap

5. 使用以下管理 CLI 命令再次部署应用程序：

   1. 取消部署应用程序：

      undeploy microprofile-openapi.war

      Copy to Clipboard Toggle word wrap

   2. 部署应用程序：

      deploy APPLICATION_ROOT/target/microprofile-openapi.war

      Copy to Clipboard Toggle word wrap