org.springframework.xml.transform
Class TraxUtils

java.lang.Object
  org.springframework.xml.transform.TraxUtils

public abstract class TraxUtils
extends Object

Convenient utility methods for dealing with TrAX.

Since:

1.5.0

Author:

Arjen Poutsma

Nested Class Summary

static interface	TraxUtils.ResultCallback Callback interface invoked on each sort of Result.
static interface	TraxUtils.SourceCallback Callback interface invoked on each sort of Source.

Constructor Summary

TraxUtils()

Method Summary

static Source	createStaxSource(XMLEventReader eventReader) Creates a StAX Source for the given XMLEventReader.
static Source	createStaxSource(XMLStreamReader streamReader) Creates a StAX Source for the given XMLStreamReader.
static void	doWithResult(Result result, TraxUtils.ResultCallback callback) Performs the given callback operation on a Result.
static void	doWithSource(Source source, TraxUtils.SourceCallback callback) Performs the given callback operation on a Source.
static Document	getDocument(DOMSource source) Returns the Document of the given DOMSource.
static XMLEventReader	getXMLEventReader(Source source) Returns the XMLEventReader for the given StAX Source.
static XMLEventWriter	getXMLEventWriter(Result result) Returns the XMLEventWriter for the given StAX Result.
static XMLStreamReader	getXMLStreamReader(Source source) Returns the XMLStreamReader for the given StAX Source.
static XMLStreamWriter	getXMLStreamWriter(Result result) Returns the XMLStreamWriter for the given StAX Result.
static boolean	isStaxResult(Result result) Indicates whether the given Result is a StAX Result.
static boolean	isStaxSource(Source source) Indicates whether the given Source is a StAX Source.

Methods inherited from class java.lang.Object

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

Constructor Detail

TraxUtils

public TraxUtils()

Method Detail

isStaxSource

public static boolean isStaxSource(Source source)

Indicates whether the given Source is a StAX Source.

Returns:

true if source is a Spring-WS StaxSource or JAXP 1.4 StAXSource; false otherwise.

isStaxResult

public static boolean isStaxResult(Result result)

Indicates whether the given Result is a StAX Result.

Returns:

true if result is a Spring-WS StaxResult or JAXP 1.4 StAXResult; false otherwise.

getXMLStreamReader

public static XMLStreamReader getXMLStreamReader(Source source)

Returns the XMLStreamReader for the given StAX Source.

Parameters:

source - a Spring-WS StaxSource or StAXSource

Returns:

the XMLStreamReader

Throws:

IllegalArgumentException - if source is neither a Spring-WS StaxSource or StAXSource

getXMLEventReader

public static XMLEventReader getXMLEventReader(Source source)

Returns the XMLEventReader for the given StAX Source.

Parameters:

source - a Spring-WS StaxSource or StAXSource

Returns:

the XMLEventReader

Throws:

IllegalArgumentException - if source is neither a Spring-WS StaxSource or StAXSource

getXMLStreamWriter

public static XMLStreamWriter getXMLStreamWriter(Result result)

Returns the XMLStreamWriter for the given StAX Result.

Parameters:

result - a Spring-WS StaxResult or StAXResult

Returns:

the XMLStreamReader

Throws:

IllegalArgumentException - if source is neither a Spring-WS StaxResult or StAXResult

getXMLEventWriter

public static XMLEventWriter getXMLEventWriter(Result result)

Returns the XMLEventWriter for the given StAX Result.

Parameters:

result - a Spring-WS StaxResult or StAXResult

Returns:

the XMLStreamReader

Throws:

IllegalArgumentException - if source is neither a Spring-WS StaxResult or StAXResult

createStaxSource

public static Source createStaxSource(XMLStreamReader streamReader)

Creates a StAX Source for the given XMLStreamReader. Returns a StAXSource under JAXP 1.4 or higher, or a StaxSource otherwise.

Parameters:

streamReader - the StAX stream reader

Returns:

a source wrapping streamReader

createStaxSource

public static Source createStaxSource(XMLEventReader eventReader)
                               throws XMLStreamException

Creates a StAX Source for the given XMLEventReader. Returns a StAXSource under JAXP 1.4 or higher, or a StaxSource otherwise.

Parameters:

eventReader - the StAX event reader

Returns:

a source wrapping streamReader

Throws:

XMLStreamException - in case of StAX errors

getDocument

public static Document getDocument(DOMSource source)

Returns the Document of the given DOMSource.

Parameters:

source - the DOM source

Returns:

the document

doWithSource

public static void doWithSource(Source source,
                                TraxUtils.SourceCallback callback)
                         throws XMLStreamException,
                                IOException,
                                SAXException

Performs the given callback operation on a Source. Supports both the JAXP 1.4 StAXSource and the Spring-WS StaxSource.

Parameters:

source - source to look at

callback - the callback to invoke for each kind of source

Throws:

XMLStreamException

IOException

SAXException

doWithResult

public static void doWithResult(Result result,
                                TraxUtils.ResultCallback callback)
                         throws XMLStreamException,
                                IOException,
                                SAXException

Performs the given callback operation on a Result. Supports both the JAXP 1.4 StAXResult and the Spring-WS StaxResult.

Parameters:

result - result to look at

callback - the callback to invoke for each kind of result

Throws:

XMLStreamException

IOException

SAXException