Class Emitter

  • All Implemented Interfaces:
    javax.xml.transform.Result, Receiver, ReceiverWithOutputProperties
    Direct Known Subclasses:
    BinaryEmitter, XMLEmitter

    public abstract class Emitter
    extends SequenceReceiver
    implements ReceiverWithOutputProperties
    Emitter: This abstract class defines methods that must be implemented by components that format SAXON output. There is one emitter for XML, one for HTML, and so on. Additional methods are concerned with setting options and providing a Writer.

    The interface is deliberately designed to be as close as possible to the standard SAX2 ContentHandler interface, however, it allows additional information to be made available.

    An Emitter is a Receiver, specifically it is a Receiver that can direct output to a Writer or OutputStream, using serialization properties defined in a Properties object.

    • Field Detail

      • streamResult

        protected streamResult
      • writer

        protected writer
      • outputStream

        protected outputStream
      • outputProperties

        protected java.util.Properties outputProperties
      • allCharactersEncodable

        protected boolean allCharactersEncodable
    • Constructor Detail

      • Emitter

        public Emitter()
    • Method Detail

      • setOutputProperties

        public void setOutputProperties​(java.util.Properties details)
                                 throws XPathException
        Set output properties
        details - the output serialization properties
        XPathException - if an error occurs finding the encoding property
      • getOutputProperties

        public java.util.Properties getOutputProperties()
        Get the output properties
        Specified by:
        getOutputProperties in interface ReceiverWithOutputProperties
        the output serialization properties. The returned value will be null if setOutputProperties() has not been called
      • setStreamResult

        public void setStreamResult​( result)
                             throws XPathException
        Set the StreamResult acting as the output destination of the Emitter
        result - the output destination
        XPathException - if an error occurs
      • makeWriter

        protected void makeWriter()
                           throws XPathException
        Make a Writer for this Emitter to use, given a StreamResult.
        XPathException - if an error occurs
      • usesWriter

        public boolean usesWriter()
        Determine whether the Emitter wants a Writer for character output or an OutputStream for binary output. The standard Emitters all use a Writer, so this returns true; but a subclass can override this if it wants to use an OutputStream
        true if a Writer is needed, as distinct from an OutputStream
      • setWriter

        public void setWriter​( writer)
                       throws XPathException
        Set the output destination as a character stream
        writer - the Writer to use as an output destination
        XPathException - if an error occurs
      • getWriter

        public getWriter()
        Get the output writer
        the Writer being used as an output destination, if any
      • setOutputStream

        public void setOutputStream​( stream)
                             throws XPathException
        Set the output destination as a byte stream.

        Note that if a specific encoding (other than the default, UTF-8) is required, then setOutputProperties(java.util.Properties) must be called before calling this method.

        stream - the OutputStream being used as an output destination
        XPathException - if an error occurs
      • getOutputStream

        public getOutputStream()
        Get the output stream
        the OutputStream being used as an output destination, if any
      • setUnparsedEntity

        public void setUnparsedEntity​(java.lang.String name,
                                      java.lang.String uri,
                                      java.lang.String publicId)
                               throws XPathException
        Set unparsed entity URI. Needed to satisfy the Receiver interface, but not used, because unparsed entities can occur only in input documents, not in output documents.
        Specified by:
        setUnparsedEntity in interface Receiver
        setUnparsedEntity in class SequenceReceiver
        name - the entity name
        uri - the entity system ID
        publicId - the entity public ID
        XPathException - if an error occurs
      • usesTypeAnnotations

        public boolean usesTypeAnnotations()
        Ask whether this Receiver (or the downstream pipeline) makes any use of the type annotations supplied on element and attribute events
        Specified by:
        usesTypeAnnotations in interface Receiver
        true if the Receiver makes any use of this information. If false, the caller may supply untyped nodes instead of supplying the type annotation (or conversely, it may avoid stripping unwanted type annotations)
      • append

        public void append​(Item item,
                           Location locationId,
                           int copyNamespaces)
                    throws XPathException
        Append an arbitrary item (node or atomic value) to the output
        Specified by:
        append in interface Receiver
        Specified by:
        append in class SequenceReceiver
        item - the item to be appended
        locationId - the location of the calling instruction, for diagnostics
        copyNamespaces - if the item is an element node, this indicates whether its namespaces need to be copied. Values are ReceiverOption.ALL_NAMESPACES; the default (0) means
        XPathException - if an error occurs