SerializerBase (openjdk7-jaxp-external 7.60.33 API)

java.lang.Object
- jdk7u.jaxp.org.apache.xml.external.serializer.SerializerBase

All Implemented Interfaces:

DOMSerializer, SerializationHandler, Serializer, DTDHandler, ErrorHandler, DeclHandler

Direct Known Subclasses:

ToSAXHandler, ToStream, ToUnknownStream
```
public abstract class SerializerBase
extends 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.

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`CDATA_CONTINUE` To insert ]]> in a CDATA section by ending the last CDATA section with ]] and starting the next CDATA section with >
`static String`	`CDATA_DELIMITER_CLOSE` The constant "]]>"
`static String`	`CDATA_DELIMITER_OPEN`
`static String`	`DEFAULT_SAX_SERIALIZER`
`static String`	`EMPTYSTRING`
`static String`	`ENTITY_AMP`
`static String`	`ENTITY_CRLF`
`static String`	`ENTITY_GT`
`static String`	`ENTITY_LT`
`static String`	`ENTITY_QUOT`
`static int`	`HTML_ATTREMPTY`
`static int`	`HTML_ATTRURL`
`protected char[]`	`m_attrBuff` A utility buffer for converting Strings passed to attribute methods to character arrays.
`protected AttributesImplSerializer`	`m_attributes` All the attributes of the current element, collected from startPrefixMapping() calls, or addAddtribute() calls, or from the SAX attributes in a startElement() call.
`protected Vector`	`m_cdataSectionElements` Pairs of local names and corresponding URIs of CDATA sections.
`protected boolean`	`m_cdataTagOpen` True if a trailing "]]>" still needs to be written to be written out.
`protected char[]`	`m_charsBuff` A utility buffer for converting Strings passed to character() methods to character arrays.
`protected boolean`	`m_doIndent` Flag to tell if indenting (pretty-printing) is on.
`protected jdk7u.jaxp.org.apache.xml.external.serializer.ElemContext`	`m_elemContext` A reference to "stack frame" corresponding to the current element.
`protected int`	`m_indentAmount` Amount to indent.
`protected boolean`	`m_inEntityRef` Tells if we're in an EntityRef event.
`protected boolean`	`m_inExternalDTD` This flag is set while receiving events from the external DTD
`protected boolean`	`m_isStandalone` Determine if the output is a standalone.
`protected boolean`	`m_needToCallSetDocumentInfo`
`protected boolean`	`m_needToCallStartDocument` true if we still need to call startDocumentInternal()
`protected NamespaceMappings`	`m_prefixMap` Namespace support, that keeps track of currently defined prefix/uri mappings.
`protected SourceLocator`	`m_sourceLocator`
`protected boolean`	`m_standaloneWasSpecified` True if standalone was specified.
`protected SerializerTrace`	`m_tracer` Handle for firing generate events.
`protected Writer`	`m_writer` The writer to send output to.
`static int`	`NO_BAD_CHARS`
`static String`	`XML_PREFIX`
`static String`	`XMLNS_PREFIX`
`static String`	`XMLNS_URI`
`static String`	`XMLVERSION10`
`static String`	`XMLVERSION11` Define the XML version.

Constructor Summary

Constructors
Constructor and Description

SerializerBase()

Constructors
Constructor and Description
`SerializerBase()`

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addAttribute(String name, String value)` Adds the given attribute to the set of collected attributes, but only if there is a currently open element.
`void`	`addAttribute(String uri, String localName, String rawName, String type, String value)` This method adds an attribute the the current element, but should not be used for an xsl:attribute child.
`void`	`addAttribute(String uri, String localName, String rawName, String type, 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(String uri, String localName, String rawName, String type, 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`	`addUniqueAttribute(String qName, String value, int flags)` Add a unique attribute to the current element.
`void`	`addXSLAttribute(String name, String value, 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.
`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`	`characters(String chars)` This method is used to notify of a character event, but passing the data as a character String rather than the standard character array.
`void`	`close()` Flush and close the underlying java.io.Writer.
`void`	`comment(String data)` Receive notification of a comment.
`void`	`endElement(String elemName)` This method is used to notify that an element has ended.
`void`	`endEntity(String name)` Report the end of an entity.
`void`	`entityReference(String name)` Entity reference event.
`void`	`error(SAXParseException exc)`
`void`	`fatalError(SAXParseException exc)`
`protected void`	`fireCDATAEvent(char[] chars, int start, int length)` Report the CDATA trace event
`protected void`	`fireCharEvent(char[] chars, int start, int length)` Report the characters trace event
`protected void`	`fireCommentEvent(char[] chars, int start, int length)` Report the comment trace event
`protected void`	`fireEndDoc()` To fire off end document trace event
`protected void`	`fireEndElem(String name)` To fire off the end element trace event
`void`	`fireEndEntity(String name)` To fire off end entity trace event
`protected void`	`fireEntityReference(String name)` To fire off the entity reference trace event
`protected void`	`fireEscapingEvent(String name, String data)` To fire off the PI trace event
`protected void`	`fireStartDoc()` To fire off start document trace event
`protected void`	`fireStartElem(String elemName)` Report the start element trace event.
`protected void`	`fireStartEntity(String name)` To fire off start entity trace event
`String`	`getDoctypePublic()` Returns the previously set value of the value to be used as the public identifier in the document type declaration (DTD).
`String`	`getDoctypeSystem()` Returns the previously set value of the value to be used as the system identifier in the document type declaration (DTD).
`String`	`getEncoding()` Returns the character encoding to be used in the output document.
`boolean`	`getIndent()`
`int`	`getIndentAmount()`
`protected static String`	`getLocalName(String qname)` Returns the local name of a qualified name.
`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
`String`	`getNamespaceURI(String qname, boolean isElement)` Returns the URI of an element or attribute.
`String`	`getNamespaceURIFromPrefix(String prefix)` Returns the URI of prefix (if any)
`boolean`	`getOmitXMLDeclaration()`
`String`	`getPrefix(String namespaceURI)` Returns the prefix currently pointing to the given URI (if any).
`protected static String`	`getPrefixPart(String qname)` Returns the local name of a qualified name.
`String`	`getStandalone()` Gets the XSL standalone attribute
`Transformer`	`getTransformer()` Gets the transformer associated with this serializer
`String`	`getVersion()` Gets the version of the output format.
`protected void`	`initCDATA()` Initialize global variables
`protected boolean`	`isCdataSection()` Push a boolean state based on if the name of the current element is found in the list of qnames.
`void`	`namespaceAfterStartElement(String uri, 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(String arg0, String arg1, String arg2)`
`protected String`	`patchName(String qname)` If at runtime, when the qname of the attribute is known, another prefix is specified for the attribute, then we can patch or hack the name with this method.
`boolean`	`reset()` This method resets the serializer.
`void`	`setCdataSectionElements(Vector URI_and_localNames)` Sets the value coming from the xsl:output cdata-section-elements stylesheet property.
`void`	`setDoctype(String doctypeSystem, String doctypePublic)` Set the value coming from the xsl:output doctype-public and doctype-system stylesheet properties
`void`	`setDoctypePublic(String doctypePublic)` Set the value coming from the xsl:output doctype-public stylesheet attribute.
`void`	`setDoctypeSystem(String doctypeSystem)` Set the value coming from the xsl:output doctype-system stylesheet attribute.
`protected void`	`setDocumentInfo()`
`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(String m_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`	`setIsStandalone(boolean isStandalone)` Sets the isStandalone property
`void`	`setMediaType(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`	`setSourceLocator(SourceLocator locator)` This method is used to set the source locator, which might be used to generated an error message.
`void`	`setStandalone(String standalone)` Sets the value coming from the xsl:output standalone stylesheet attribute.
`protected void`	`setStandaloneInternal(String standalone)` Sets the XSL standalone attribute, but does not remember if this is a default or explicite setting.
`void`	`setTransformer(Transformer t)` Sets the transformer associated with this serializer
`void`	`setVersion(String version)` Sets the value coming from the xsl:output version attribute.
`void`	`startDocument()` Receive notification of the beginning of a document.
`protected void`	`startDocumentInternal()` This method handles what needs to be done at a startDocument() call, whether from an external caller, or internally called in the serializer.
`void`	`startElement(String qName)` This method is used to notify of the start of an element
`void`	`startElement(String uri, String localName, String qName)` This method is used to notify that an element is starting.
`boolean`	`startPrefixMapping(String prefix, String uri, boolean shouldFlush)` This method is used to notify that a prefix maping is to start, which can be for the current element, or for the one to come.
`void`	`unparsedEntityDecl(String arg0, String arg1, String arg2, String arg3)`
`void`	`warning(SAXParseException exc)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface jdk7u.jaxp.org.apache.xml.external.serializer.SerializationHandler
flushPending, serialize, setContentHandler, setEscaping

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 jdk7u.jaxp.org.apache.xml.external.serializer.Serializer
getOutputFormat, getOutputStream, getWriter, setOutputFormat, setOutputStream, setWriter

- Field Detail
  - m_needToCallStartDocument
```
protected boolean m_needToCallStartDocument
```
    true if we still need to call startDocumentInternal()
  - m_cdataTagOpen
```
protected boolean m_cdataTagOpen
```
    True if a trailing "]]>" still needs to be written to be written out. Used to merge adjacent CDATA sections
  - m_attributes
```
protected AttributesImplSerializer m_attributes
```
    All the attributes of the current element, collected from startPrefixMapping() calls, or addAddtribute() calls, or from the SAX attributes in a startElement() call.
  - m_inEntityRef
```
protected boolean m_inEntityRef
```
    Tells if we're in an EntityRef event.
  - m_inExternalDTD
```
protected boolean m_inExternalDTD
```
    This flag is set while receiving events from the external DTD
  - m_standaloneWasSpecified
```
protected boolean m_standaloneWasSpecified
```
    True if standalone was specified.
  - m_isStandalone
```
protected boolean m_isStandalone
```
    Determine if the output is a standalone.
  - m_doIndent
```
protected boolean m_doIndent
```
    Flag to tell if indenting (pretty-printing) is on.
  - m_indentAmount
```
protected int m_indentAmount
```
    Amount to indent.
  - m_cdataSectionElements
```
protected Vector m_cdataSectionElements
```
    Pairs of local names and corresponding URIs of CDATA sections. This list comes from the cdata-section-elements attribute. Every second one is a local name, and every other second one is the URI for the local name.
  - m_prefixMap
```
protected NamespaceMappings m_prefixMap
```
    Namespace support, that keeps track of currently defined prefix/uri mappings. As processed elements come and go, so do the associated mappings for that element.
  - m_tracer
```
protected SerializerTrace m_tracer
```
    Handle for firing generate events. This interface may be implemented by the referenced transformer object.
  - m_sourceLocator
```
protected SourceLocator m_sourceLocator
```
  - m_writer
```
protected Writer m_writer
```
    The writer to send output to. This field is only used in the ToStream serializers, but exists here just so that the fireStartDoc() and other fire... methods can flush this writer when tracing.
  - m_elemContext
```
protected jdk7u.jaxp.org.apache.xml.external.serializer.ElemContext m_elemContext
```
    A reference to "stack frame" corresponding to the current element. Such a frame is pushed at a startElement() and popped at an endElement(). This frame contains information about the element, such as its namespace URI.
  - m_charsBuff
```
protected char[] m_charsBuff
```
    A utility buffer for converting Strings passed to character() methods to character arrays. Reusing this buffer means not creating a new character array everytime and it runs faster.
  - m_attrBuff
```
protected char[] m_attrBuff
```
    A utility buffer for converting Strings passed to attribute methods to character arrays. Reusing this buffer means not creating a new character array everytime and it runs faster.
  - m_needToCallSetDocumentInfo
```
protected boolean m_needToCallSetDocumentInfo
```
  - NO_BAD_CHARS
```
public static final int NO_BAD_CHARS
```
    See Also:
    Constant Field Values
  - HTML_ATTREMPTY
```
public static final int HTML_ATTREMPTY
```
    See Also:
    Constant Field Values
  - HTML_ATTRURL
```
public static final int HTML_ATTRURL
```
    See Also:
    Constant Field Values
  - CDATA_CONTINUE
```
public static final 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 String CDATA_DELIMITER_CLOSE
```
    The constant "]]>"
    
    See Also:
    Constant Field Values
  - CDATA_DELIMITER_OPEN
```
public static final String CDATA_DELIMITER_OPEN
```
    See Also:
    Constant Field Values
  - EMPTYSTRING
```
public static final String EMPTYSTRING
```
    See Also:
    Constant Field Values
  - ENTITY_AMP
```
public static final String ENTITY_AMP
```
    See Also:
    Constant Field Values
  - ENTITY_CRLF
```
public static final String ENTITY_CRLF
```
    See Also:
    Constant Field Values
  - ENTITY_GT
```
public static final String ENTITY_GT
```
    See Also:
    Constant Field Values
  - ENTITY_LT
```
public static final String ENTITY_LT
```
    See Also:
    Constant Field Values
  - ENTITY_QUOT
```
public static final String ENTITY_QUOT
```
    See Also:
    Constant Field Values
  - XML_PREFIX
```
public static final String XML_PREFIX
```
    See Also:
    Constant Field Values
  - XMLNS_PREFIX
```
public static final String XMLNS_PREFIX
```
    See Also:
    Constant Field Values
  - XMLNS_URI
```
public static final String XMLNS_URI
```
    See Also:
    Constant Field Values
  - DEFAULT_SAX_SERIALIZER
```
public static final String DEFAULT_SAX_SERIALIZER
```
    See Also:
    Constant Field Values
  - XMLVERSION11
```
public static final String XMLVERSION11
```
    Define the XML version.
    
    See Also:
    Constant Field Values
  - XMLVERSION10
```
public static final String XMLVERSION10
```
    See Also:
    Constant Field Values
- Constructor Detail
  - SerializerBase
```
public SerializerBase()
```
- Method Detail
  - fireEndElem
```
protected void fireEndElem(String name)
                    throws SAXException
