org.springframework.util.xml

Class StaxUtils

java.lang.Object

org.springframework.util.xml.StaxUtils

public abstract class StaxUtils
extends java.lang.Object

Convenience methods for working with the StAX API. Partly historic due to JAXP 1.3 compatibility; as of Spring 4.0, relying on JAXP 1.4 as included in JDK 1.6 and higher.

In particular, methods for using StAX (javax.xml.stream) in combination with the TrAX API (javax.xml.transform), and converting StAX readers/writers into SAX readers/handlers and vice-versa.

Since:

3.0

Author:

Arjen Poutsma, Juergen Hoeller

Constructor Summary

Constructors

Constructor and Description
StaxUtils()

Method Summary

Modifier and Type	Method and Description
static org.xml.sax.ContentHandler	createContentHandler(javax.xml.stream.XMLEventWriter eventWriter) Create a SAX ContentHandler that writes events to the given StAX XMLEventWriter.
static org.xml.sax.ContentHandler	createContentHandler(javax.xml.stream.XMLStreamWriter streamWriter) Create a SAX ContentHandler that writes to the given StAX XMLStreamWriter.
static javax.xml.transform.Result	createCustomStaxResult(javax.xml.stream.XMLEventWriter eventWriter) Create a custom, non-JAXP 1.4 StAX Result for the given XMLEventWriter.
static javax.xml.transform.Result	createCustomStaxResult(javax.xml.stream.XMLStreamWriter streamWriter) Create a custom, non-JAXP 1.4 StAX Result for the given XMLStreamWriter.
static javax.xml.transform.Source	createCustomStaxSource(javax.xml.stream.XMLEventReader eventReader) Create a custom, non-JAXP 1.4 StAX Source for the given XMLEventReader.
static javax.xml.transform.Source	createCustomStaxSource(javax.xml.stream.XMLStreamReader streamReader) Create a custom, non-JAXP 1.4 StAX Source for the given XMLStreamReader.
static javax.xml.stream.XMLInputFactory	createDefensiveInputFactory() Create an XMLInputFactory with Spring's defensive setup, i.e.
static <T extends javax.xml.stream.XMLInputFactory> T	createDefensiveInputFactory(java.util.function.Supplier<T> instanceSupplier) Variant of createDefensiveInputFactory() with a custom instance.
static javax.xml.stream.XMLStreamReader	createEventStreamReader(javax.xml.stream.XMLEventReader eventReader) Return a XMLStreamReader that reads from a XMLEventReader.
static javax.xml.stream.XMLStreamWriter	createEventStreamWriter(javax.xml.stream.XMLEventWriter eventWriter) Return a XMLStreamWriter that writes to a XMLEventWriter.
static javax.xml.stream.XMLStreamWriter	createEventStreamWriter(javax.xml.stream.XMLEventWriter eventWriter, javax.xml.stream.XMLEventFactory eventFactory) Return a XMLStreamWriter that writes to a XMLEventWriter.
static javax.xml.transform.Result	createStaxResult(javax.xml.stream.XMLEventWriter eventWriter) Create a JAXP 1.4 StAXResult for the given XMLEventWriter.
static javax.xml.transform.Result	createStaxResult(javax.xml.stream.XMLStreamWriter streamWriter) Create a JAXP 1.4 StAXResult for the given XMLStreamWriter.
static javax.xml.transform.Source	createStaxSource(javax.xml.stream.XMLEventReader eventReader) Create a JAXP 1.4 StAXSource for the given XMLEventReader.
static javax.xml.transform.Source	createStaxSource(javax.xml.stream.XMLStreamReader streamReader) Create a JAXP 1.4 StAXSource for the given XMLStreamReader.
static javax.xml.stream.XMLEventReader	createXMLEventReader(java.util.List<javax.xml.stream.events.XMLEvent> events) Create a XMLEventReader from the given list of XMLEvent.
static org.xml.sax.XMLReader	createXMLReader(javax.xml.stream.XMLEventReader eventReader) Create a SAX XMLReader that reads from the given StAX XMLEventReader.
static org.xml.sax.XMLReader	createXMLReader(javax.xml.stream.XMLStreamReader streamReader) Create a SAX XMLReader that reads from the given StAX XMLStreamReader.
static javax.xml.stream.XMLEventReader	getXMLEventReader(javax.xml.transform.Source source) Return the XMLEventReader for the given StAX Source.
static javax.xml.stream.XMLEventWriter	getXMLEventWriter(javax.xml.transform.Result result) Return the XMLEventWriter for the given StAX Result.
static javax.xml.stream.XMLStreamReader	getXMLStreamReader(javax.xml.transform.Source source) Return the XMLStreamReader for the given StAX Source.
static javax.xml.stream.XMLStreamWriter	getXMLStreamWriter(javax.xml.transform.Result result) Return the XMLStreamWriter for the given StAX Result.
static boolean	isStaxResult(javax.xml.transform.Result result) Indicate whether the given Result is a JAXP 1.4 StAX Result or custom StAX Result.
static boolean	isStaxSource(javax.xml.transform.Source source) Indicate whether the given Source is a JAXP 1.4 StAX Source or custom StAX Source.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StaxUtils

