Top Description Fields Methods
com.sun.org.apache.xml.internal.serializer

public Interface SerializationHandler

extends ExtendedContentHandler, ExtendedLexicalHandler, XSLOutputAttributes, DeclHandler, DTDHandler, ErrorHandler, DOMSerializer, Serializer
Known Direct Implementers
com.sun.org.apache.xml.internal.serializer.SerializerBase, com.sun.org.apache.xml.internal.serializer.EmptySerializer
Imports
java.io.IOException, javax.xml.transform.Transformer, org.w3c.dom.Node, org.xml.sax.ContentHandler, .ErrorHandler, .SAXException, org.xml.sax.ext.DeclHandler

This interface is the one that a serializer implements. It is a group of other interfaces, such as ExtendedContentHandler, ExtendedLexicalHandler etc. In addition there are other methods, such as reset(). This class is public only because it is used in another package, it is not a public API.

Field Summary

Inherited from com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler:
HTML_ATTREMPTYHTML_ATTRURLNO_BAD_CHARS

Method Summary

Modifier and TypeMethod and Description
public void
public void
flushPending()

A SerializationHandler accepts SAX-like events, so it can accumulate attributes or namespace nodes after a startElement().

public Transformer

Returns:

Transformer the transformer associated with the serializer.
getTransformer
()

Get the transformer associated with the serializer.

public void
serialize(Node
the DOM node to be serialized.
node
)

Redeclares com.sun.org.apache.xml.internal.serializer.DOMSerializer.serialize.

Notify that the serializer should take this DOM node as input to be serialized.

public void
setContentHandler(ContentHandler ch)

Set the SAX Content handler that the serializer sends its output to.

public void
setDTDEntityExpansion(boolean
true if DTD entities are to be expanded, false if they are to be left as DTD entity references.
expand
)

Default behavior is to expand DTD entities, that is the initall default value is true.

public boolean
setEscaping(boolean
true if escaping is to be set on.
escape
)

Turns special character escaping on/off.

public void
setIndentAmount(int
the number of spaces to indent for each indentation level.
spaces
)

Set the number of spaces to indent for each indentation level.

public void
setIsStandalone(boolean
true if the property "jdk.xml.xsltcIsStandalone" is set to yes
b
)

Specify if the output will be treated as a standalone property

public void
setNamespaceMappings(NamespaceMappings
NamespaceMappings
mappings
)

Used only by TransformerSnapshotImpl to restore the serialization to a previous state.

public void
setTransformer(Transformer
the transformer associated with the serializer.
transformer
)

Set the transformer associated with the serializer.

Inherited from com.sun.org.apache.xml.internal.serializer.ExtendedContentHandler:
addAttributeaddAttributeaddAttributeaddAttributesaddUniqueAttributeaddXSLAttributecharacterscharactersendElemententityReferencegetNamespaceMappingsgetNamespaceURIgetNamespaceURIFromPrefixgetPrefixnamespaceAfterStartElementsetSourceLocatorstartElementstartElementstartPrefixMapping
Inherited from com.sun.org.apache.xml.internal.serializer.ExtendedLexicalHandler:
comment
Inherited from com.sun.org.apache.xml.internal.serializer.Serializer:
asContentHandlerasDOM3SerializerasDOMSerializergetOutputFormatgetOutputStreamgetWriterresetsetOutputFormatsetOutputStreamsetWriter
Inherited from com.sun.org.apache.xml.internal.serializer.XSLOutputAttributes:
getDoctypePublicgetDoctypeSystemgetEncodinggetIndentgetIndentAmountgetMediaTypegetOmitXMLDeclarationgetOutputPropertygetOutputPropertyDefaultgetStandalonegetVersionsetCdataSectionElementssetDoctypesetDoctypePublicsetDoctypeSystemsetEncodingsetIndentsetMediaTypesetOmitXMLDeclarationsetOutputPropertysetOutputPropertyDefaultsetStandalonesetVersion
Inherited from org.xml.sax.DTDHandler:
notationDeclunparsedEntityDecl
Inherited from org.xml.sax.ErrorHandler:
errorfatalErrorwarning
Inherited from org.xml.sax.ext.DeclHandler:
attributeDeclelementDeclexternalEntityDeclinternalEntityDecl

Method Detail

closeback to summary
public void close()
flushPendingback to summary
public void flushPending() throws SAXException

A SerializationHandler accepts SAX-like events, so it can accumulate attributes or namespace nodes after a startElement().

If the SerializationHandler has a Writer or OutputStream, a call to this method will flush such accumulated events as a closed start tag for an element.

If the SerializationHandler wraps a ContentHandler, a call to this method will flush such accumulated events as a SAX (not SAX-like) calls to startPrefixMapping() and startElement().

If one calls endDocument() then one need not call this method since a call to endDocument() will do what this method does. However, in some circumstances, such as with document fragments, endDocument() is not called and it may be necessary to call this method to flush any pending events.

For performance reasons this method should not be called very often.

getTransformerback to summary
public Transformer getTransformer()

Get the transformer associated with the serializer.

Returns:Transformer

Transformer the transformer associated with the serializer.

serializeback to summary
public void serialize(Node node) throws IOException

Redeclares com.sun.org.apache.xml.internal.serializer.DOMSerializer.serialize.

Notify that the serializer should take this DOM node as input to be serialized.

Parameters
node:Node

the DOM node to be serialized.

Exceptions
IOException:

Doc from com.sun.org.apache.xml.internal.serializer.DOMSerializer.serialize.

if an I/O exception occured while serializing

setContentHandlerback to summary
public void setContentHandler(ContentHandler ch)

Set the SAX Content handler that the serializer sends its output to. This method only applies to a ToSAXHandler, not to a ToStream serializer.

See Also
Serializer#asContentHandler(), ToSAXHandler
setDTDEntityExpansionback to summary
public void setDTDEntityExpansion(boolean expand)

Default behavior is to expand DTD entities, that is the initall default value is true.

Parameters
expand:boolean

true if DTD entities are to be expanded, false if they are to be left as DTD entity references.

setEscapingback to summary
public boolean setEscaping(boolean escape) throws SAXException

Turns special character escaping on/off. Note that characters will never, even if this option is set to 'true', be escaped within CDATA sections in output XML documents.

Parameters
escape:boolean

true if escaping is to be set on.

setIndentAmountback to summary
public void setIndentAmount(int spaces)

Set the number of spaces to indent for each indentation level.

Parameters
spaces:int

the number of spaces to indent for each indentation level.

setIsStandaloneback to summary
public void setIsStandalone(boolean b)

Specify if the output will be treated as a standalone property

Parameters
b:boolean

true if the property "jdk.xml.xsltcIsStandalone" is set to yes

See Also
JdkConstants.SP_XSLTC_IS_Standalone
setNamespaceMappingsback to summary
public void setNamespaceMappings(NamespaceMappings mappings)

Used only by TransformerSnapshotImpl to restore the serialization to a previous state.

Parameters
mappings:NamespaceMappings

NamespaceMappings

setTransformerback to summary
public void setTransformer(Transformer transformer)

Set the transformer associated with the serializer.

Parameters
transformer:Transformer

the transformer associated with the serializer.