40.3. Built-In Type Converters

This section describes the conversions supported by the master type converter. These conversions are built into the Apache Camel core.

Usually, the type converter is called through convenience functions, such as Message.getBody(Class<T> type) or Message.getHeader(String name, Class<T> type). It is also possible to invoke the master type converter directly. For example, if you have an exchange object, exchange, you could convert a given value to a String as shown in Example 40.4, “Converting a Value to a String”.

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 provides built-in type converters that perform conversions to and from the following basic types:

However, not all of these types are inter-convertible. The built-in converter is mainly focused on providing conversions from the File and String types. The File type can be converted to any of the preceding types, except Reader, Writer, and StringReader. The String type can be converted to File, byte[], ByteBuffer, InputStream, or StringReader. The conversion from String to File works by interpreting the string as a file name. The trio of String, byte[], and ByteBuffer are completely inter-convertible.

Apache Camel provides built-in type converters that perform conversions to and from the following collection types:

All permutations of conversions between the preceding collection types are supported.

Apache Camel provides built-in type converters that perform conversions to and from the following map types:

The preceding map types can also be converted into a set, of java.util.Set type, where the set elements are of the MapEntry<K,V> type.

You can perform type conversions to the following Document Object Model (DOM) types:

All permutations of conversions between the preceding DOM types are supported.

You can also perform conversions to the javax.xml.transform.sax.SAXSource type, which supports the SAX event-driven XML parser (see the SAX Web site for details). You can convert to SAXSource from the following types:

Apache Camel also enables you to implement your own custom type converters. For details on how to implement a custom type converter, see Chapter 42, Type Converters.