Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

3.9. Camel REST DSL OpenApi Maven 插件

Camel REST DSL OpenApi Maven 插件支持以下目标：

  • camel-restdsl-openapi:generate - 要从 OpenApi 规范生成使用者 REST DSL RouteBuilder 源代码
  • camel-restdsl-openapi:generate-with-dto - 从 OpenApi 规范生成使用者 REST DSL RouteBuilder 源代码，以及通过 swagger-codegen-maven-plugin 生成的 DTO 模型类。
  • camel-restdsl-openapi:generate-xml - 从 OpenApi 规范生成消费者 REST DSL XML 源代码
  • camel-restdsl-openapi:generate-xml-with-dto - 要从 OpenApi 规范生成使用者 REST DSL XML 源代码，以及通过 swagger-codegen-maven-plugin 生成的 DTO 模型类。
  • camel-restdsl-openapi:generate-yaml - 从 OpenApi 规范生成消费者 REST DSL YAML 源代码
  • camel-restdsl-openapi:generate-yaml-with-dto - 从 OpenApi 规范生成使用者 REST DSL YAML 源代码，以及通过 swagger-codegen-maven-plugin 生成的 DTO 模型类。

3.9.1. 将插件添加到 Maven pom.xml
复制链接

此插件可以通过将其添加到 plugins 部分来将其添加到 Maven pom.xml 文件中，例如在 Spring Boot 应用程序中： 

<build>
  <plugins>
    <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
    </plugin>

    <plugin>
      <groupId>org.apache.camel</groupId>
      <artifactId>camel-restdsl-openapi-plugin</artifactId>
      <version>{CamelCommunityVersion}</version>
    </plugin>

  </plugins>
</build>
Copy to Clipboard Toggle word wrap

然后，该插件可以使用其前缀 camel-restdsl-openapi 来执行，如下所示。 

$mvn camel-restdsl-openapi:generate
Copy to Clipboard Toggle word wrap

3.9.2. camel-restdsl-openapi:generate
复制链接

Camel REST DSL OpenApi Maven 插件的目标是从 Maven 生成 REST DSL RouteBuilder 实施源代码。

3.9.2.1. 选项
复制链接

该插件支持可从命令行配置以下选项(use -D 语法)，或者在 配置 标签的 pom.xml 文件中定义。

Expand
参数默认值描述

skip

false

设置为 true 以跳过代码生成

filterOperation

 

仅用于包括指定的操作 id。可以使用逗号分隔多个 id。可以使用通配符，如 find，包括以 find 开头的所有操作。

specificationUri

src/spec/openapi.json

OpenApi 规范的 URI，支持文件系统路径、HTTP 和类路径资源，默认为项目目录中的 src/spec/openapi.json。支持 JSON 和 YAML。

auth

 

在远程获取 OpenApi 规格定义时添加授权标头。使用逗号分隔多个值，传递一个 URL 编码的 name:header 字符串。

className

来自 title 或 RestDslRoute

从 OpenApi 规格标题获取生成的类的名称，或者默认设置为 RestDslRoute

packageName

从 host 或 rest.dsl.generated

生成类的软件包名称，默认为 OpenApi 规格主机值或 rest.dsl.generated

indent

" "

默认情况下，使用哪个缩进字符，默认为四个空格，您可以使用 \t 来表示 tab 字符

outputDirectory

generated-sources/restdsl-openapi

在项目目录中，将生成的源文件放在何处，默认为 generated-sources/restdsl-openapi

destinationGenerator

 

实施 org.apache.camel.generator.openapi.DestinationGenerator 接口的类的完全限定类名称，用于自定义目标端点

destinationToSyntax

direct:${operationId}

to uri 的默认语法是使用直接组件。

restConfiguration

true

是否包含使用检测到的其他组件的生成部分。

apiContextPath

 

如果 restConfiguration 设为 true，则定义 openapi 端点路径。

clientRequestValidation

false

是否启用请求验证。

basePath

 

覆盖 OpenAPI 规格中定义的 api 基础路径。

requestMappingValues

