javanet.staxutils

Class StAXSource

java.lang.Object

javax.xml.transform.sax.SAXSource

javanet.staxutils.StAXSource

All Implemented Interfaces:

Source

public class StAXSource
extends SAXSource

A JAXP Source implementation that wraps the specified XMLStreamReader or XMLEventReader for use by applications that expext a Source.

The fact that StAXSource derives from SAXSource is an implementation detail. Thus in general applications are strongly discouraged from accessing methods defined on SAXSource. In particular:

• The setXMLReader and setInputSource methods shall never be called.
• The XMLReader object obtained by the getXMLReader method shall be used only for parsing the InputSource object returned by the getInputSource method.
• The InputSource object obtained by the getInputSource method shall be used only for being parsed by the XMLReader object returned by the getXMLReader method.

Example:

 // create a StAXSource
 XMLStreamReader reader = XMLInputFactory.newInstance().createXMLStreamReader(
     new FileReader(args[0]));
 Source staxSource = new StAXSource(reader);
 
 // createa StreamResult
 Result streamResult = new StreamResult(System.out);
 
 // run the transform
 TransformerFactory.newInstance().newTransformer().transform(staxSource, streamResult);
 

Version:

1.0

Author:

Ryan.Shoemaker@Sun.COM

Field Summary

Fields inherited from class javax.xml.transform.sax.SAXSource

FEATURE

Constructor Summary

Constructors

Constructor and Description
StAXSource(XMLEventReader reader) Creates a new Source for the given XMLEventReader.
StAXSource(XMLStreamReader reader) Creates a new Source for the given XMLStreamReader.

Method Summary

Methods inherited from class javax.xml.transform.sax.SAXSource

getInputSource, getSystemId, getXMLReader, setInputSource, setSystemId, setXMLReader, sourceToInputSource

Methods inherited from class java.lang.Object

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

Constructor Detail

StAXSource

public StAXSource(XMLStreamReader reader)

Creates a new Source for the given XMLStreamReader. The XMLStreamReader must be pointing at either a XMLStreamConstants.START_DOCUMENT or XMLStreamConstants.START_ELEMENT event.

Parameters:

reader - XMLStreamReader that will be exposed as a Source

Throws:

IllegalArgumentException - iff the reader is null

IllegalStateException - iff the reader is not pointing at either a START_DOCUMENT or START_ELEMENT event

StAXSource

public StAXSource(XMLEventReader reader)

Creates a new Source for the given XMLEventReader. The XMLEventReader must be pointing at either a XMLStreamConstants.START_DOCUMENT or XMLStreamConstants.START_ELEMENT event.

Parameters:

reader - XMLEventReader that will be exposed as a Source

Throws:

IllegalArgumentException - iff the reader is null

IllegalStateException - iff the reader is not pointing at either a START_DOCUEMENT or START_ELEMENT event