54.4. 访问 OpenAPI 文档
当 OpenAPI 由 OpenApiFeature 启用时,OpenAPI 文档位于由服务端点位置组成的位置 URL,后跟 /openapi.json
或 /openapi.yaml
。
例如,对于在 http://host:port/context/services/
上发布的 JAX-RS 端点,其中 上下文是
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 文档。
如果需要 CORS 支持从另一主机上的 OpenAPI UI 访问定义,您可以在 cxf-rt-rs-security-cors
中添加 CrossOriginResourceSharingFilter
。