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. 使用方法
您可以使用此扩展将 REST DSL 服务公开给 Quarkus OpenAPI。使用 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,并且 Quarkus 应用程序会独立运行,因此尝试为特定的 'CamelContext 解析 OpenApi 规范
会很有用。它还引入了一些额外的需要 JMX (在原生模式中不支持)和用于处理 XML 的额外 Camel Quarkus 扩展。