2.55. OpenAPI Java
公开 Camel REST DSL 中定义的 OpenAPI 资源
2.55.1. 内部
有关用法和配置详情,请参阅上面的链接。
2.55.2. Maven 协调
在 code.quarkus.redhat.com 上使用此扩展创建一个新项目
或者在现有项目中添加协调:
<dependency> <groupId>org.apache.camel.quarkus</groupId> <artifactId>camel-quarkus-openapi-java</artifactId> </dependency>
2.55.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.55.4. Camel Quarkus 限制
不支持 apiContextIdListing
配置选项。由于多个 CamelContext' 并不支持运行独立应用程序,因此无法尝试解决特定"CamelContext"的 OpenApi 规格
的情况会很有用。它还引入了一些额外的开销,需要 JMX(在原生模式中不支持)以及处理 XML 的其他 Camel Quarkus 扩展。