public StaxUtils()

Method Detail

createDefensiveInputFactory

public static javax.xml.stream.XMLInputFactory createDefensiveInputFactory()

Create an XMLInputFactory with Spring's defensive setup, i.e. no support for the resolution of DTDs and external entities.

Returns:

a new defensively initialized input factory instance to use

Since:

5.0

createDefensiveInputFactory

public static <T extends javax.xml.stream.XMLInputFactory> T createDefensiveInputFactory(java.util.function.Supplier<T> instanceSupplier)

Variant of createDefensiveInputFactory() with a custom instance.

Parameters:

instanceSupplier - supplier for the input factory instance

Returns:

a new defensively initialized input factory instance to use

Since:

5.0.12

createStaxSource

public static javax.xml.transform.Source createStaxSource(javax.xml.stream.XMLStreamReader streamReader)

Create a JAXP 1.4 StAXSource for the given XMLStreamReader.

Parameters:

streamReader - the StAX stream reader

Returns:

a source wrapping the streamReader

createStaxSource

public static javax.xml.transform.Source createStaxSource(javax.xml.stream.XMLEventReader eventReader)
                                                   throws javax.xml.stream.XMLStreamException

Create a JAXP 1.4 StAXSource for the given XMLEventReader.

Parameters:

eventReader - the StAX event reader

Returns:

a source wrapping the eventReader

Throws:

javax.xml.stream.XMLStreamException

createCustomStaxSource

public static javax.xml.transform.Source createCustomStaxSource(javax.xml.stream.XMLStreamReader streamReader)

Create a custom, non-JAXP 1.4 StAX Source for the given XMLStreamReader.

Parameters:

streamReader - the StAX stream reader

Returns:

a source wrapping the streamReader

createCustomStaxSource

public static javax.xml.transform.Source createCustomStaxSource(javax.xml.stream.XMLEventReader eventReader)

Create a custom, non-JAXP 1.4 StAX Source for the given XMLEventReader.

Parameters:

eventReader - the StAX event reader

Returns:

a source wrapping the eventReader

isStaxSource

public static boolean isStaxSource(javax.xml.transform.Source source)

Indicate whether the given Source is a JAXP 1.4 StAX Source or custom StAX Source.

Returns:

true if source is a JAXP 1.4 StAXSource or custom StAX Source; false otherwise

getXMLStreamReader

@Nullable
public static javax.xml.stream.XMLStreamReader getXMLStreamReader(javax.xml.transform.Source source)

Return the XMLStreamReader for the given StAX Source.

Parameters:

source - a JAXP 1.4 StAXSource

Returns:

the XMLStreamReader

Throws:

java.lang.IllegalArgumentException - if source isn't a JAXP 1.4 StAXSource or custom StAX Source

getXMLEventReader

@Nullable
public static javax.xml.stream.XMLEventReader getXMLEventReader(javax.xml.transform.Source source)

Return the XMLEventReader for the given StAX Source.

Parameters:

source - a JAXP 1.4 StAXSource

Returns:

the XMLEventReader

Throws:

java.lang.IllegalArgumentException - if source isn't a JAXP 1.4 StAXSource or custom StAX Source

createStaxResult

public static javax.xml.transform.Result createStaxResult(javax.xml.stream.XMLStreamWriter streamWriter)

Create a JAXP 1.4 StAXResult for the given XMLStreamWriter.

Parameters:

streamWriter - the StAX stream writer

Returns:

a result wrapping the streamWriter

createStaxResult

public static javax.xml.transform.Result createStaxResult(javax.xml.stream.XMLEventWriter eventWriter)

Create a JAXP 1.4 StAXResult for the given XMLEventWriter.

Parameters:

eventWriter - the StAX event writer

Returns:

a result wrapping streamReader

createCustomStaxResult

