java.lang.Object | ||
↳ | org.apache.xml.serialize.BaseMarkupSerializer | |
↳ | org.apache.xml.serialize.TextSerializer |
This class is deprecated.
This class was deprecated in Xerces 2.9.0. It is recommended
that new applications use the DOM Level 3 LSSerializer or JAXP's Transformation
API for XML (TrAX) for serializing XML and HTML. See the Xerces documentation for more
information.
Implements a text serializer supporting both DOM and SAX
serializing. For usage instructions see Serializer
.
If an output stream is used, the encoding is taken from the output format (defaults to UTF-8). If a writer is used, make sure the writer uses the same encoding (if applies) as specified in the output format.
The serializer supports both DOM and SAX. DOM serializing is done
by calling serialize(Document)
and SAX serializing is done by firing
SAX events and using the serializer as a document handler.
If an I/O exception occurs while serializing, the serializer
will not throw an exception directly, but only throw it
at the end of serializing (either DOM or SAX's endDocument()
.
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.xml.serialize.BaseMarkupSerializer
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Constructs a new serializer.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Specifies an output format for this serializer.
| |||||||||||
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Must be called by a method about to print any type of content.
| |||||||||||
Returns the suitable entity reference for this character value,
or null if no such entity exists.
| |||||||||||
Called to serialize a DOM element.
| |||||||||||
Serialize the DOM node.
| |||||||||||
Called to serialize the document's DOCTYPE by the root element.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.xml.serialize.BaseMarkupSerializer
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
org.apache.xml.serialize.DOMSerializer
| |||||||||||
From interface
org.apache.xml.serialize.Serializer
| |||||||||||
From interface
org.xml.sax.ContentHandler
| |||||||||||
From interface
org.xml.sax.DTDHandler
| |||||||||||
From interface
org.xml.sax.DocumentHandler
| |||||||||||
From interface
org.xml.sax.ext.DeclHandler
| |||||||||||
From interface
org.xml.sax.ext.LexicalHandler
|
Constructs a new serializer. The serializer cannot be used without
calling setOutputCharStream(Writer)
or setOutputByteStream(OutputStream)
first.
SAXException |
---|
Specifies an output format for this serializer. It the serializer has already been associated with an output format, it will switch to the new format. This method should not be called while the serializer is in the process of serializing a document.
format | The output format to use |
---|
SAXException |
---|
Must be called by a method about to print any type of content. If the element was just opened, the opening tag is closed and will be matched to a closing tag. Returns the current element state with empty and afterElement set to false.
Returns the suitable entity reference for this character value, or null if no such entity exists. Calling this method with '&' will return "&".
ch | Character value |
---|
Called to serialize a DOM element. Equivalent to calling startElement(String, String, String, Attributes)
, endElement(String)
and serializing everything
inbetween, but better optimized.
elem | The element to serialize |
---|
IOException |
---|
Serialize the DOM node. This method is unique to the Text serializer.
node | The node to serialize |
---|
IOException |
---|
Called to serialize the document's DOCTYPE by the root element.
This method will check if it has not been called before (_started
),
will serialize the document type declaration, and will serialize all
pre-root comments and PIs that were accumulated in the document
(see serializePreRoot()
). Pre-root will be serialized even if
this is not the first root element of the document.
IOException |
---|