第 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 或 filesystem)，即： openapi-configuration.yaml openapi-configuration.json openapi.yaml openapi.json | true |
|
| JAX-RS API 扫描程序类的名称，用于处理应用、资源软件包、资源类和类路径扫描，请参阅 Resource Scanning 部分 | null |
|
| 安全定义列表+ | null |
|
| 打开/关闭 SwaggerUI 支持 | null (== true) |
|
| Swagger UI 配置 | null |
|
| 用于 pinpoint SwaggerUI 的 Maven 工件 | null |
|
| SwaggerUI 的版本 | null |
|
| 服务 URL+ 条款. | null |
|
| 标题+ | null |
|
| 如果设置，则会为每个 OpenApiContext 实例生成唯一的上下文 Id （请使用 多服务器端点）。另外，您可能想要将 scan 属性设置为 false。 | false |
|
| 版本+ | null |
+ 选项在 OpenAPI 类中定义
++ 选项在 SwaggerConfiguration 类中定义
