Class Emitter

All Implemented Interfaces:
Result, Receiver, ReceiverWithOutputProperties
Direct Known Subclasses:
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 Details

    • streamResult

      protected StreamResult streamResult
    • writer

      protected Writer writer
    • outputStream

      protected OutputStream outputStream
    • outputProperties

      protected Properties outputProperties
    • characterSet

      protected CharacterSet characterSet
    • allCharactersEncodable

      protected boolean allCharactersEncodable
  • Constructor Details

    • Emitter

      public Emitter()
  • Method Details

    • setOutputProperties

      public void setOutputProperties(Properties details) throws XPathException
      Set output properties
      Parameters:
      details - the output serialization properties
      Throws:
      XPathException - if an error occurs finding the encoding property
    • getOutputProperties

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

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

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

      protected OutputStream makeOutputStream() throws XPathException
      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
      Returns:
      true if a Writer is needed, as distinct from an OutputStream
    • setWriter

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

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

      public void setOutputStream(OutputStream 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.

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

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

      public void setUnparsedEntity(String name, String uri, 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
      Overrides:
      setUnparsedEntity in class SequenceReceiver
      Parameters:
      name - the entity name
      uri - the entity system ID
      publicId - the entity public ID
      Throws:
      XPathException - if an error occurs
    • close

      public void close() throws XPathException
      Notify the end of the event stream
      Specified by:
      close in interface Receiver
      Throws:
      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
      Returns:
      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
      Parameters:
      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
      Throws:
      XPathException - if an error occurs