public interface Serializer
To serialize a document using SAX events, create a compatible serializer
and pass it around as a DocumentHandler
. If an I/O error occurs while serializing, it will
be thrown by DocumentHandler.endDocument()
. The SAX serializer
may also be used as DTDHandler
, DeclHandler
and
LexicalHandler
.
To serialize a DOM document or DOM element, create a compatible
serializer and call it's DOMSerializer.serialize(Document)
or DOMSerializer.serialize(Element)
methods.
Both methods would produce a full XML document, to serizlie only
the portion of the document use OutputFormat.setOmitXMLDeclaration(boolean)
and specify no document type.
The OutputFormat
dictates what underlying serialized is used
to serialize the document based on the specified method. If the output
format or method are missing, the default is an XML serializer with
UTF-8 encoding and now indentation.
DocumentHandler
,
ContentHandler
,
OutputFormat
,
DOMSerializer
Modifier and Type | Method and Description |
---|---|
ContentHandler |
asContentHandler()
Deprecated.
Return a
ContentHandler interface into this serializer. |
DocumentHandler |
asDocumentHandler()
Deprecated.
Return a
DocumentHandler interface into this serializer. |
DOMSerializer |
asDOMSerializer()
Deprecated.
Return a
DOMSerializer interface into this serializer. |
void |
setOutputByteStream(OutputStream output)
Deprecated.
Specifies an output stream to which the document should be
serialized.
|
void |
setOutputCharStream(Writer output)
Deprecated.
Specifies a writer to which the document should be serialized.
|
void |
setOutputFormat(OutputFormat format)
Deprecated.
Specifies an output format for this serializer.
|
void setOutputByteStream(OutputStream output)
void setOutputCharStream(Writer output)
void setOutputFormat(OutputFormat format)
format
- The output format to useDocumentHandler asDocumentHandler() throws IOException
DocumentHandler
interface into this serializer.
If the serializer does not support the DocumentHandler
interface, it should return null.IOException
ContentHandler asContentHandler() throws IOException
ContentHandler
interface into this serializer.
If the serializer does not support the ContentHandler
interface, it should return null.IOException
DOMSerializer asDOMSerializer() throws IOException
DOMSerializer
interface into this serializer.
If the serializer does not support the DOMSerializer
interface, it should return null.IOException
Copyright © 2017 JBoss by Red Hat. All rights reserved.