/**

允许生成自定义 RequestMapping 映射值。多个映射值可以传递如下：

<requestMappingValues> <param>/my-api-path/ </param> <param>/my-other-path/ &lt;/param> </requestMappingValues>

3.9.3. 带有 Servlet 组件的 Spring Boot 项目
复制链接

如果 Maven 项目是 Spring Boot 项目，并且启用了 restConfiguration，并且 servlet 组件用作 REST 组件，那么此插件将自动检测软件包名称（如果尚未明确配置 packageName），则使用相同的软件包名称来生成 Rest DSL 源代码和所需的 CamelRestController 支持类。

3.9.4. camel-restdsl-openapi:generate-with-dto
复制链接

作为 generate 目标，但也通过自动执行 swagger-codegen-maven-plugin 来生成 DTO 模型类，从 OpenApi 规范生成 DTO 模型类的 java 源代码。

此插件范围有限，仅限于支持使用 swagger-codegen-maven-plugin 生成模型 DTOs 的良好工作量集。如果您需要更多电源和灵活性，请直接使用 Swagger Codegen Maven 插件 来生成 DTO 而不是此插件。

DTO 类可能需要额外的依赖项，例如： 

    <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.10.1</version>
    </dependency>
    <dependency>
      <groupId>io.swagger.core.v3</groupId>
      <artifactId>swagger-core</artifactId>
      <version>2.2.8</version>
    </dependency>
    <dependency>
      <groupId>org.threeten</groupId>
      <artifactId>threetenbp</artifactId>
      <version>1.6.8</version>
    </dependency>
Copy to Clipboard Toggle word wrap

3.9.4.1. 选项
复制链接

该插件支持以下 附加选项

Expand
参数默认值描述

swaggerCodegenMavenPluginVersion

3.0.36

要使用的 io.swagger.codegen.v3:swagger-codegen-maven-plugin maven 插件的版本。

modelOutput

 

目标输出路径（默认为 ${project.build.directory}/generated-sources/openapi）

modelPackage

io.swagger.client.model

用于生成的模型对象/类的软件包

modelNamePrefix

 

为模型类和枚举设置 pre- 或 suffix

modelNameSuffix

 

为模型类和枚举设置 pre- 或 suffix

modelWithXml

false

在生成的模型中启用 XML 注解（仅适用于为 JSON 和 XML 提供支持的库）

configOptions

 

将特定于语言的参数映射到 swagger-codegen-maven-plugin

3.9.5. camel-restdsl-openapi:generate-xml
复制链接

Camel REST DSL OpenApi Maven 插件的 camel-restdsl-openapi:generate-xml 目标用于从 Maven 生成 REST DSL XML 实施源代码。

3.9.5.1. 选项
复制链接

该插件支持从命令行配置以下选项(use -D 语法)，或者在 < configuration > 标签的 pom.xml 文件中定义。

Expand
参数默认值描述

skip

false

设置为 true 以跳过代码生成。

filterOperation

 

仅用于包括指定的操作 id。可以使用逗号分隔多个 id。可以使用通配符，如 find，包括以 find 开头的所有操作。

specificationUri

src/spec/openapi.json

OpenApi 规范的 URI，支持文件系统路径、HTTP 和类路径资源，默认为项目目录中的 src/spec/openapi.json。支持 JSON 和 YAML。

auth

 

在远程获取 OpenApi 规格定义时添加授权标头。使用逗号分隔多个值，传递一个 URL 编码的 name:header 字符串。

outputDirectory

generated-sources/restdsl-openapi

在项目目录中，将生成的源文件放在何处，默认为 generated-sources/restdsl-openapi

fileName

camel-rest.xml

作为输出的 XML 文件的名称。

蓝图

false

如果启用生成 OSGi Blueprint XML，而不是 Spring XML。

destinationGenerator

 

实施 org.apache.camel.generator.openapi.DestinationGenerator 接口的类的完全限定类名称，用于自定义目标端点

destinationToSyntax

direct:${operationId}

to uri 的默认语法是使用直接组件。

 

restConfiguration

true

是否包含使用检测到的其他组件的生成部分。

apiContextPath

 

如果 restConfiguration 设为 true，则定义 openapi 端点路径。

clientRequestValidation

false

是否启用请求验证。

basePath

 

覆盖 OpenAPI 规格中定义的 api 基础路径。

requestMappingValues

/**

3.9.6. camel-restdsl-openapi:generate-xml-with-dto
复制链接

充当 generate-xml 目标，但也通过自动执行 swagger-codegen-maven-plugin 来生成 DTO 模型类的 DTO 模型类，以从 OpenApi 规范生成 DTO 模型类的 java 源代码。

此插件范围有限，仅限于支持使用 swagger-codegen-maven-plugin 生成模型 DTOs 的良好工作量集。如果您需要更多电源和灵活性，请直接使用 Swagger Codegen Maven 插件 来生成 DTO 而不是此插件。

DTO 类可能需要额外的依赖项，例如： 

    <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.10.1</version>
    </dependency>
    <dependency>
      <groupId>io.swagger.core.v3</groupId>
      <artifactId>swagger-core</artifactId>
      <version>2.2.8</version>
    </dependency>
    <dependency>
      <groupId>org.threeten</groupId>
      <artifactId>threetenbp</artifactId>
      <version>1.6.8</version>
    </dependency>
Copy to Clipboard Toggle word wrap

3.9.6.1. 选项
复制链接

该插件支持以下 附加选项

Expand
参数默认值描述

swaggerCodegenMavenPluginVersion

3.0.36

要使用的 io.swagger.codegen.v3:swagger-codegen-maven-plugin maven 插件的版本。

modelOutput

 

目标输出路径（默认为 ${project.build.directory}/generated-sources/openapi）

modelPackage

io.swagger.client.model

用于生成的模型对象/类的软件包

modelNamePrefix

 

为模型类和枚举设置 pre- 或 suffix

modelNameSuffix

 

为模型类和枚举设置 pre- 或 suffix

modelWithXml

false

在生成的模型中启用 XML 注解（仅适用于为 JSON 和 XML 提供支持的库）

configOptions

 

将特定于语言的参数映射到 swagger-codegen-maven-plugin

3.9.7. camel-restdsl-openapi:generate-yaml
复制链接

camel-restdsl-openapi:generate-yaml 目标使用 Camel REST DSL OpenApi Maven 插件从 Maven 生成 REST DSL YAML 实施源代码。

3.9.7.1. 选项
复制链接

该插件支持从命令行配置以下选项(use -D 语法)，或者在 < configuration > 标签的 pom.xml 文件中定义。

Expand
参数默认值描述

skip

false

设置为 true 以跳过代码生成。

filterOperation

 

仅用于包括指定的操作 id。可以使用逗号分隔多个 id。可以使用通配符，如 find，包括以 find 开头的所有操作。

specificationUri

src/spec/openapi.json

OpenApi 规范的 URI，支持文件系统路径、HTTP 和类路径资源，默认为项目目录中的 src/spec/openapi.json。支持 JSON 和 YAML。

auth

 

在远程获取 OpenApi 规格定义时添加授权标头。使用逗号分隔多个值，传递一个 URL 编码的 name:header 字符串。

outputDirectory

generated-sources/restdsl-openapi

在项目目录中，将生成的源文件放在何处，默认为 generated-sources/restdsl-openapi

fileName

camel-rest.xml

作为输出的 XML 文件的名称。

destinationGenerator

 

实施 org.apache.camel.generator.openapi.DestinationGenerator 接口的类的完全限定类名称，用于自定义目标端点

destinationToSyntax

direct:${operationId}

to uri 的默认语法是使用直接组件。

 

restConfiguration

true

是否包含使用检测到的其他组件的生成部分。

apiContextPath

 

如果 restConfiguration 设为 true，则定义 openapi 端点路径。

clientRequestValidation

false

是否启用请求验证。

basePath

 

覆盖 OpenAPI 规格中定义的 api 基础路径。

requestMappingValues

/**

3.9.8. camel-restdsl-openapi:generate-yaml-with-dto
复制链接

充当 generate-yaml 目标，但也通过自动执行 swagger-codegen-maven-plugin 生成 DTO 模型类的 java 源代码，从 OpenApi 规范生成 DTO 模型类的 java 源代码。

此插件范围有限，仅限于支持使用 swagger-codegen-maven-plugin 生成模型 DTOs 的良好工作量集。如果您需要更多电源和灵活性，请直接使用 Swagger Codegen Maven 插件 来生成 DTO 而不是此插件。

DTO 类可能需要额外的依赖项，例如： 

    <dependency>
      <groupId>com.google.code.gson</groupId>
      <artifactId>gson</artifactId>
      <version>2.10.1</version>
    </dependency>
    <dependency>
      <groupId>io.swagger.core.v3</groupId>
      <artifactId>swagger-core</artifactId>
      <version>2.2.8</version>
    </dependency>
    <dependency>
      <groupId>org.threeten</groupId>
      <artifactId>threetenbp</artifactId>
      <version>1.6.8</version>
    </dependency>
Copy to Clipboard Toggle word wrap

3.9.8.1. 选项
复制链接

该插件支持以下 附加选项

Expand
参数默认值描述

swaggerCodegenMavenPluginVersion

3.0.36

要使用的 io.swagger.codegen.v3:swagger-codegen-maven-plugin maven 插件的版本。

modelOutput

 

目标输出路径（默认为 ${project.build.directory}/generated-sources/openapi）

modelPackage

io.swagger.client.model

用于生成的模型对象/类的软件包

modelNamePrefix

 

为模型类和枚举设置 pre- 或 suffix

modelNameSuffix

 

为模型类和枚举设置 pre- 或 suffix

modelWithXml

false

在生成的模型中启用 XML 注解（仅适用于为 JSON 和 XML 提供支持的库）

configOptions

 

将特定于语言的参数映射到 swagger-codegen-maven-plugin

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat