Package net.sf.saxon.s9api
Class TeeDestination
java.lang.Object
net.sf.saxon.s9api.AbstractDestination
net.sf.saxon.s9api.TeeDestination
- All Implemented Interfaces:
Destination
A TeeDestination allows writing to two destinations at once. For example the output of a transformation
can be written simultaneously to a Serializer and to a second Transformation. By chaining together a number
of TeeDestinations it is possible to write to any number of destinations at once.
- Since:
- 9.1
-
Field Summary
Fields inherited from class net.sf.saxon.s9api.AbstractDestination
helper
-
Constructor Summary
ConstructorsConstructorDescriptionTeeDestination
(Destination destination0, Destination destination1) Create a TeeDestination: a destination which copies everything that is sent to it to two separate destinations -
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Close the destination, allowing resources to be released.getReceiver
(PipelineConfiguration pipe, SerializationProperties params) Return a Receiver.Methods inherited from class net.sf.saxon.s9api.AbstractDestination
closeAndNotify, getDestinationBaseURI, onClose, setDestinationBaseURI
-
Constructor Details
-
TeeDestination
Create a TeeDestination: a destination which copies everything that is sent to it to two separate destinations- Parameters:
destination0
- the first destinationdestination1
- the second destination
-
-
Method Details
-
getReceiver
public Receiver getReceiver(PipelineConfiguration pipe, SerializationProperties params) 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.- Parameters:
pipe
- 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.params
- the serialization properties- Returns:
- the Receiver to which events are to be sent. It is the caller's responsibility to
initialize this Receiver with a
PipelineConfiguration
before calling itsopen()
method. - 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.- Throws:
SaxonApiException
- if any failure occurs
-