org.apache.xml.serializer

## Class SerializerBase

- java.lang.Object
- - org.apache.xml.serializer.SerializerBase

- All Implemented Interfaces:
    DOMSerializer, ExtendedContentHandler, ExtendedLexicalHandler, SerializationHandler, Serializer, ContentHandler, DTDHandler, ErrorHandler, DeclHandler, LexicalHandler
  Direct Known Subclasses:
    ToSAXHandler, ToStream, ToUnknownStream

      public abstract class SerializerBase
      extends java.lang.Object
      implements SerializationHandler

  This class acts as a base class for the XML "serializers" and the stream serializers. It contains a number of common fields and methods.
  Usage:
    **For internal use only**

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static java.lang.String` | `CDATA_CONTINUE` To insert ]]> in a CDATA section by ending the last CDATA section with ]] and starting the next CDATA section with >
    `static java.lang.String` | `CDATA_DELIMITER_CLOSE` The constant "]]>"
    `static java.lang.String` | `CDATA_DELIMITER_OPEN`
    `static java.lang.String` | `DEFAULT_SAX_SERIALIZER`
    `static java.lang.String` | `EMPTYSTRING`
    `static java.lang.String` | `ENTITY_AMP`
    `static java.lang.String` | `ENTITY_CRLF`
    `static java.lang.String` | `ENTITY_GT`
    `static java.lang.String` | `ENTITY_LT`
    `static java.lang.String` | `ENTITY_QUOT`
    `static java.lang.String` | `PKG_NAME` The name of the package that this class is in.
    `static java.lang.String` | `PKG_PATH` The same as the name of the package that this class is in except that '.' are replaced with '/'.
    `static java.lang.String` | `XML_PREFIX`
    `static java.lang.String` | `XMLNS_PREFIX`
    `static java.lang.String` | `XMLNS_URI`
    `static java.lang.String` | `XMLVERSION10`
    `static java.lang.String` | `XMLVERSION11` Define the XML version.

    - ### Fields inherited from interface org.apache.xml.serializer.ExtendedContentHandler

      `HTML_ATTREMPTY, HTML_ATTRURL, NO_BAD_CHARS`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `addAttribute(java.lang.String name, java.lang.String value)` Adds the given attribute to the set of collected attributes, but only if there is a currently open element.
    `void` | `addAttribute(java.lang.String uri, java.lang.String localName, java.lang.String rawName, java.lang.String type, java.lang.String value)` This method adds an attribute the the current element, but should not be used for an xsl:attribute child.
    `void` | `addAttribute(java.lang.String uri, java.lang.String localName, java.lang.String rawName, java.lang.String type, java.lang.String value, boolean XSLAttribute)` Adds the given attribute to the set of collected attributes , but only if there is a currently open element.
    `boolean` | `addAttributeAlways(java.lang.String uri, java.lang.String localName, java.lang.String rawName, java.lang.String type, java.lang.String value, boolean XSLAttribute)` Adds the given attribute to the set of attributes, even if there is no currently open element.
    `void` | `addAttributes(Attributes atts)` Add the given attributes to the currently collected ones.
    `void` | `addXSLAttribute(java.lang.String name, java.lang.String value, java.lang.String uri)` Adds the given xsl:attribute to the set of collected attributes, but only if there is a currently open element.
    `ContentHandler` | `asContentHandler()` Return a `ContentHandler` interface into this serializer.
    `java.lang.Object` | `asDOM3Serializer()` Return a `DOM3Serializer` interface into this serializer.
    `DOMSerializer` | `asDOMSerializer()` Return a `DOMSerializer` interface into this serializer.
    `void` | `characters(Node node)` This method gets the nodes value as a String and uses that String as if it were an input character notification.
    `void` | `close()` Flush and close the underlying java.io.Writer.
    `void` | `comment(java.lang.String data)` Receive notification of a comment.
    `boolean` | `documentIsEmpty()` Return true if nothing has been sent to this result tree yet.
    `void` | `endEntity(java.lang.String name)` Report the end of an entity.
    `void` | `entityReference(java.lang.String name)` Entity reference event.
    `void` | `error(SAXParseException exc)` Receive notification of a recoverable error.
    `void` | `fatalError(SAXParseException exc)` Receive notification of a non-recoverable error.
    `void` | `fireEndEntity(java.lang.String name)` To fire off end entity trace event
    `java.lang.String` | `getDoctypePublic()` Returns the previously set value of the value to be used as the public identifier in the document type declaration (DTD).
    `java.lang.String` | `getDoctypeSystem()` Returns the previously set value of the value to be used as the system identifier in the document type declaration (DTD).
    `java.lang.String` | `getEncoding()` Returns the character encoding to be used in the output document.
    `boolean` | `getIndent()`
    `int` | `getIndentAmount()`
    `java.lang.String` | `getMediaType()` Gets the mediatype the media-type or MIME type associated with the output document.
    `NamespaceMappings` | `getNamespaceMappings()` Some users of the serializer may need the current namespace mappings
    `java.lang.String` | `getNamespaceURI(java.lang.String qname, boolean isElement)` Returns the URI of an element or attribute.
    `java.lang.String` | `getNamespaceURIFromPrefix(java.lang.String prefix)` Returns the URI of prefix (if any)
    `boolean` | `getOmitXMLDeclaration()`
    `java.lang.String` | `getOutputProperty(java.lang.String name)` Get the value of an output property, the explicit value, if any, otherwise the default value, if any, otherwise null.
    `java.lang.String` | `getOutputPropertyDefault(java.lang.String name)` Get the default value of an xsl:output property, which would be null only if no default value exists for the property.
    `java.lang.String` | `getOutputPropertyNonDefault(java.lang.String name)` Get the value of an output property, not the default value.
    `java.lang.String` | `getPrefix(java.lang.String namespaceURI)` Returns the prefix currently pointing to the given URI (if any).
    `java.lang.String` | `getStandalone()` Gets the XSL standalone attribute
    `Transformer` | `getTransformer()` Gets the transformer associated with this serializer
    `java.lang.String` | `getVersion()` Gets the version of the output format.
    `void` | `namespaceAfterStartElement(java.lang.String uri, java.lang.String prefix)` This method is used when a prefix/uri namespace mapping is indicated after the element was started with a startElement() and before and endElement().
    `void` | `notationDecl(java.lang.String arg0, java.lang.String arg1, java.lang.String arg2)` Receive notification of a notation declaration event.
    `boolean` | `reset()` This method resets the serializer.
    `void` | `setCdataSectionElements(java.util.Vector URI_and_localNames)` Sets the value coming from the xsl:output cdata-section-elements stylesheet property.
    `void` | `setDoctype(java.lang.String doctypeSystem, java.lang.String doctypePublic)` Set the value coming from the xsl:output doctype-public and doctype-system stylesheet properties
    `void` | `setDoctypePublic(java.lang.String doctypePublic)` Set the value coming from the xsl:output doctype-public stylesheet attribute.
    `void` | `setDoctypeSystem(java.lang.String doctypeSystem)` Set the value coming from the xsl:output doctype-system stylesheet attribute.
    `void` | `setDocumentLocator(Locator locator)` Receive an object for locating the origin of SAX document events.
    `void` | `setDTDEntityExpansion(boolean expand)` If set to false the serializer does not expand DTD entities, but leaves them as is, the default value is true.
    `void` | `setEncoding(java.lang.String encoding)` Sets the character encoding coming from the xsl:output encoding stylesheet attribute.
    `void` | `setIndent(boolean doIndent)` Sets the value coming from the xsl:output indent stylesheet attribute.
    `void` | `setIndentAmount(int m_indentAmount)` Sets the indentation amount.
    `void` | `setMediaType(java.lang.String mediaType)` Sets the value coming from the xsl:output media-type stylesheet attribute.
    `void` | `setNamespaceMappings(NamespaceMappings mappings)` Used only by TransformerSnapshotImpl to restore the serialization to a previous state.
    `void` | `setOmitXMLDeclaration(boolean b)` Sets the value coming from the xsl:output omit-xml-declaration stylesheet attribute
    `void` | `setOutputProperty(java.lang.String name, java.lang.String val)` Set the value for the output property, typically from an xsl:output element, but this does not change what the default value is.
    `void` | `setOutputPropertyDefault(java.lang.String name, java.lang.String val)` Set the default value for an output property, but this does not impact any explicitly set value.
    `void` | `setSourceLocator(SourceLocator locator)` This method is used to set the source locator, which might be used to generated an error message.
    `void` | `setStandalone(java.lang.String standalone)` Sets the value coming from the xsl:output standalone stylesheet attribute.
    `void` | `setTransformer(Transformer t)` Sets the transformer associated with this serializer
    `void` | `setVersion(java.lang.String version)` Sets the value coming from the xsl:output version attribute.
    `void` | `startDocument()` Receive notification of the beginning of a document.
    `void` | `unparsedEntityDecl(java.lang.String arg0, java.lang.String arg1, java.lang.String arg2, java.lang.String arg3)` Receive notification of an unparsed entity declaration event.
    `void` | `warning(SAXParseException exc)` Receive notification of a warning.

    - ### Methods inherited from class java.lang.Object

      `equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

    - ### Methods inherited from interface org.apache.xml.serializer.SerializationHandler

      `flushPending, serialize, setContentHandler, setEscaping`

    - ### Methods inherited from interface org.apache.xml.serializer.ExtendedContentHandler

      `addUniqueAttribute, characters, endElement, startElement, startElement, startPrefixMapping`

    - ### Methods inherited from interface org.xml.sax.ContentHandler

      `characters, endDocument, endElement, endPrefixMapping, ignorableWhitespace, processingInstruction, skippedEntity, startElement, startPrefixMapping`

    - ### Methods inherited from interface org.xml.sax.ext.LexicalHandler

      `comment, endCDATA, endDTD, startCDATA, startDTD, startEntity`

    - ### Methods inherited from interface org.xml.sax.ext.DeclHandler

      `attributeDecl, elementDecl, externalEntityDecl, internalEntityDecl`

    - ### Methods inherited from interface org.apache.xml.serializer.Serializer

      `getOutputFormat, getOutputStream, getWriter, setOutputFormat, setOutputStream, setWriter`

