Package net.sf.saxon.s9api
Class SAXDestination
java.lang.Object
net.sf.saxon.s9api.SAXDestination
- All Implemented Interfaces:
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
ConstructorsConstructorDescriptionSAXDestination
(ContentHandler handler) Create a SAXDestination, supplying a SAX ContentHandler to which events will be routed -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Close the destination, allowing resources to be released.getReceiver
(Configuration config) Return a Receiver.
-
Constructor Details
-
SAXDestination
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 aLexicalHandler
then it will also receive notification of events such as comments.
-
-
Method Details
-
getReceiver
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 interfaceDestination
- 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
Close the destination, allowing resources to be released. Saxon calls this method when it has finished writing to the destination.- Specified by:
close
in interfaceDestination
- Throws:
SaxonApiException
- if any failure occurs
-