10.6. transformer

transformer 根据路由定义上声明的 Input Type 和/或 输出类型 执行声明性转换。默认 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. 支持的 Transformers

transformer描述

数据格式转换

使用数据格式进行转换

端点转换

使用端点转换

自定义 Transformer

通过使用自定义转换器类进行转换。

10.6.1.3. 常见选项

所有转换器都有以下常用选项，可按转换器指定受支持的数据类型：

重要

必须指定 fromType 和 toType 的 方案。

Name描述

scheme

xml 或 json 等数据模型的类型。例如，如果指定了 xml，则会为所有 java -> xml 和 xml -> java 转换应用转换器。

fromType

从中 转换的数据类型。

toType

转变为.

10.6.1.4. DataFormat Transformer 选项

Name描述

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);

XML DSL: 

<dataFormatTransformer fromType="java:com.example.Order" toType="csv:CSVOrder">
    <bindy id="csvdf" type="Csv" classType="com.example.Order"/>
</dataFormatTransformer>

10.6.2. 端点转换选项

Name描述

Ref

引用端点 ID

uri

端点 URI

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

transformer()
    .fromType("xml")
    .toType("json")
    .withUri("dozer:myDozer?mappingFile=myMapping.xml...");

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

<transformers>
<endpointTransformer ref="myDozerEndpoint" fromType="xml" toType="json"/>
</transformers>

10.6.3. 自定义转换选项

注意

transformer 必须是 org.apache.camel.spi.Transformer的子类

Name描述

Ref

引用自定义 Transformer bean ID

className

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

指定自定义 Transformer 类的示例：

Java DSL： 

transformer()
    .fromType("xml")
    .toType("json")
    .withJava(com.example.MyCustomTransformer.class);

XML DSL: 

<transformers>
<customTransformer className="com.example.MyCustomTransformer" fromType="xml" toType="json"/>
</transformers>

10.6.4. transformer 示例

本例分为两个部分，第一部分声明了 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");

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>

10.6.4.2. 第 II 部分

当 direct:abc 端点将消息发送到 direct:xyz 时，上面的转换器会应用到以下路由定义：

Java DSL： 

from("direct:abc")
    .inputType("xml:ABCOrder")
    .to("direct:xyz");
from("direct:xyz")
    .inputType("xml:XYZOrder")
    .to("somewhere:else");

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>