org.apache.xml.serializer

Interface SerializationHandler

public interface SerializationHandler extends ExtendedContentHandler, ExtendedLexicalHandler, XSLOutputAttributes, DeclHandler, DTDHandler, ErrorHandler, DOMSerializer, Serializer

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.

UNKNOWN: internal

Method Summary
voidclose()
voidflushPending()
A SerializationHandler accepts SAX-like events, so it can accumulate attributes or namespace nodes after a startElement().
TransformergetTransformer()
Get the transformer associated with the serializer.
voidserialize(Node node)
Notify that the serializer should take this DOM node as input to be serialized.
voidsetContentHandler(ContentHandler ch)
Set the SAX Content handler that the serializer sends its output to.
voidsetDTDEntityExpansion(boolean expand)
Default behavior is to expand DTD entities, that is the initall default value is true.
booleansetEscaping(boolean escape)
Turns special character escaping on/off.
voidsetIndentAmount(int spaces)
Set the number of spaces to indent for each indentation level.
voidsetNamespaceMappings(NamespaceMappings mappings)
Used only by TransformerSnapshotImpl to restore the serialization to a previous state.
voidsetTransformer(Transformer transformer)
Set the transformer associated with the serializer.

Method Detail

close

public void close()

flushPending

public void flushPending()
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.

getTransformer

public Transformer getTransformer()
Get the transformer associated with the serializer.

Returns: Transformer the transformer associated with the serializer.

serialize

public void serialize(Node node)
Notify that the serializer should take this DOM node as input to be serialized.

Parameters: node the DOM node to be serialized.

Throws: IOException

setContentHandler

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: asContentHandler ToSAXHandler

setDTDEntityExpansion

public void setDTDEntityExpansion(boolean expand)
Default behavior is to expand DTD entities, that is the initall default value is true.

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

setEscaping

public boolean setEscaping(boolean escape)
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 true if escaping is to be set on.

setIndentAmount

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

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

setNamespaceMappings

public void setNamespaceMappings(NamespaceMappings mappings)
Used only by TransformerSnapshotImpl to restore the serialization to a previous state.

Parameters: mappings NamespaceMappings

setTransformer

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

Parameters: transformer the transformer associated with the serializer.

Copyright B) 2006 Apache XML Project. All Rights Reserved.