54.4. 访问 OpenAPI 文档
当 OpenApiFeature 启用 OpenAPI 时,OpenAPI 文档位于由服务端点位置组成的位置 URL 中,后跟 /openapi.json
或 /openapi.yaml
。
例如,对于在 http://host:port/context/services/
中发布的 JAX-RS 端点,其中 context
是 Web 应用上下文,/services
是 servlet URL,其 OpenAPI 文档位于 http://host:port/context/services/openapi.json
和 http://host:port/context/services/openapi.yaml。
如果 OpenApiFeature 处于活跃状态,则 CXF Services 页面会链接到 OpenAPI 文档。
在上例中,您将进入 http://host:port/context/services/services
,然后按照链接返回 OpenAPI JSON 文档。
如果需要从另一个主机上的 OpenAPI UI 访问定义,您可以添加 cxf-rt-rs-security-cors
中的 CrossOriginResourceSharingFilter
。