public class StAXSource extends Object implements Source
Acts as a holder for an XML Source in the
 form of a StAX reader,i.e.
 XMLStreamReader or XMLEventReader.
 StAXSource can be used in all cases that accept
 a Source, e.g. Transformer,
 Validator which accept
 Source as input.
 
StAXSources are consumed during processing
 and are not reusable.
XMLStreamReader, 
XMLEventReader| Modifier and Type | Field and Description | 
|---|---|
| static String | FEATUREIf  TransformerFactory.getFeature(String name)returns true when passed this value as an argument,
 the Transformer supports Source input of this type. | 
| Constructor and Description | 
|---|
| StAXSource(XMLEventReader xmlEventReader)Creates a new instance of a  StAXSourceby supplying anXMLEventReader. | 
| StAXSource(XMLStreamReader xmlStreamReader)Creates a new instance of a  StAXSourceby supplying anXMLStreamReader. | 
| Modifier and Type | Method and Description | 
|---|---|
| String | getSystemId()Get the system identifier used by this
  StAXSource. | 
| XMLEventReader | getXMLEventReader()Get the  XMLEventReaderused by thisStAXSource. | 
| XMLStreamReader | getXMLStreamReader()Get the  XMLStreamReaderused by thisStAXSource. | 
| void | setSystemId(String systemId)In the context of a  StAXSource, it is not appropriate
 to explicitly set the system identifier. | 
public static final String FEATURE
TransformerFactory.getFeature(String name)
 returns true when passed this value as an argument,
 the Transformer supports Source input of this type.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.
xmlEventReader - XMLEventReader used to create
   this StAXSource.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.
xmlStreamReader - XMLStreamReader used to create
   this StAXSource.IllegalArgumentException - If xmlStreamReader ==
   null.IllegalStateException - If xmlStreamReader
   is not in XMLStreamConstants.START_DOCUMENT or
   XMLStreamConstants.START_ELEMENT state.public XMLEventReader getXMLEventReader()
Get the XMLEventReader used by this
 StAXSource.
XMLEventReader will be null.
 if this StAXSource was created with a
 XMLStreamReader.
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.
XMLStreamReader used by this
   StAXSource.public void setSystemId(String systemId)
In the context of a StAXSource, it is not appropriate
 to explicitly set the system identifier.
 The XMLStreamReader or XMLEventReader
 used to construct this StAXSource determines the
 system identifier of the XML source.
An UnsupportedOperationException is always
 thrown by this method.
setSystemId in interface SourcesystemId - Ignored.UnsupportedOperationException - Is always
   thrown by this method.public String getSystemId()
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.
getSystemId in interface SourceStAXSource. Submit a bug or feature 
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
 Copyright © 1993, 2017, Oracle and/or its affiliates.  All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.