Chapter 43. Base64 DataFormat
Available as of Camel version 2.11
The Base64 data format is used for base64 encoding and decoding.
43.1. Options
The Base64 dataformat supports 4 options, which are listed below.
| Name | Default | Java Type | Description |
|---|---|---|---|
| lineLength |
|
| To specific a maximum line length for the encoded data. By default 76 is used. |
| lineSeparator |
| The line separators to use. Uses new line characters (CRLF) by default. | |
| urlSafe |
|
| Instead of emitting '' and '/' we emit '-' and '_' respectively. urlSafe is only applied to encode operations. Decoding seamlessly handles both modes. Is by default false. |
| contentTypeHeader |
|
| Whether the data format should set the Content-Type header with the type from the data format if the data format is capable of doing so. For example application/xml for data formats marshalling to XML, or application/json for data formats marshalling to JSon etc. |
43.2. Spring Boot Auto-Configuration
The component supports 5 options, which are listed below.
| Name | Description | Default | Type |
|---|---|---|---|
| camel.dataformat.base64.content-type-header | Whether the data format should set the Content-Type header with the type from the data format if the data format is capable of doing so. For example application/xml for data formats marshalling to XML, or application/json for data formats marshalling to JSon etc. | false | Boolean |
| camel.dataformat.base64.enabled | Enable base64 dataformat | true | Boolean |
| camel.dataformat.base64.line-length | To specific a maximum line length for the encoded data. By default 76 is used. | 76 | Integer |
| camel.dataformat.base64.line-separator | The line separators to use. Uses new line characters (CRLF) by default. | String | |
| camel.dataformat.base64.url-safe | Instead of emitting '' and '/' we emit '-' and '_' respectively. urlSafe is only applied to encode operations. Decoding seamlessly handles both modes. Is by default false. | false | Boolean |
ND
In Spring DSL, you configure the data format using this tag:
<camelContext>
<dataFormats>
<!-- for a newline character (\n), use the HTML entity notation coupled with the ASCII code. -->
<base64 lineSeparator=" " id="base64withNewLine" />
<base64 lineLength="64" id="base64withLineLength64" />
</dataFormats>
...
</camelContext>Then you can use it later by its reference:
<route>
<from uri="direct:startEncode" />
<marshal ref="base64withLineLength64" />
<to uri="mock:result" />
</route>Most of the time, you won’t need to declare the data format if you use the default options. In that case, you can declare the data format inline as shown below.
43.3. Marshal
In this example we marshal the file content to base64 object.
from("file://data.bin")
.marshal().base64()
.to("jms://myqueue");In Spring DSL:
<from uri="file://data.bin">
<marshal>
<base64/>
</marshal>
<to uri="jms://myqueue"/>43.4. Unmarshal
In this example we unmarshal the payload from the JMS queue to a byte[] object, before its processed by the newOrder processor.
from("jms://queue/order")
.unmarshal().base64()
.process("newOrder");In Spring DSL:
<from uri="jms://queue/order">
<unmarshal>
<base64/>
</unmarshal>
<to uri="bean:newOrder"/>43.5. Dependencies
To use Base64 in your Camel routes you need to add a dependency on camel-base64 which implements this data format.
If you use Maven you can just add the following to your pom.xml:
<dependency> <groupId>org.apache.camel</groupId> <artifactId>camel-base64</artifactId> <version>x.x.x</version> <!-- use the same version as your Camel core version --> </dependency>
