Class SAXDestination

  • All Implemented Interfaces:
    Destination

    public class SAXDestination
    extends java.lang.Object
    implements Destination
    This class represents a Destination (for example, the destination of the output of a transformation) in which events representing the XML document are sent to a user-supplied SAX2 ContentHandler, as if the ContentHandler were receiving the document directly from an XML parser.
    • Constructor Summary

      Constructors 
      Constructor Description
      SAXDestination​(org.xml.sax.ContentHandler handler)
      Create a SAXDestination, supplying a SAX ContentHandler to which events will be routed
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void close()
      Close the destination, allowing resources to be released.
      Receiver getReceiver​(Configuration config)
      Return a Receiver.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • SAXDestination

        public SAXDestination​(org.xml.sax.ContentHandler handler)
        Create a SAXDestination, supplying a SAX ContentHandler to which events will be routed
        Parameters:
        handler - the SAX ContentHandler that is to receive the output. If the ContentHandler is also a LexicalHandler then it will also receive notification of events such as comments.
    • Method Detail

      • getReceiver

        public Receiver getReceiver​(Configuration config)
                             throws SaxonApiException
        Return a Receiver. Saxon calls this method to obtain a Receiver, to which it then sends a sequence of events representing the content of an XML document.
        Specified by:
        getReceiver in interface Destination
        Parameters:
        config - The Saxon configuration. This is supplied so that the destination can use information from the configuration (for example, a reference to the name pool) to construct or configure the returned Receiver.
        Returns:
        the Receiver to which events are to be sent.
        Throws:
        SaxonApiException - if the Receiver cannot be created
      • close

        public void close()
                   throws SaxonApiException
        Close the destination, allowing resources to be released. Saxon calls this method when it has finished writing to the destination.
        Specified by:
        close in interface Destination
        Throws:
        SaxonApiException - if any failure occurs