34.3. 内置类型 Converters

本节论述了 master 类型转换器支持的转换。这些转换内置到 Apache Camel 内核中。

通常，类型转换器会通过方便功能调用，如 Message.getBody (Class<T> type) 或 Message.getHeader (String name, Class<T> type)。也可以直接调用 master 类型转换器。例如，如果您有一个交换对象，交换 了，可以将给定值转换为 String，如 例 34.4 “将值转换为字符串” 所示。

org.apache.camel.TypeConverter tc = exchange.getContext().getTypeConverter();
String str_value = tc.convertTo(String.class, value);

org.apache.camel.TypeConverter tc = exchange.getContext().getTypeConverter();
String str_value = tc.convertTo(String.class, value);

Apache Camel 提供内置类型转换器，可以从以下基本类型执行转换：

但是，并非所有这些类型的类型都相互连接。内置的转换器主要关注从文件和字符串类型提供 转换。文件类型 可转换为上述类型的任何类型，但 Reader、Writer 和 StringReader 除外。String 类型可转换为文件、 byte []、ByteBuffer、InputStream 或 StringReader。从 String 转换到 文件 可以解释字符串作为文件名。String trio、byte[] 和 ByteBuffer 完全相互连接。

Apache Camel 提供内置类型转换器，可以从以下集合类型执行转换：

支持在上述集合类型间转换的所有转换。

Apache Camel 提供内置类型转换器，可以从以下映射类型执行转换：

前面的 map 类型也可以转换为 java.util.Set 类型的集合，其中集合元素是 MapEntry<K,V> 类型。

您可以对以下文档对象模型(DOM)类型执行类型转换：

支持前面的 DOM 类型之间的所有转换。

您还可以对 javax.xml.transform.sax.SAXSource 类型执行转换，该类型支持 SAX 事件驱动的 XML 解析器（请参阅 SAX 网站 了解详细信息）。您可以从以下类型转换为 SAXSource ：

Camel 为执行 String 提供了一种类型 转换程序 来枚举类型转换，其中字符串值将被转换为来自指定枚举类的匹配枚举常数（匹配 区分大小写）。在转换消息正文时很少需要这种类型转换器，但 Apache Camel 在内部使用这种类型来选择特定的选项。

例如，在设置日志记录级别选项时，值 INFO 将转换为枚举常量：

<to uri="log:foo?level=INFO"/>

<to uri="log:foo?level=INFO"/>

因为 enum 类型转换器不区分大小写，因此以下任意一种替代项都可以正常工作：

<to uri="log:foo?level=info"/>
<to uri="log:foo?level=INfo"/>
<to uri="log:foo?level=InFo"/>

<to uri="log:foo?level=info"/>
<to uri="log:foo?level=INfo"/>
<to uri="log:foo?level=InFo"/>

Apache Camel 还允许您实施自己的自定义类型转换器。有关如何实现自定义类型转换器的详情，请参考 第 36 章 类型 Converters。