Class TeeDestination

java.lang.Object
net.sf.saxon.s9api.AbstractDestination
net.sf.saxon.s9api.TeeDestination
All Implemented Interfaces:
Destination

public class TeeDestination extends AbstractDestination
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
  • Constructor Details

    • TeeDestination

      public TeeDestination(Destination destination0, Destination destination1)
      Create a TeeDestination: a destination which copies everything that is sent to it to two separate destinations
      Parameters:
      destination0 - the first destination
      destination1 - 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 its open() method.
      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.
      Throws:
      SaxonApiException - if any failure occurs