Class 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 Detail

      • 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 Detail

      • 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