- - ### Field Detail

    - #### PKG_NAME

          public static final java.lang.String PKG_NAME

      The name of the package that this class is in.

      Not a public API.

    - #### PKG_PATH

          public static final java.lang.String PKG_PATH

      The same as the name of the package that this class is in except that '.' are replaced with '/'.

      Not a public API.

    - #### CDATA_CONTINUE

          public static final java.lang.String CDATA_CONTINUE

      To insert ]]> in a CDATA section by ending the last CDATA section with ]] and starting the next CDATA section with >
      See Also:
        Constant Field Values

    - #### CDATA_DELIMITER_CLOSE

          public static final java.lang.String CDATA_DELIMITER_CLOSE

      The constant "]]>"
      See Also:
        Constant Field Values

    - #### CDATA_DELIMITER_OPEN

          public static final java.lang.String CDATA_DELIMITER_OPEN

      See Also:
        Constant Field Values

    - #### EMPTYSTRING

          public static final java.lang.String EMPTYSTRING

      See Also:
        Constant Field Values

    - #### ENTITY_AMP

          public static final java.lang.String ENTITY_AMP

      See Also:
        Constant Field Values

    - #### ENTITY_CRLF

          public static final java.lang.String ENTITY_CRLF

      See Also:
        Constant Field Values

    - #### ENTITY_GT

          public static final java.lang.String ENTITY_GT

      See Also:
        Constant Field Values

    - #### ENTITY_LT

          public static final java.lang.String ENTITY_LT

      See Also:
        Constant Field Values

    - #### ENTITY_QUOT

          public static final java.lang.String ENTITY_QUOT

      See Also:
        Constant Field Values

    - #### XML_PREFIX

          public static final java.lang.String XML_PREFIX

      See Also:
        Constant Field Values

    - #### XMLNS_PREFIX

          public static final java.lang.String XMLNS_PREFIX

      See Also:
        Constant Field Values

    - #### XMLNS_URI

          public static final java.lang.String XMLNS_URI

      See Also:
        Constant Field Values

    - #### DEFAULT_SAX_SERIALIZER

          public static final java.lang.String DEFAULT_SAX_SERIALIZER

    - #### XMLVERSION11

          public static final java.lang.String XMLVERSION11

      Define the XML version.
      See Also:
        Constant Field Values

    - #### XMLVERSION10

          public static final java.lang.String XMLVERSION10

      See Also:
        Constant Field Values

  - ### Method Detail

    - #### comment

          public void comment(java.lang.String data)
                       throws SAXException

      Receive notification of a comment.
      Specified by:
        `comment` in interface `ExtendedLexicalHandler`
      Parameters:
        `data` - the comment, but unlike the SAX comment() method this method takes a String rather than a character array.
      Throws:
        `SAXException`
      See Also:
        `ExtendedLexicalHandler.comment(String)`

    - #### setDocumentLocator

          public void setDocumentLocator(Locator locator)

      Receive an object for locating the origin of SAX document events.
      Specified by:
        `setDocumentLocator` in interface `ContentHandler`
      Parameters:
        `locator` - An object that can return the location of any SAX document event. Receive an object for locating the origin of SAX document events.

        SAX parsers are strongly encouraged (though not absolutely required) to supply a locator: if it does so, it must supply the locator to the application by invoking this method before invoking any of the other methods in the DocumentHandler interface.

        The locator allows the application to determine the end position of any document-related event, even if the parser is not reporting an error. Typically, the application will use this information for reporting its own errors (such as character content that does not match an application's business rules). The information returned by the locator is probably not sufficient for use with a search engine.

        Note that the locator will return correct information only during the invocation of the events in this interface. The application should not attempt to use it at any other time.

      See Also:
        `Locator`

    - #### addAttribute

          public void addAttribute(java.lang.String uri,
                          java.lang.String localName,
                          java.lang.String rawName,
                          java.lang.String type,
                          java.lang.String value,
                          boolean XSLAttribute)
                            throws SAXException

      Adds the given attribute to the set of collected attributes , but only if there is a currently open element. An element is currently open if a startElement() notification has occured but the start of the element has not yet been written to the output. In the stream case this means that we have not yet been forced to close the elements opening tag by another notification, such as a character notification.
      Specified by:
        `addAttribute` in interface `ExtendedContentHandler`
      Parameters:
        `uri` - the URI of the attribute
        `localName` - the local name of the attribute
        `rawName` - the qualified name of the attribute
        `type` - the type of the attribute (probably CDATA)
        `value` - the value of the attribute
        `XSLAttribute` - true if this attribute is coming from an xsl:attriute element
      Throws:
        `SAXException`
      See Also:
        `ExtendedContentHandler.addAttribute(String, String, String, String, String)`

    - #### addAttributeAlways

          public boolean addAttributeAlways(java.lang.String uri,
                                   java.lang.String localName,
                                   java.lang.String rawName,
                                   java.lang.String type,
                                   java.lang.String value,
                                   boolean XSLAttribute)

      Adds the given attribute to the set of attributes, even if there is no currently open element. This is useful if a SAX startPrefixMapping() should need to add an attribute before the element name is seen.
      Parameters:
        `uri` - the URI of the attribute
        `localName` - the local name of the attribute
        `rawName` - the qualified name of the attribute
        `type` - the type of the attribute (probably CDATA)
        `value` - the value of the attribute
        `XSLAttribute` - true if this attribute is coming from an xsl:attribute element
      Returns:
        true if the attribute was added, false if an existing value was replaced.

    - #### addAttribute

          public void addAttribute(java.lang.String name,
                          java.lang.String value)

      Adds the given attribute to the set of collected attributes, but only if there is a currently open element.
      Specified by:
        `addAttribute` in interface `ExtendedContentHandler`
      Parameters:
        `name` - the attribute's qualified name
        `value` - the value of the attribute

    - #### addXSLAttribute

          public void addXSLAttribute(java.lang.String name,
                             java.lang.String value,
                             java.lang.String uri)

      Adds the given xsl:attribute to the set of collected attributes, but only if there is a currently open element.
      Specified by:
        `addXSLAttribute` in interface `ExtendedContentHandler`
      Parameters:
        `name` - the attribute's qualified name (prefix:localName)
        `value` - the value of the attribute
        `uri` - the URI that the prefix of the name points to

    - #### addAttributes

          public void addAttributes(Attributes atts)
                             throws SAXException

      Add the given attributes to the currently collected ones. These attributes are always added, regardless of whether on not an element is currently open.
      Specified by:
        `addAttributes` in interface `ExtendedContentHandler`
      Parameters:
        `atts` - List of attributes to add to this list
      Throws:
        `SAXException`

    - #### asContentHandler

          public ContentHandler asContentHandler()
                                          throws java.io.IOException

      Return a `ContentHandler` interface into this serializer. If the serializer does not support the `ContentHandler` interface, it should return null.
      Specified by:
        `asContentHandler` in interface `Serializer`
      Returns:
        A `ContentHandler` interface into this serializer, or null if the serializer is not SAX 2 capable
      Throws:
        `java.io.IOException` - An I/O exception occured

    - #### endEntity

          public void endEntity(java.lang.String name)
                         throws SAXException

      Report the end of an entity.
      Specified by:
        `endEntity` in interface `LexicalHandler`
      Parameters:
        `name` - The name of the entity that is ending.
      Throws:
        `SAXException` - The application may raise an exception.
      See Also:
        `LexicalHandler.startEntity(java.lang.String)`

    - #### close

          public void close()

      Flush and close the underlying java.io.Writer. This method applies to ToStream serializers, not ToSAXHandler serializers.
      Specified by:
        `close` in interface `SerializationHandler`
      See Also:
        `ToStream`

    - #### getEncoding

          public java.lang.String getEncoding()

      Returns the character encoding to be used in the output document.
      Returns:
        the character encoding to be used in the output document.

    - #### setEncoding

          public void setEncoding(java.lang.String encoding)

      Sets the character encoding coming from the xsl:output encoding stylesheet attribute.
      Parameters:
        `m_encoding` - the character encoding

    - #### setOmitXMLDeclaration

          public void setOmitXMLDeclaration(boolean b)

      Sets the value coming from the xsl:output omit-xml-declaration stylesheet attribute
      Parameters:
        `b` - true if the XML declaration is to be omitted from the output document.

    - #### getOmitXMLDeclaration

          public boolean getOmitXMLDeclaration()

      Returns:
        true if the XML declaration is to be omitted from the output document.

    - #### getDoctypePublic

          public java.lang.String getDoctypePublic()

      Returns the previously set value of the value to be used as the public identifier in the document type declaration (DTD).
      Returns:
        the public identifier to be used in the DOCTYPE declaration in the output document.

    - #### setDoctypePublic

          public void setDoctypePublic(java.lang.String doctypePublic)

      Set the value coming from the xsl:output doctype-public stylesheet attribute.
      Parameters:
        `doctypePublic` - the public identifier to be used in the DOCTYPE declaration in the output document.

    - #### getDoctypeSystem

          public java.lang.String getDoctypeSystem()

      Returns the previously set value of the value to be used as the system identifier in the document type declaration (DTD).
      Returns:
        the system identifier to be used in the DOCTYPE declaration in the output document.

    - #### setDoctypeSystem

          public void setDoctypeSystem(java.lang.String doctypeSystem)

      Set the value coming from the xsl:output doctype-system stylesheet attribute.
      Parameters:
        `doctypeSystem` - the system identifier to be used in the DOCTYPE declaration in the output document.

    - #### setDoctype

          public void setDoctype(java.lang.String doctypeSystem,
                        java.lang.String doctypePublic)

      Set the value coming from the xsl:output doctype-public and doctype-system stylesheet properties
      Parameters:
        `doctypeSystem` - the system identifier to be used in the DOCTYPE declaration in the output document.
        `doctypePublic` - the public identifier to be used in the DOCTYPE declaration in the output document.

    - #### setStandalone

          public void setStandalone(java.lang.String standalone)

      Sets the value coming from the xsl:output standalone stylesheet attribute.
      Parameters:
        `standalone` - a value of "yes" indicates that the `standalone` delaration is to be included in the output document. This method remembers if the value was explicitly set using this method, verses if the value is the default value.

    - #### getStandalone

          public java.lang.String getStandalone()

      Gets the XSL standalone attribute
      Returns:
        a value of "yes" if the `standalone` delaration is to be included in the output document.
      See Also:
        `XSLOutputAttributes.getStandalone()`

    - #### getIndent

          public boolean getIndent()

      Returns:
        true if the output document should be indented to visually indicate its structure.

    - #### getMediaType

          public java.lang.String getMediaType()

      Gets the mediatype the media-type or MIME type associated with the output document.
      Returns:
        the mediatype the media-type or MIME type associated with the output document.

    - #### getVersion

          public java.lang.String getVersion()

      Gets the version of the output format.
      Returns:
        the version of the output format.

    - #### setVersion

          public void setVersion(java.lang.String version)

      Sets the value coming from the xsl:output version attribute.
      Parameters:
        `version` - the version of the output format.
      See Also:
        `XSLOutputAttributes.setVersion(String)`

    - #### setMediaType

          public void setMediaType(java.lang.String mediaType)

      Sets the value coming from the xsl:output media-type stylesheet attribute.
      Parameters:
        `mediaType` - the non-null media-type or MIME type associated with the output document.
      See Also:
        `OutputKeys.MEDIA_TYPE`, `XSLOutputAttributes.setMediaType(String)`

    - #### getIndentAmount

          public int getIndentAmount()

      Returns:
        the number of spaces to indent for each indentation level.

    - #### setIndentAmount

          public void setIndentAmount(int m_indentAmount)

      Sets the indentation amount.
      Specified by:
        `setIndentAmount` in interface `SerializationHandler`
      Parameters:
        `m_indentAmount` - The m_indentAmount to set

    - #### setIndent

          public void setIndent(boolean doIndent)

      Sets the value coming from the xsl:output indent stylesheet attribute.
      Parameters:
        `doIndent` - true if the output document should be indented to visually indicate its structure.
      See Also:
        `XSLOutputAttributes.setIndent(boolean)`

    - #### namespaceAfterStartElement

          public void namespaceAfterStartElement(java.lang.String uri,
                                        java.lang.String prefix)
                                          throws SAXException

      This method is used when a prefix/uri namespace mapping is indicated after the element was started with a startElement() and before and endElement(). startPrefixMapping(prefix,uri) would be used before the startElement() call.
      Specified by:
        `namespaceAfterStartElement` in interface `ExtendedContentHandler`
      Parameters:
        `uri` - the URI of the namespace
        `prefix` - the prefix associated with the given URI.
      Throws:
        `SAXException`
      See Also:
        `ExtendedContentHandler.namespaceAfterStartElement(String, String)`

    - #### asDOMSerializer

          public DOMSerializer asDOMSerializer()
                                        throws java.io.IOException

      Return a `DOMSerializer` interface into this serializer. If the serializer does not support the `DOMSerializer` interface, it should return null.
      Specified by:
        `asDOMSerializer` in interface `Serializer`
      Returns:
        A `DOMSerializer` interface into this serializer, or null if the serializer is not DOM capable
      Throws:
        `java.io.IOException` - An I/O exception occured
      See Also:
        `Serializer.asDOMSerializer()`

    - #### getNamespaceMappings

          public NamespaceMappings getNamespaceMappings()

      Some users of the serializer may need the current namespace mappings
      Specified by:
        `getNamespaceMappings` in interface `ExtendedContentHandler`
      Returns:
        the current namespace mappings (prefix/uri)
      See Also:
        `ExtendedContentHandler.getNamespaceMappings()`

    - #### getPrefix

          public java.lang.String getPrefix(java.lang.String namespaceURI)

      Returns the prefix currently pointing to the given URI (if any).
      Specified by:
        `getPrefix` in interface `ExtendedContentHandler`
      Parameters:
        `namespaceURI` - the uri of the namespace in question
      Returns:
        a prefix pointing to the given URI (if any).
      See Also:
        `ExtendedContentHandler.getPrefix(String)`

    - #### getNamespaceURI

          public java.lang.String getNamespaceURI(java.lang.String qname,
                                         boolean isElement)

      Returns the URI of an element or attribute. Note that default namespaces do not apply directly to attributes.
      Specified by:
        `getNamespaceURI` in interface `ExtendedContentHandler`
      Parameters:
        `qname` - a qualified name
        `isElement` - true if the qualified name is the name of an element.
      Returns:
        returns the namespace URI associated with the qualified name.

    - #### getNamespaceURIFromPrefix

          public java.lang.String getNamespaceURIFromPrefix(java.lang.String prefix)

      Returns the URI of prefix (if any)
      Specified by:
        `getNamespaceURIFromPrefix` in interface `ExtendedContentHandler`
      Parameters:
        `prefix` - the prefix whose URI is searched for
      Returns:
        the namespace URI currently associated with the prefix, null if the prefix is undefined.

    - #### entityReference

          public void entityReference(java.lang.String name)
                               throws SAXException

      Entity reference event.
      Specified by:
        `entityReference` in interface `ExtendedContentHandler`
      Parameters:
        `name` - Name of entity
      Throws:
        `SAXException`

    - #### setTransformer

          public void setTransformer(Transformer t)

      Sets the transformer associated with this serializer
      Specified by:
        `setTransformer` in interface `SerializationHandler`
      Parameters:
        `t` - the transformer associated with this serializer.
      See Also:
        `SerializationHandler.setTransformer(Transformer)`

    - #### getTransformer

          public Transformer getTransformer()

      Gets the transformer associated with this serializer
      Specified by:
        `getTransformer` in interface `SerializationHandler`
      Returns:
        returns the transformer associated with this serializer.
      See Also:
        `SerializationHandler.getTransformer()`

    - #### characters

          public void characters(Node node)
                          throws SAXException

      This method gets the nodes value as a String and uses that String as if it were an input character notification.
      Specified by:
        `characters` in interface `ExtendedContentHandler`
      Parameters:
        `node` - the Node to serialize
      Throws:
        `SAXException`

    - #### error

          public void error(SAXParseException exc)
                     throws SAXException

      Description copied from interface: `ErrorHandler`
      Receive notification of a recoverable error.

      This corresponds to the definition of "error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a validating parser would use this callback to report the violation of a validity constraint. The default behaviour is to take no action.

      The SAX parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end. If the application cannot do so, then the parser should report a fatal error even if the XML recommendation does not require it to do so.

      Filters may use this method to report other, non-XML errors as well.

      Specified by:
        `error` in interface `ErrorHandler`
      Parameters:
        `exc` - The error information encapsulated in a SAX parse exception.
      Throws:
        `SAXException` - Any SAX exception, possibly wrapping another exception.
      See Also:
        `ErrorHandler.error(SAXParseException)`

    - #### fatalError

          public void fatalError(SAXParseException exc)
                          throws SAXException

      Description copied from interface: `ErrorHandler`
      Receive notification of a non-recoverable error.

      There is an apparent contradiction between the documentation for this method and the documentation for `ContentHandler.endDocument()`. Until this ambiguity is resolved in a future major release, clients should make no assumptions about whether endDocument() will or will not be invoked when the parser has reported a fatalError() or thrown an exception.

      This corresponds to the definition of "fatal error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a parser would use this callback to report the violation of a well-formedness constraint.

      The application must assume that the document is unusable after the parser has invoked this method, and should continue (if at all) only for the sake of collecting additional error messages: in fact, SAX parsers are free to stop reporting any other events once this method has been invoked.

      Specified by:
        `fatalError` in interface `ErrorHandler`
      Parameters:
        `exc` - The error information encapsulated in a SAX parse exception.
      Throws:
        `SAXException` - Any SAX exception, possibly wrapping another exception.
      See Also:
        `ErrorHandler.fatalError(SAXParseException)`

    - #### warning

          public void warning(SAXParseException exc)
                       throws SAXException

      Description copied from interface: `ErrorHandler`
      Receive notification of a warning.

      SAX parsers will use this method to report conditions that are not errors or fatal errors as defined by the XML recommendation. The default behaviour is to take no action.

      The SAX parser must continue to provide normal parsing events after invoking this method: it should still be possible for the application to process the document through to the end.

      Filters may use this method to report other, non-XML warnings as well.

      Specified by:
        `warning` in interface `ErrorHandler`
      Parameters:
        `exc` - The warning information encapsulated in a SAX parse exception.
      Throws:
        `SAXException` - Any SAX exception, possibly wrapping another exception.
      See Also:
        `ErrorHandler.warning(SAXParseException)`

    - #### fireEndEntity

          public void fireEndEntity(java.lang.String name)
                             throws SAXException

      To fire off end entity trace event
      Parameters:
        `name` - Name of entity
      Throws:
        `SAXException`

    - #### startDocument

          public void startDocument()
                             throws SAXException

      Receive notification of the beginning of a document. This method is never a self generated call, but only called externally.

      The SAX parser will invoke this method only once, before any other methods in this interface or in DTDHandler (except for setDocumentLocator).

      Specified by:
        `startDocument` in interface `ContentHandler`
      Throws:
        `SAXException` - Any SAX exception, possibly wrapping another exception.
        `SAXException`
      See Also:
        `ContentHandler.endDocument()`

    - #### setSourceLocator

          public void setSourceLocator(SourceLocator locator)

      This method is used to set the source locator, which might be used to generated an error message.
      Specified by:
        `setSourceLocator` in interface `ExtendedContentHandler`
      Parameters:
        `locator` - the source locator
      See Also:
        `ExtendedContentHandler.setSourceLocator(javax.xml.transform.SourceLocator)`

    - #### setNamespaceMappings

          public void setNamespaceMappings(NamespaceMappings mappings)

      Used only by TransformerSnapshotImpl to restore the serialization to a previous state.
      Specified by:
        `setNamespaceMappings` in interface `SerializationHandler`
      Parameters:
        `mappings` - NamespaceMappings

    - #### reset

          public boolean reset()

      Description copied from interface: `Serializer`
      This method resets the serializer. If this method returns true, the serializer may be used for subsequent serialization of new documents. It is possible to change the output format and output stream prior to serializing, or to reuse the existing output format and output stream or writer.
      Specified by:
        `reset` in interface `Serializer`
      Returns:
        True if serializer has been reset and can be reused

    - #### addAttribute

          public void addAttribute(java.lang.String uri,
                          java.lang.String localName,
                          java.lang.String rawName,
                          java.lang.String type,
                          java.lang.String value)
                            throws SAXException

      This method adds an attribute the the current element, but should not be used for an xsl:attribute child.
      Specified by:
        `addAttribute` in interface `ExtendedContentHandler`
      Parameters:
        `uri` - the namespace URI of the attribute name
        `localName` - the local name of the attribute (without prefix)
        `rawName` - the qualified name of the attribute
        `type` - the attribute type typically character data (CDATA)
        `value` - the value of the attribute
      Throws:
        `SAXException`
      See Also:
        `ExtendedContentHandler.addAttribute(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)`

    - #### notationDecl

          public void notationDecl(java.lang.String arg0,
                          java.lang.String arg1,
                          java.lang.String arg2)
                            throws SAXException

      Description copied from interface: `DTDHandler`
      Receive notification of a notation declaration event.

      It is up to the application to record the notation for later reference, if necessary; notations may appear as attribute values and in unparsed entity declarations, and are sometime used with processing instruction target names.

      At least one of publicId and systemId must be non-null. If a system identifier is present, and it is a URL, the SAX parser must resolve it fully before passing it to the application through this event.

      There is no guarantee that the notation declaration will be reported before any unparsed entities that use it.

      Specified by:
        `notationDecl` in interface `DTDHandler`
      Parameters:
        `arg0` - The notation name.
        `arg1` - The notation's public identifier, or null if none was given.
        `arg2` - The notation's system identifier, or null if none was given.
      Throws:
        `SAXException` - Any SAX exception, possibly wrapping another exception.
      See Also:
        `DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)`

    - #### unparsedEntityDecl

          public void unparsedEntityDecl(java.lang.String arg0,
                                java.lang.String arg1,
                                java.lang.String arg2,
                                java.lang.String arg3)
                                  throws SAXException

      Description copied from interface: `DTDHandler`
      Receive notification of an unparsed entity declaration event.

      Note that the notation name corresponds to a notation reported by the `notationDecl` event. It is up to the application to record the entity for later reference, if necessary; unparsed entities may appear as attribute values.

      If the system identifier is a URL, the parser must resolve it fully before passing it to the application.

      Specified by:
        `unparsedEntityDecl` in interface `DTDHandler`
      Parameters:
        `arg0` - The unparsed entity's name.
        `arg1` - The entity's public identifier, or null if none was given.
        `arg2` - The entity's system identifier.
        `arg3` - The name of the associated notation.
      Throws:
        `SAXException` - Any SAX exception, possibly wrapping another exception.
      See Also:
        `DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)`

    - #### setDTDEntityExpansion

          public void setDTDEntityExpansion(boolean expand)

      If set to false the serializer does not expand DTD entities, but leaves them as is, the default value is true.
      Specified by:
        `setDTDEntityExpansion` in interface `SerializationHandler`
      Parameters:
        `expand` - true if DTD entities are to be expanded, false if they are to be left as DTD entity references.

    - #### documentIsEmpty

          public boolean documentIsEmpty()

      Return true if nothing has been sent to this result tree yet.

      This is not a public API.

      Usage:
        **For internal use only**

    - #### getOutputProperty

          public java.lang.String getOutputProperty(java.lang.String name)

      Get the value of an output property, the explicit value, if any, otherwise the default value, if any, otherwise null.
      Parameters:
        `name` - The name of the property, which is just the local name if it is in no namespace, but is the URI in curly braces followed by the local name if it is in a namespace, for example:
        - "encoding"
        - "method"
        - "{http://xml.apache.org/xalan}indent-amount"
        - "{http://xml.apache.org/xalan}line-separator"
      Returns:
        The value of the parameter

    - #### getOutputPropertyNonDefault

          public java.lang.String getOutputPropertyNonDefault(java.lang.String name)

      Get the value of an output property, not the default value. If there is a default value, but no non-default value this method will return null.

    - #### asDOM3Serializer

          public java.lang.Object asDOM3Serializer()
                                            throws java.io.IOException

      Return a `DOM3Serializer` interface into this serializer. If the serializer does not support the `DOM3Serializer` interface, it should return null.
      Specified by:
        `asDOM3Serializer` in interface `Serializer`
      Returns:
        A `DOM3Serializer` interface into this serializer, or null if the serializer is not DOM capable
      Throws:
        `java.io.IOException` - An I/O exception occured
      See Also:
        `Serializer.asDOM3Serializer()`

    - #### getOutputPropertyDefault

          public java.lang.String getOutputPropertyDefault(java.lang.String name)

      Get the default value of an xsl:output property, which would be null only if no default value exists for the property.
      Parameters:
        `name` - The name of the property.
      Returns:
        The default value of the parameter, or null if there is no default value.

    - #### setOutputProperty

          public void setOutputProperty(java.lang.String name,
                               java.lang.String val)

      Set the value for the output property, typically from an xsl:output element, but this does not change what the default value is.
      Parameters:
        `name` - The name of the property, which is just the local name if it is in no namespace, but is the URI in curly braces followed by the local name if it is in a namespace, for example:
        - "encoding"
        - "method"
        - "{http://xml.apache.org/xalan}indent-amount"
        - "{http://xml.apache.org/xalan}line-separator"

    - #### setOutputPropertyDefault

          public void setOutputPropertyDefault(java.lang.String name,
                                      java.lang.String val)

      Set the default value for an output property, but this does not impact any explicitly set value.
      Parameters:
        `name` - The name of the property, which is just the local name if it is in no namespace, but is the URI in curly braces followed by the local name if it is in a namespace, for example:
        - "encoding"
        - "method"
        - "{http://xml.apache.org/xalan}indent-amount"
        - "{http://xml.apache.org/xalan}line-separator"

    - #### setCdataSectionElements

          public void setCdataSectionElements(java.util.Vector URI_and_localNames)

      Sets the value coming from the xsl:output cdata-section-elements stylesheet property. This sets the elements whose text elements are to be output as CDATA sections.
      Parameters:
        `URI_and_localNames` - pairs of namespace URI and local names that identify elements whose text elements are to be output as CDATA sections. The namespace of the local element must be the given URI to match. The qName is not given because the prefix does not matter, only the namespace URI to which that prefix would map matters, so the prefix itself is not relevant in specifying which elements have their text to be output as CDATA sections.

Copyright © 2014 Apache XML Project. All Rights Reserved.