< prev index next >

src/java.xml/share/classes/javax/xml/transform/stax/StAXSource.java

Print this page




  27 
  28 import javax.xml.stream.XMLEventReader;
  29 import javax.xml.stream.XMLStreamConstants;
  30 import javax.xml.stream.XMLStreamException;
  31 import javax.xml.stream.XMLStreamReader;
  32 import javax.xml.stream.events.XMLEvent;
  33 import javax.xml.transform.Source;
  34 
  35 /**
  36  * <p>Acts as a holder for an XML {@link Source} in the
  37  * form of a StAX reader,i.e.
  38  * {@link XMLStreamReader} or {@link XMLEventReader}.
  39  * <code>StAXSource</code> can be used in all cases that accept
  40  * a <code>Source</code>, e.g. {@link javax.xml.transform.Transformer},
  41  * {@link javax.xml.validation.Validator} which accept
  42  * <code>Source</code> as input.
  43  *
  44  * <p><code>StAXSource</code>s are consumed during processing
  45  * and are not reusable.</p>
  46  *
  47  * @author <a href="mailto:Neeraj.Bajaj@Sun.com">Neeraj Bajaj</a>
  48  * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
  49  *
  50  * @see <a href="http://jcp.org/en/jsr/detail?id=173">
  51  *  JSR 173: Streaming API for XML</a>
  52  * @see XMLStreamReader
  53  * @see XMLEventReader
  54  *
  55  * @since 1.6
  56  */
  57 public class StAXSource implements Source {
  58 
  59     /** If {@link javax.xml.transform.TransformerFactory#getFeature(String name)}
  60      * returns true when passed this value as an argument,
  61      * the Transformer supports Source input of this type.
  62      */
  63     public static final String FEATURE =
  64         "http://javax.xml.transform.stax.StAXSource/feature";
  65 
  66     /** <p><code>XMLEventReader</code> to be used for source input.</p> */
  67     private XMLEventReader xmlEventReader = null;
  68 




  27 
  28 import javax.xml.stream.XMLEventReader;
  29 import javax.xml.stream.XMLStreamConstants;
  30 import javax.xml.stream.XMLStreamException;
  31 import javax.xml.stream.XMLStreamReader;
  32 import javax.xml.stream.events.XMLEvent;
  33 import javax.xml.transform.Source;
  34 
  35 /**
  36  * <p>Acts as a holder for an XML {@link Source} in the
  37  * form of a StAX reader,i.e.
  38  * {@link XMLStreamReader} or {@link XMLEventReader}.
  39  * <code>StAXSource</code> can be used in all cases that accept
  40  * a <code>Source</code>, e.g. {@link javax.xml.transform.Transformer},
  41  * {@link javax.xml.validation.Validator} which accept
  42  * <code>Source</code> as input.
  43  *
  44  * <p><code>StAXSource</code>s are consumed during processing
  45  * and are not reusable.</p>
  46  *
  47  * @author Neeraj Bajaj
  48  * @author Jeff Suttor
  49  *
  50  * @see <a href="http://jcp.org/en/jsr/detail?id=173">
  51  *  JSR 173: Streaming API for XML</a>
  52  * @see XMLStreamReader
  53  * @see XMLEventReader
  54  *
  55  * @since 1.6
  56  */
  57 public class StAXSource implements Source {
  58 
  59     /** If {@link javax.xml.transform.TransformerFactory#getFeature(String name)}
  60      * returns true when passed this value as an argument,
  61      * the Transformer supports Source input of this type.
  62      */
  63     public static final String FEATURE =
  64         "http://javax.xml.transform.stax.StAXSource/feature";
  65 
  66     /** <p><code>XMLEventReader</code> to be used for source input.</p> */
  67     private XMLEventReader xmlEventReader = null;
  68 


< prev index next >