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

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


  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.xml.transform.sax;
  27 
  28 import javax.xml.transform.Result;
  29 import javax.xml.transform.Transformer;
  30 
  31 import org.xml.sax.ContentHandler;
  32 import org.xml.sax.DTDHandler;
  33 import org.xml.sax.ext.LexicalHandler;
  34 
  35 /**
  36  * A TransformerHandler
  37  * listens for SAX ContentHandler parse events and transforms
  38  * them to a Result.


  39  */
  40 public interface TransformerHandler
  41     extends ContentHandler, LexicalHandler, DTDHandler {
  42 
  43     /**
  44      * <p>Set  the <code>Result</code> associated with this
  45      * <code>TransformerHandler</code> to be used for the transformation.</p>
  46      *
  47      * @param result A <code>Result</code> instance, should not be
  48      *   <code>null</code>.
  49      *
  50      * @throws IllegalArgumentException if result is invalid for some reason.
  51      */
  52     public void setResult(Result result) throws IllegalArgumentException;
  53 
  54     /**
  55      * Set the base ID (URI or system ID) from where relative
  56      * URLs will be resolved.
  57      * @param systemID Base URI for the source tree.
  58      */


  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javax.xml.transform.sax;
  27 
  28 import javax.xml.transform.Result;
  29 import javax.xml.transform.Transformer;
  30 
  31 import org.xml.sax.ContentHandler;
  32 import org.xml.sax.DTDHandler;
  33 import org.xml.sax.ext.LexicalHandler;
  34 
  35 /**
  36  * A TransformerHandler
  37  * listens for SAX ContentHandler parse events and transforms
  38  * them to a Result.
  39  *
  40  * @since 1.4
  41  */
  42 public interface TransformerHandler
  43     extends ContentHandler, LexicalHandler, DTDHandler {
  44 
  45     /**
  46      * <p>Set  the <code>Result</code> associated with this
  47      * <code>TransformerHandler</code> to be used for the transformation.</p>
  48      *
  49      * @param result A <code>Result</code> instance, should not be
  50      *   <code>null</code>.
  51      *
  52      * @throws IllegalArgumentException if result is invalid for some reason.
  53      */
  54     public void setResult(Result result) throws IllegalArgumentException;
  55 
  56     /**
  57      * Set the base ID (URI or system ID) from where relative
  58      * URLs will be resolved.
  59      * @param systemID Base URI for the source tree.
  60      */