net.sf.saxon.s9api
Class SAXDestination

java.lang.Object
  net.sf.saxon.s9api.SAXDestination

All Implemented Interfaces:

Destination

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

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(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