Apache Camel中Swagger-Java与OpenAPI 3.0支持及版本配置问询

Great questions! Let's break this down clearly:

Can you configure Camel to generate Swagger 3.0? #

First, a quick clarification: Swagger 3.0 is just the rebranded OpenAPI 3.0 (the Swagger project was renamed to OpenAPI after version 2.0). So when you're asking about generating "Swagger 3.0", you're referring to the OpenAPI 3.0 specification.

In modern Apache Camel versions (3.x and later), you absolutely can configure the REST DSL to output OpenAPI 3.0 documentation. Here's a simple example of how to set this up in your route configuration:

restConfiguration()
    .apiContextPath("/api-docs")
    .apiProperty("api.version", "3.0") // This triggers OpenAPI 3.0 generation
    .apiProperty("api.title", "My Camel REST Service")
    .apiProperty("api.description", "Full documentation for my Camel-backed API")
    .enableCORS(true);

The critical line here is apiProperty("api.version", "3.0")—this tells Camel to produce the 3.0 spec instead of the default (older) Swagger 2.0.

Does Apache Camel support OpenAPI 3.0? #

Yes, full native support for OpenAPI 3.0 was added starting with Camel 3.x. This includes:

• REST DSL generation: As shown above, you can generate valid OpenAPI 3.0 docs directly from your Camel REST routes.
• Spec parsing & validation: The camel-openapi-java component lets you parse OpenAPI 3.0 specs, validate requests against them, and even generate Camel routes from the spec.
• Spring Boot integration: For Spring Boot users, the camel-springdoc module integrates with SpringDoc OpenAPI to expose 3.0-compliant docs alongside your Camel routes.

Note that older Camel 2.x versions only support Swagger 2.0, so you'll need to upgrade to 3.x or later to get OpenAPI 3.0 capabilities.

Was OpenAPI 3.0 support part of Camel's roadmap? #

This feature is already fully implemented and released—it was a key priority for the Camel 3.x release cycle to align with modern API standards. There's no ongoing planning needed, as OpenAPI 3.0 support is stable and included in all currently supported Camel versions (3.x and 4.x).

内容的提问来源于stack exchange，提问作者Sari Alalem