Iterate over a collection using JAXB and StAX - 6.3

Talend ESB Mediation Developer Guide

Talend Data Fabric
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Design and Development
Talend ESB

First we suppose you have JAXB objects.

For instance a list of records in a wrapper object:

import java.util.ArrayList;
import java.util.List;
import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
@XmlRootElement(name = "records")
public class Records {
    @XmlElement(required = true)
    protected List<Record> record;
    public List<Record> getRecord() {
        if (record == null) {
            record = new ArrayList<Record>();
        return record;


import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlType;
@XmlType(name = "record", propOrder = { "key", "value" })
public class Record {
    @XmlAttribute(required = true)
    protected String key;
    @XmlAttribute(required = true)
    protected String value;
    public String getKey() {
        return key;
    public void setKey(String key) {
        this.key = key;
    public String getValue() {
        return value;
    public void setValue(String value) {
        this.value = value;

Then you get a XML file to process:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <record value="v0" key="0"/>
  <record value="v1" key="1"/>
  <record value="v2" key="2"/>
  <record value="v3" key="3"/>
  <record value="v4" key="4"/>
  <record value="v5" key="5"/>

The StAX component provides an StAXBuilder which can be used when iterating XML elements with the Camel Splitter


Where stax is a static method on org.apache.camel.component.stax.StAXBuilder which you can static import in the Java code. The stax builder is by default namespace aware on the XMLReader it uses. From Camel 2.11.1 onwards you can turn this off by setting the boolean parameter to false, as shown below:

    .split(stax(Record.class, false)).streaming()

The previous example with XML DSL

The example above could be implemented as follows in XML DSL

<!-- use STaXBuilder to create the expression we want to use in the route below for 
splitting the XML file -->
<!-- notice we use the factory-method to define the stax method, and to pass in the 
parameter as a constructor-arg -->
<bean id="staxRecord" class="org.apache.camel.component.stax.StAXBuilder" factory-
  <!-- FQN class name of the POJO with the JAXB annotations -->
  <constructor-arg index="0" value="org.apache.camel.component.stax.model.Record"/>
<camelContext xmlns="">
    <!-- pickup XML files -->
    <from uri="file:target/in"/>
    <split streaming="true">
      <!-- split the file using StAX (ref to bean above) -->
      <!-- and use streaming mode in the splitter -->
      <!-- and send each splitted to a mock endpoint, which will be a Record POJO 
      instance -->
      <to uri="mock:records"/>