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