public static javax.xml.transform.Result createCustomStaxResult(javax.xml.stream.XMLStreamWriter streamWriter)

Create a custom, non-JAXP 1.4 StAX Result for the given XMLStreamWriter.

Parameters:

streamWriter - the StAX stream writer

Returns:

a source wrapping the streamWriter

createCustomStaxResult

public static javax.xml.transform.Result createCustomStaxResult(javax.xml.stream.XMLEventWriter eventWriter)

Create a custom, non-JAXP 1.4 StAX Result for the given XMLEventWriter.

Parameters:

eventWriter - the StAX event writer

Returns:

a source wrapping the eventWriter

isStaxResult

public static boolean isStaxResult(javax.xml.transform.Result result)

Indicate whether the given Result is a JAXP 1.4 StAX Result or custom StAX Result.

Returns:

true if result is a JAXP 1.4 StAXResult or custom StAX Result; false otherwise

getXMLStreamWriter

@Nullable
public static javax.xml.stream.XMLStreamWriter getXMLStreamWriter(javax.xml.transform.Result result)

Return the XMLStreamWriter for the given StAX Result.

Parameters:

result - a JAXP 1.4 StAXResult

Returns:

the XMLStreamReader

Throws:

java.lang.IllegalArgumentException - if source isn't a JAXP 1.4 StAXResult or custom StAX Result

getXMLEventWriter

@Nullable
public static javax.xml.stream.XMLEventWriter getXMLEventWriter(javax.xml.transform.Result result)

Return the XMLEventWriter for the given StAX Result.

Parameters:

result - a JAXP 1.4 StAXResult

Returns:

the XMLStreamReader

Throws:

java.lang.IllegalArgumentException - if source isn't a JAXP 1.4 StAXResult or custom StAX Result

createXMLEventReader

public static javax.xml.stream.XMLEventReader createXMLEventReader(java.util.List<javax.xml.stream.events.XMLEvent> events)

Create a XMLEventReader from the given list of XMLEvent.

Parameters:

events - the list of XMLEvents.

Returns:

an XMLEventReader that reads from the given events

Since:

5.0

createContentHandler

public static org.xml.sax.ContentHandler createContentHandler(javax.xml.stream.XMLStreamWriter streamWriter)

Create a SAX ContentHandler that writes to the given StAX XMLStreamWriter.

Parameters:

streamWriter - the StAX stream writer

Returns:

a content handler writing to the streamWriter

createContentHandler

public static org.xml.sax.ContentHandler createContentHandler(javax.xml.stream.XMLEventWriter eventWriter)

Create a SAX ContentHandler that writes events to the given StAX XMLEventWriter.

Parameters:

eventWriter - the StAX event writer

Returns:

a content handler writing to the eventWriter

createXMLReader

public static org.xml.sax.XMLReader createXMLReader(javax.xml.stream.XMLStreamReader streamReader)

Create a SAX XMLReader that reads from the given StAX XMLStreamReader.

Parameters:

streamReader - the StAX stream reader

Returns:

a XMLReader reading from the streamWriter

createXMLReader

public static org.xml.sax.XMLReader createXMLReader(javax.xml.stream.XMLEventReader eventReader)

Create a SAX XMLReader that reads from the given StAX XMLEventReader.

Parameters:

eventReader - the StAX event reader

Returns:

a XMLReader reading from the eventWriter

createEventStreamReader

public static javax.xml.stream.XMLStreamReader createEventStreamReader(javax.xml.stream.XMLEventReader eventReader)
                                                                throws javax.xml.stream.XMLStreamException

Return a XMLStreamReader that reads from a XMLEventReader. Useful because the StAX XMLInputFactory allows one to create an event reader from a stream reader, but not vice-versa.

Returns:

a stream reader that reads from an event reader

Throws:

javax.xml.stream.XMLStreamException

createEventStreamWriter

public static javax.xml.stream.XMLStreamWriter createEventStreamWriter(javax.xml.stream.XMLEventWriter eventWriter)

Return a XMLStreamWriter that writes to a XMLEventWriter.

Returns:

a stream writer that writes to an event writer

Since:

3.2

createEventStreamWriter

public static javax.xml.stream.XMLStreamWriter createEventStreamWriter(javax.xml.stream.XMLEventWriter eventWriter,
                                                                       javax.xml.stream.XMLEventFactory eventFactory)

Return a XMLStreamWriter that writes to a XMLEventWriter.

Returns:

a stream writer that writes to an event writer

Since:

3.0.5