```
    To fire off the end element trace event
    
    Parameters:
    name - Name of element
    
    Throws:
    
    SAXException
  - fireCharEvent
```
protected void fireCharEvent(char[] chars,
                 int start,
                 int length)
                      throws SAXException
```
    Report the characters trace event
    
    Parameters:
    chars - content of characters
    start - starting index of characters to output
    length - number of characters to output
    
    Throws:
    
    SAXException
  - comment
```
public void comment(String data)
             throws SAXException
```
    Receive notification of a comment.
    
    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)
  - patchName
```
protected String patchName(String qname)
```
    If at runtime, when the qname of the attribute is known, another prefix is specified for the attribute, then we can patch or hack the name with this method. For a qname of the form "ns?:otherprefix:name", this function patches the qname by simply ignoring "otherprefix". TODO: This method is a HACK! We do not have access to the XML file, it sometimes generates a NS prefix of the form "ns?" for an attribute.
  - getLocalName
```
protected static String getLocalName(String qname)
```
    Returns the local name of a qualified name. If the name has no prefix, then it works as the identity (SAX2).
    
    Parameters:
    qname - the qualified name
    
    Returns:
    the name, but excluding any prefix and colon.
  - setDocumentLocator
```
public void setDocumentLocator(Locator locator)
```
    Receive an object for locating the origin of SAX document events.
    
    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.
  - addAttribute
```
public void addAttribute(String uri,
                String localName,
                String rawName,
                String type,
                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.
    
    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(String uri,
                         String localName,
                         String rawName,
                         String type,
                         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(String name,
                String value)
```
    Adds the given attribute to the set of collected attributes, but only if there is a currently open element.
    
    Parameters:
    name - the attribute's qualified name
    value - the value of the attribute
  - addXSLAttribute
```
public void addXSLAttribute(String name,
                   String value,
                   String uri)
```
    Adds the given xsl:attribute to the set of collected attributes, but only if there is a currently open element.
    
    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.
    
    Parameters:
    atts - List of attributes to add to this list
    
    Throws:
    
    SAXException
  - asContentHandler
```
public ContentHandler asContentHandler()
                                throws 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:
    
    IOException - An I/O exception occured
  - endEntity
```
public void endEntity(String name)
               throws SAXException
```
    Report the end of an entity.
    
    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
  - initCDATA
```
protected void initCDATA()
```
    Initialize global variables
  - getEncoding
```
public 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(String m_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 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(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 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(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(String doctypeSystem,
              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(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.
  - setStandaloneInternal
```
protected void setStandaloneInternal(String standalone)
```
    Sets the XSL standalone attribute, but does not remember if this is a default or explicite setting.
    
    Parameters:
    standalone - "yes" | "no"
  - getStandalone
```
public 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 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 String getVersion()
```
    Gets the version of the output format.
    
    Returns:
    the version of the output format.
  - setVersion
```
public void setVersion(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(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)
  - setIsStandalone
```
public void setIsStandalone(boolean isStandalone)
```
    Sets the isStandalone property
    
    Specified by:
    
    setIsStandalone in interface SerializationHandler
    
    Parameters:
    isStandalone - true if the ORACLE_IS_STANDALONE is set to yes
    See Also:
    ORACLE_IS_STANDALONE
  - namespaceAfterStartElement
```
public void namespaceAfterStartElement(String uri,
                              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.
    
    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 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:
    
    IOException - An I/O exception occured
    See Also:
    Serializer.asDOMSerializer()
  - isCdataSection
```
protected boolean isCdataSection()
```
    Push a boolean state based on if the name of the current element is found in the list of qnames. A state is only pushed if there were some cdata-section-names were specified.
    Hidden parameters are the vector of qualified elements specified in cdata-section-names attribute, and the m_cdataSectionStates stack onto which whether the current element is in the list is pushed (true or false). Other hidden parameters are the current elements namespaceURI, localName and qName
  - getPrefixPart
```
protected static final String getPrefixPart(String qname)
```
    Returns the local name of a qualified name. If the name has no prefix, then it works as the identity (SAX2).
    
    Parameters:
    qname - a qualified name
    
    Returns:
    returns the prefix of the qualified name, or null if there is no prefix.
  - getNamespaceMappings
```
public NamespaceMappings getNamespaceMappings()
```
    Some users of the serializer may need the current namespace mappings
    
    Returns:
    the current namespace mappings (prefix/uri)
    See Also:
    ExtendedContentHandler.getNamespaceMappings()
  - getPrefix
```
public String getPrefix(String namespaceURI)
```
    Returns the prefix currently pointing to the given URI (if any).
    
    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 String getNamespaceURI(String qname,
                     boolean isElement)
```
    Returns the URI of an element or attribute. Note that default namespaces do not apply directly to attributes.
    
    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 String getNamespaceURIFromPrefix(String prefix)
```
    Returns the URI of prefix (if any)
    
    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(String name)
                     throws SAXException
```
    Entity reference event.
    
    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.
    
    Parameters:
    node - the Node to serialize
    
    Throws:
    
    SAXException
  - error
```
public void error(SAXParseException exc)
           throws SAXException
```
    Specified by:
    
    error in interface ErrorHandler
    
    Throws:
    
    SAXException
    See Also:
    ErrorHandler.error(SAXParseException)
  - fatalError
```
public void fatalError(SAXParseException exc)
                throws SAXException
```
    Specified by:
    
    fatalError in interface ErrorHandler
    
    Throws:
    
    SAXException
    See Also:
    ErrorHandler.fatalError(SAXParseException)
  - warning
```
public void warning(SAXParseException exc)
             throws SAXException
```
    Specified by:
    
    warning in interface ErrorHandler
    
    Throws:
    
    SAXException
    See Also:
    ErrorHandler.warning(SAXParseException)
  - fireStartEntity
```
protected void fireStartEntity(String name)
                        throws SAXException
```
    To fire off start entity trace event
    
    Parameters:
    name - Name of entity
    
    Throws:
    
    SAXException
  - fireCDATAEvent
```
protected void fireCDATAEvent(char[] chars,
                  int start,
                  int length)
                       throws SAXException
```
    Report the CDATA trace event
    
    Parameters:
    chars - content of CDATA
    start - starting index of characters to output
    length - number of characters to output
    
    Throws:
    
    SAXException
  - fireCommentEvent
```
protected void fireCommentEvent(char[] chars,
                    int start,
                    int length)
                         throws SAXException
```
    Report the comment trace event
    
    Parameters:
    chars - content of comment
    start - starting index of comment to output
    length - number of characters to output
    
    Throws:
    
    SAXException
  - fireEndEntity
```
public void fireEndEntity(String name)
                   throws SAXException
```
    To fire off end entity trace event
    
    Parameters:
    name - Name of entity
    
    Throws:
    
    SAXException
  - fireStartDoc
```
protected void fireStartDoc()
                     throws SAXException
```
    To fire off start document trace event
    
    Throws:
    
    SAXException
  - fireEndDoc
```
protected void fireEndDoc()
                   throws SAXException
```
    To fire off end document trace event
    
    Throws:
    
    SAXException
  - fireStartElem
```
protected void fireStartElem(String elemName)
                      throws SAXException
```
    Report the start element trace event. This trace method needs to be called just before the attributes are cleared.
    
    Parameters:
    elemName - the qualified name of the element
    
    Throws:
    
    SAXException
  - fireEscapingEvent
```
protected void fireEscapingEvent(String name,
                     String data)
                          throws SAXException
```
    To fire off the PI trace event
    
    Parameters:
    name - Name of PI
    
    Throws:
    
    SAXException
  - fireEntityReference
```
protected void fireEntityReference(String name)
                            throws SAXException
```
    To fire off the entity reference trace event
    
    Parameters:
    name - Name of entity reference
    
    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).
    
    Throws:
    
    SAXException - Any SAX exception, possibly wrapping another exception.
    
    SAXException
  - startDocumentInternal
```
protected void startDocumentInternal()
                              throws SAXException
```
    This method handles what needs to be done at a startDocument() call, whether from an external caller, or internally called in the serializer. For historical reasons the serializer is flexible to startDocument() not always being called. Even if no external call is made into startDocument() this method will always be called as a self generated internal startDocument, it handles what needs to be done at a startDocument() call. This method exists just to make sure that startDocument() is only ever called from an external caller, which in principle is just a matter of style.
    
    Throws:
    
    SAXException
  - setDocumentInfo
```
protected void setDocumentInfo()
```
  - setSourceLocator
```
public void setSourceLocator(SourceLocator locator)
```
    This method is used to set the source locator, which might be used to generated an error message.
    
    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(String uri,
                String localName,
                String rawName,
                String type,
                String value)
                  throws SAXException
```
    This method adds an attribute the the current element, but should not be used for an xsl:attribute child.
    
    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(String arg0,
                String arg1,
                String arg2)
                  throws SAXException
```
    Specified by:
    
    notationDecl in interface DTDHandler
    
    Throws:
    
    SAXException
    See Also:
    DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)
  - unparsedEntityDecl
```
public void unparsedEntityDecl(String arg0,
                      String arg1,
                      String arg2,
                      String arg3)
                        throws SAXException
```
    Specified by:
    
    unparsedEntityDecl in interface DTDHandler
    
    Throws:
    
    SAXException
    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.
  - characters
```
public void characters(String chars)
                throws SAXException
```
    This method is used to notify of a character event, but passing the data as a character String rather than the standard character array.
    
    Parameters:
    chars - the character data
    
    Throws:
    
    SAXException
  - endElement
```
public void endElement(String elemName)
                throws SAXException
```
    This method is used to notify that an element has ended. Unlike the standard SAX method
```
 endElement(namespaceURI,localName,qName)
 
```
    only the last parameter is passed. If needed the serializer can derive the localName from the qualified name and derive the namespaceURI from its implementation.
    Parameters:
    elemName - the fully qualified element name.
    
    Throws:
    
    SAXException
  - startElement
```
public void startElement(String uri,
                String localName,
                String qName)
                  throws SAXException
```
    This method is used to notify that an element is starting. This method is just like the standard SAX method
```
 startElement(uri,localName,qname,atts)
 
```
    but without the attributes.
    Parameters:
    uri - the namespace URI of the element
    localName - the local name (without prefix) of the element
    qName - the qualified name of the element
    
    Throws:
    
    SAXException
  - startElement
```
public void startElement(String qName)
                  throws SAXException
```
    This method is used to notify of the start of an element
    
    Parameters:
    qName - the fully qualified name of the element
    
    Throws:
    
    SAXException
  - startPrefixMapping
```
public boolean startPrefixMapping(String prefix,
                         String uri,
                         boolean shouldFlush)
                           throws SAXException
```
    This method is used to notify that a prefix maping is to start, which can be for the current element, or for the one to come.
    
    Parameters:
    prefix - the prefix that maps to the given URI
    uri - the namespace URI of the given prefix
    shouldFlush - if true this call is like the SAX startPrefixMapping(prefix,uri) call and the mapping applies to the element to come. If false the mapping applies to the current element.
    
    Returns:
    boolean false if the prefix mapping was already in effect (in other words we are just re-declaring), true if this is a new, never before seen mapping for the element.
    
    Throws:
    
    SAXException
  - addUniqueAttribute
```
public void addUniqueAttribute(String qName,
                      String value,
                      int flags)
                        throws SAXException
```
    Add a unique attribute to the current element. The attribute is guaranteed to be unique here. The serializer can write it out immediately without saving it in a table first. The integer flag contains information about the attribute, which helps the serializer to decide whether a particular processing is needed.
    
    Parameters:
    qName - the fully qualified attribute name.
    value - the attribute value
    flags - a bitwise flag
    
    Throws:
    
    SAXException
  - setCdataSectionElements
```
public void setCdataSectionElements(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.

Class SerializerBase

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface jdk7u.jaxp.org.apache.xml.external.serializer.SerializationHandler

Methods inherited from interface org.xml.sax.ContentHandler

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

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

Methods inherited from interface jdk7u.jaxp.org.apache.xml.external.serializer.Serializer

Field Detail

m_needToCallStartDocument

m_cdataTagOpen

m_attributes

m_inEntityRef

m_inExternalDTD

m_standaloneWasSpecified

m_isStandalone

m_doIndent

m_indentAmount

m_cdataSectionElements

m_prefixMap

m_tracer

m_sourceLocator

m_writer

m_elemContext

m_charsBuff

m_attrBuff

m_needToCallSetDocumentInfo

NO_BAD_CHARS

HTML_ATTREMPTY

HTML_ATTRURL

CDATA_CONTINUE

CDATA_DELIMITER_CLOSE

CDATA_DELIMITER_OPEN

EMPTYSTRING

ENTITY_AMP

ENTITY_CRLF

ENTITY_GT

ENTITY_LT

ENTITY_QUOT

XML_PREFIX

XMLNS_PREFIX

XMLNS_URI

DEFAULT_SAX_SERIALIZER

XMLVERSION11

XMLVERSION10

Constructor Detail

SerializerBase

Method Detail

fireEndElem

fireCharEvent

comment

patchName

getLocalName

setDocumentLocator

addAttribute

addAttributeAlways

addAttribute

addXSLAttribute

addAttributes

asContentHandler

endEntity

close

initCDATA

getEncoding

setEncoding

setOmitXMLDeclaration

getOmitXMLDeclaration

getDoctypePublic

setDoctypePublic

getDoctypeSystem

setDoctypeSystem

setDoctype

setStandalone

setStandaloneInternal

getStandalone

getIndent

getMediaType

getVersion