|
BEA Systems, Inc. | |||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Interface for a DOM serializer implementation, factory for DOM and SAX serializers, and static methods for serializing DOM documents.
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
Method Summary | |
ContentHandler |
asContentHandler()
Return a ContentHandler interface into this serializer. |
DocumentHandler |
asDocumentHandler()
Return a DocumentHandler interface into this serializer. |
DOMSerializer |
asDOMSerializer()
Return a DOMSerializer interface into this serializer. |
void |
setOutputByteStream(OutputStream output)
Specifies an output stream to which the document should be serialized. |
void |
setOutputCharStream(Writer output)
Specifies a writer to which the document should be serialized. |
void |
setOutputFormat(OutputFormat format)
Specifies an output format for this serializer. |
Method Detail |
public ContentHandler asContentHandler() throws IOException
ContentHandler
interface into this serializer.
If the serializer does not support the ContentHandler
interface, it should return null.
IOException
public DocumentHandler asDocumentHandler() throws IOException
DocumentHandler
interface into this serializer.
If the serializer does not support the DocumentHandler
interface, it should return null.
IOException
public DOMSerializer asDOMSerializer() throws IOException
DOMSerializer
interface into this serializer.
If the serializer does not support the DOMSerializer
interface, it should return null.
IOException
public void setOutputByteStream(OutputStream output)
public void setOutputCharStream(Writer output)
public void setOutputFormat(OutputFormat format)
format
- The output format to use
|
Documentation is available at http://download.oracle.com/docs/cd/E13222_01/wls/docs91 Copyright 2005 BEA Systems Inc. |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |