11.4. MicroProfile OpenAPI 参考

mp.openapi.extensions.enabled

true

启用或禁用 OpenAPI 端点的注册。

当设置为 false 时，禁用 OpenAPI 文档的生成。您可以使用 config 子系统或配置文件中每个应用（如 /META-INF/microprofile-config.properties ）设置值。

您可以对此属性进行参数化，以选择性地在不同环境中启用或禁用 microprofile-openapi-smallrye，如生产或开发。

您可以使用此属性来控制与给定虚拟主机关联的应用应生成 MicroProfile OpenAPI 模型。

mp.openapi.extensions.path

/openapi

您可以使用此属性为与虚拟主机关联的多个应用程序生成 OpenAPI 文档。

在与同一虚拟主机关联的每个应用程序上设置不同的 mp.openapi.extensions.path。

mp.openapi.extensions.servers.relative

true

指明自动生成的服务器记录是绝对或相对于 OpenAPI 端点的位置。

需要服务器记录来确保存在非根上下文路径，OpenAPI 文档的用户可以构建与 OpenAPI 端点主机相关的 REST 服务的有效 URL。

true 表示服务器记录相对于 OpenAPI 端点的位置。生成的记录包含部署的上下文路径。

当设置为 false 时，JBoss EAP XP 生成服务器记录，包括可以访问部署的所有协议、主机和端口。