Class Emitter

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

    public abstract class Emitter
    extends java.lang.Object
    implements javax.xml.transform.Result, Receiver
    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

      • systemId

        protected java.lang.String systemId
      • streamResult

        protected javax.xml.transform.stream.StreamResult streamResult
      • writer

        protected java.io.Writer writer
      • outputStream

        protected java.io.OutputStream outputStream
      • outputProperties

        protected java.util.Properties outputProperties
      • allCharactersEncodable

        protected boolean allCharactersEncodable
    • Constructor Detail

      • Emitter

        public Emitter()
    • Method Detail

      • getConfiguration

        public Configuration getConfiguration()
        Get the configuration used for this document
      • setSystemId

        public void setSystemId​(java.lang.String systemId)
        Set the System ID
        Specified by:
        setSystemId in interface Receiver
        Specified by:
        setSystemId in interface javax.xml.transform.Result
      • getSystemId

        public java.lang.String getSystemId()
        Get the System ID
        Specified by:
        getSystemId in interface javax.xml.transform.Result
      • setOutputProperties

        public void setOutputProperties​(java.util.Properties details)
                                 throws XPathException
        Set output properties
        Throws:
        XPathException
      • getOutputProperties

        public java.util.Properties getOutputProperties()
        Get the output properties
      • setStreamResult

        public void setStreamResult​(javax.xml.transform.stream.StreamResult result)
                             throws XPathException
        Set the StreamResult acting as the output destination of the Emitter
        Throws:
        XPathException
      • makeWriter

        protected void makeWriter()
                           throws XPathException
        Make a Writer for this Emitter to use, given a StreamResult
        Throws:
        XPathException
      • 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
      • setWriter

        public void setWriter​(java.io.Writer writer)
        Set the output destination as a character stream
      • getWriter

        public java.io.Writer getWriter()
        Get the output writer
      • setOutputStream

        public void setOutputStream​(java.io.OutputStream stream)
                             throws XPathException
        Set the output destination as a byte stream
        Throws:
        XPathException
      • getOutputStream

        public java.io.OutputStream getOutputStream()
        Get the output stream
      • 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
        Parameters:
        name - The name of the unparsed entity
        uri - The system identifier of the unparsed entity
        publicId - The public identifier of the unparsed entity
        Throws:
        XPathException