Class SAXDestination

  extended by net.sf.saxon.s9api.SAXDestination
All Implemented Interfaces:

public class SAXDestination
extends 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
SAXDestination(ContentHandler handler)
          Create a SAXDestination, supplying a SAX ContentHandler to which events will be routed
Method Summary
 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


public SAXDestination(ContentHandler handler)
Create a SAXDestination, supplying a SAX ContentHandler to which events will be routed

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


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
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.
the Receiver to which events are to be sent.
SaxonApiException - if the Receiver cannot be created


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

Copyright (c) 2004-2010 Saxonica Limited. All rights reserved.