src/javax/xml/transform/sax/SAXSource.java

Print this page
rev 602 : 8047723: @since tag cleanup in jaxp
Reviewed-by:


  24  */
  25 
  26 package javax.xml.transform.sax;
  27 
  28 import javax.xml.transform.Source;
  29 import javax.xml.transform.stream.StreamSource;
  30 
  31 import org.xml.sax.InputSource;
  32 import org.xml.sax.XMLReader;
  33 
  34 /**
  35  * <p>Acts as an holder for SAX-style Source.</p>
  36  *
  37  * <p>Note that XSLT requires namespace support. Attempting to transform an
  38  * input source that is not
  39  * generated with a namespace-aware parser may result in errors.
  40  * Parsers can be made namespace aware by calling the
  41  * {@link javax.xml.parsers.SAXParserFactory#setNamespaceAware(boolean awareness)} method.</p>
  42  *
  43  * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>

  44  */
  45 public class SAXSource implements Source {
  46 
  47     /**
  48      * If {@link javax.xml.transform.TransformerFactory#getFeature}
  49      * returns true when passed this value as an argument,
  50      * the Transformer supports Source input of this type.
  51      */
  52     public static final String FEATURE =
  53         "http://javax.xml.transform.sax.SAXSource/feature";
  54 
  55     /**
  56      * <p>Zero-argument default constructor.  If this constructor is used, and
  57      * no SAX source is set using
  58      * {@link #setInputSource(InputSource inputSource)} , then the
  59      * <code>Transformer</code> will
  60      * create an empty source {@link org.xml.sax.InputSource} using
  61      * {@link org.xml.sax.InputSource#InputSource() new InputSource()}.</p>
  62      *
  63      * @see javax.xml.transform.Transformer#transform(Source xmlSource, Result outputTarget)




  24  */
  25 
  26 package javax.xml.transform.sax;
  27 
  28 import javax.xml.transform.Source;
  29 import javax.xml.transform.stream.StreamSource;
  30 
  31 import org.xml.sax.InputSource;
  32 import org.xml.sax.XMLReader;
  33 
  34 /**
  35  * <p>Acts as an holder for SAX-style Source.</p>
  36  *
  37  * <p>Note that XSLT requires namespace support. Attempting to transform an
  38  * input source that is not
  39  * generated with a namespace-aware parser may result in errors.
  40  * Parsers can be made namespace aware by calling the
  41  * {@link javax.xml.parsers.SAXParserFactory#setNamespaceAware(boolean awareness)} method.</p>
  42  *
  43  * @author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a>
  44  * @since 1.4
  45  */
  46 public class SAXSource implements Source {
  47 
  48     /**
  49      * If {@link javax.xml.transform.TransformerFactory#getFeature}
  50      * returns true when passed this value as an argument,
  51      * the Transformer supports Source input of this type.
  52      */
  53     public static final String FEATURE =
  54         "http://javax.xml.transform.sax.SAXSource/feature";
  55 
  56     /**
  57      * <p>Zero-argument default constructor.  If this constructor is used, and
  58      * no SAX source is set using
  59      * {@link #setInputSource(InputSource inputSource)} , then the
  60      * <code>Transformer</code> will
  61      * create an empty source {@link org.xml.sax.InputSource} using
  62      * {@link org.xml.sax.InputSource#InputSource() new InputSource()}.</p>
  63      *
  64      * @see javax.xml.transform.Transformer#transform(Source xmlSource, Result outputTarget)