StAXSource JDK 1.6)

Description

public class StAXSource

Acts as a holder for an XML Source in the form of a StAX reader,i.e.

See also: JSR 173: Streaming API for XML XMLStreamReader XMLEventReader

Constructors

public StAXSource (XMLEventReader xmlEventReader) throws XMLStreamException

Creates a new instance of a StAXSource by supplying an XMLEventReader.

XMLEventReader must be a non-null reference.

XMLEventReader must be in XMLStreamConstants.START_DOCUMENT or XMLStreamConstants.START_ELEMENT state.

Parameters:
- xmlEventReader - XMLEventReader used to create this StAXSource.
Throws:
- XMLStreamException - If xmlEventReader access throws an Exception.
- IllegalArgumentException - If xmlEventReader == null.
- IllegalStateException - If xmlEventReader is not in XMLStreamConstants.START_DOCUMENT or XMLStreamConstants.START_ELEMENT state.

public StAXSource (XMLStreamReader xmlStreamReader)

Creates a new instance of a StAXSource by supplying an XMLStreamReader.

XMLStreamReader must be a non-null reference.

XMLStreamReader must be in XMLStreamConstants.START_DOCUMENT or XMLStreamConstants.START_ELEMENT state.

Parameters:
- xmlStreamReader - XMLStreamReader used to create this StAXSource.
Throws:
- IllegalArgumentException - If xmlStreamReader == null.
- IllegalStateException - If xmlStreamReader is not in XMLStreamConstants.START_DOCUMENT or XMLStreamConstants.START_ELEMENT state.

Methods

Hide/Show inherited methods

public String getSystemId () [Specified in Source]

Get the system identifier used by this StAXSource.

The XMLStreamReader or XMLEventReader used to construct this StAXSource is queried to determine the system identifier of the XML source.

The system identifier may be null or an empty "" String.

Returns: System identifier used by this StAXSource.

public XMLEventReader getXMLEventReader ()

Get the XMLEventReader used by this StAXSource.

XMLEventReader will be null. if this StAXSource was created with a XMLStreamReader.

Returns: XMLEventReader used by this StAXSource.

public XMLStreamReader getXMLStreamReader ()

Get the XMLStreamReader used by this StAXSource.

XMLStreamReader will be null if this StAXSource was created with a XMLEventReader.

Returns: XMLStreamReader used by this StAXSource.

public void setSystemId (String systemId) [Specified in Source]

In the context of a StAXSource, it is not appropriate to explicitly set the system identifier.