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

10.6. transformer

转换器根据路由定义上的声明的输入类型和/或输出类型执行消息声明性转换。 默认 camel 消息实现 DataTypeAware，其中包含 DataType 表示的消息类型。

10.6.1. Transformer 的工作原理？
复制链接

路由定义声明 输入类型和 /或 输出类型。如果输入类型和/或 输出类型 与运行时的消息类型不同，则 camel 内部处理器会查找 Transformer。Transformer 将当前消息类型转换为预期的消息类型。当消息被成功转换后，或者消息已处于预期类型后，则会更新消息数据类型。

10.6.1.1. 数据类型格式
复制链接

数据类型格式为 scheme:name，其中 scheme 是 java、xml 或 json 等数据模型类型，name 是数据类型名称。

注意

如果您只指定 方案，则它会与该方案的所有数据类型匹配。

10.6.1.2. 支持的 Transformer
复制链接

Expand
transformer描述

Data Format Transformer

使用 Data Format 转换

endpoint Transformer

使用 Endpoint 转换

custom Transformer

使用自定义转换器类转换。

10.6.1.3. 常见选项
复制链接

所有转换器都有以下常用选项，通过转换器指定受支持的数据类型。

重要

必须指定 从Type 和 toType 的 方案。

Expand
名称描述

scheme

xml 或 json 等数据模型类型。例如，如果指定了 xml，则转换程序将适用于所有 java -> xml 和 xml -> java 转换。

fromType

从中 转换的数据类型。

toType

要 转换为的数据类型。

10.6.1.4. DataFormat Transformer 选项
复制链接

Expand
名称描述

type

数据格式类型

ref

引用数据格式 ID

指定 bindy DataFormat 类型的示例：

Java DSL： 

BindyDataFormat bindy = new BindyDataFormat();
bindy.setType(BindyType.Csv);
bindy.setClassType(com.example.Order.class);
transformer()
    .fromType(com.example.Order.class)
    .toType("csv:CSVOrder")
    .withDataFormat(bindy);
Copy to Clipboard Toggle word wrap

XML DSL： 

<dataFormatTransformer fromType="java:com.example.Order" toType="csv:CSVOrder">
    <bindy id="csvdf" type="Csv" classType="com.example.Order"/>
</dataFormatTransformer>
Copy to Clipboard Toggle word wrap

10.6.2. endpoint Transformer 选项
复制链接

Expand
名称描述

ref

引用端点 ID

uri

端点 URI

在 Java DSL 中指定端点 URI 的示例： 

transformer()
    .fromType("xml")
    .toType("json")
    .withUri("dozer:myDozer?mappingFile=myMapping.xml...");
Copy to Clipboard Toggle word wrap

在 XML DSL 中指定端点 ref 的示例： 

<transformers>
<endpointTransformer ref="myDozerEndpoint" fromType="xml" toType="json"/>
</transformers>
Copy to Clipboard Toggle word wrap

10.6.3. custom Transformer 选项
复制链接

注意

转换器必须是 org.apache.camel.spi.Transformer的子类

Expand
名称描述

ref

引用自定义 Transformer bean ID

className

自定义 Transformer 类的完全限定类名称

指定 custom Transformer 类的示例：

Java DSL： 

transformer()
    .fromType("xml")
    .toType("json")
    .withJava(com.example.MyCustomTransformer.class);
Copy to Clipboard Toggle word wrap

XML DSL： 

<transformers>
<customTransformer className="com.example.MyCustomTransformer" fromType="xml" toType="json"/>
</transformers>
Copy to Clipboard Toggle word wrap

10.6.4. 转换器示例
复制链接

这个示例分为两个部分，第一部分声明了 Endpoint Transformer，它转换了消息。第二部分演示了转换程序如何应用到路由。

10.6.4.1. 第 I 部分
复制链接

声明使用 xslt 组件从 xml:ABCOrder 转换为 xml:XYZOrder 的 Endpoint Transformer。

Java DSL： 

transformer()
    .fromType("xml:ABCOrder")
    .toType("xml:XYZOrder")
    .withUri("xslt:transform.xsl");
Copy to Clipboard Toggle word wrap

XML DSL： 

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
    <transformers>
        <endpointTransformer uri="xslt:transform.xsl" fromType="xml:ABCOrder" toType="xml:XYZOrder"/>
    </transformers>
    ....
</camelContext>
Copy to Clipboard Toggle word wrap

10.6.4.2. 第 II 部分
复制链接

当 direct:abc 端点发送消息来 direct:abc 端点将上述转换程序应用于以下路由定义：

Java DSL： 

from("direct:abc")
    .inputType("xml:ABCOrder")
    .to("direct:xyz");
from("direct:xyz")
    .inputType("xml:XYZOrder")
    .to("somewhere:else");
Copy to Clipboard Toggle word wrap

XML DSL： 

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
    <route>
        <from uri="direct:abc"/>
        <inputType urn="xml:ABCOrder"/>
        <to uri="direct:xyz"/>
    </route>
    <route>
        <from uri="direct:xyz"/>
        <inputType urn="xml:XYZOrder"/>
        <to uri="somewhere:else"/>
    </route>
</camelContext>
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat