2.58. OpenAPI Java
公开 Camel REST DSL 中定义的 OpenAPI 资源
2.58.1. 内部是什么
有关使用和配置详情,请参阅上述链接。
2.58.2. Maven 协调
在 code.quarkus.redhat.com 上使用此扩展创建一个新项目
或者将协调添加到现有项目中:
<dependency> <groupId>org.apache.camel.quarkus</groupId> <artifactId>camel-quarkus-openapi-java</artifactId> </dependency>
2.58.3. 使用方法
您可以使用此扩展来向 Quarkus OpenAPI 公开 REST DSL 服务。使用 quarkus-smallrye-openapi
时,您可以通过 /q/openapi?format=json
访问它们。
如需更多信息,请参阅 Quarkus OpenAPI 指南。
这是一个实验性功能。您可以通过以下方法启用它
quarkus.camel.openapi.expose.enabled=true
用户负责使用 @RegisterForReflection
来注册所有模型类以进行反映。
它目前不支持 org.apache.camel.builder.LambdaRouteBuilder
右侧的其他服务。另外,它无法在 RouteBuilder configure ()
中使用 CDI 注入,因为我们在构建时获取其余定义,而 CDI 不可用。
2.58.4. Camel Quarkus 限制
不支持 apiContextIdListing
配置选项。由于 不支持多个 CamelContext,并且 Quarkus 应用程序独立运行,因此没有尝试解析特定 'CamelContext 的 OpenApi 规格
的情况会很有用。它还引入了一些需要 JMX 的开销(不支持原生模式),以及额外的 Camel Quarkus 扩展来处理 XML。