第 54 章 使用 OpenAPI 支持扩展 JAX-RS 端点
摘要
CXF OpenApiFeature(org.apache.cxf.jaxrs.openapi.openApiFeature)允许您通过扩展公布的 JAX-RS 服务端点来生成 OpenAPI 文档。
Spring Boot 和 Karaf 实现同时支持 OpenApiFeature。
54.1. OpenApiFeature 选项
您可以在 OpenApiFeature 中使用以下选项：
| 名称 | 描述 | 默认 |
|---|---|---|
|
| OpenAPI 配置位置 | null |
|
| 联系电子邮件+ | null |
|
| 联系名称+ | null |
|
| 联系链接+ | null |
|
| 自定义器类实例 | null |
|
| description+ | null |
|
| 一个安全过滤器++ | null |
|
|
扫描所有资源时排除特定路径（请参阅 | null |
|
| 许可证+ | null |
|
| 许可证 URL+ | null |
|
| 当生成 openapi.json 时，正确打印 JSON 文档++ | true |
|
| 属性文件位置 |
|
|
| 通读所有操作（没有 @Operation++） | true |
|
| 必须扫描++ 的资源类列表 | null |
|
| 一个软件包名称列表，其中必须扫描资源++ | null |
|
| 以过滤器的形式运行该功能 | false |
|
| 自动扫描所有 JAX-RS 资源 | true |
|
| 扫描已知的 OpenAPI 配置位置（classpath 或文件系统），它们是： openapi-configuration.yaml openapi-configuration.json openapi.yaml openapi.json | true |
|
| JAX-RS API 扫描程序类的名称，用于范围应用、资源软件包、资源类和类路径扫描，请参阅 Resource Scanning 部分 | null |
|
| 安全定义列表+ | null |
|
| 启用/关闭 SwaggerUI 支持 | null(== true) |
|
| Swagger UI 配置 | null |
|
| 用于查点 SwaggerUI 的 Maven 工件 | null |
|
| SwaggerUI 的版本 | null |
|
| 服务 URL 条款+ | null |
|
| 标题+ | null |
|
| 如果设置，则会为每个 OpenApiContext 实例生成唯一的上下文 Id（请参阅 使用多个服务器端点）。另外，您可能想要将扫描属性设置为 false。 | false |
|
| 版本+ | null |
+ 选项在 OpenAPI 类中定义
++ 选项在 SwaggerConfiguration 类中定义
