XmlToXMLStreamReader Transformer

The XmlToXMLStreamReader transformer converts XML representations to a StAX XMLStreamReader. XMLStreamReaders allow XML to be parsed as a series of events that are "pulled" from the stream. It is very efficient.

This transformer supports the following input formats:

javax.xml.transform.Source.class
org.xml.sax.InputSource.class
org.dom4j.Document.class
org.w3c.dom.Document.class
org.w3c.dom.Element.class
org.mule.module.xml.transformer.DelayedResult.class
String
byte[]
InputStream

Examples

To use the transformer, you must declare a custom transformer element:

<custom-transformer name="XmlToXSR" class="org.mule.module.xml.transformer.XmlToXMLStreamReader"/>

You can also create a "reversible" XMLStreamReader:

<custom-transformer name="XmlToXSR" class="org.mule.module.xml.transformer.XmlToXMLStreamReader">
   <property key="reversible" value="true"/>
</custom-transformer>

This allows you to cache XML events and replay them:

MuleMessage message = ...;
ReversibleXMLStreamReader xsr = (ReversibleXMLStreamReader) message.getPayload();

// start caching events
xsr.setTracking(true);

// parse....
while (...) { xsr.next(); }

// Go back to the beginning of the XML document
xsr.reset();

....

// Don't cache events any more
xsr.setTracking(false);