Class XMLWriter
- All Implemented Interfaces:
ContentHandler
,DTDHandler
,EntityResolver
,ErrorHandler
,LexicalHandler
,XMLFilter
,XMLReader
- Direct Known Subclasses:
XMLSocketWriter
-
Field Summary
FieldsModifier and TypeFieldDescriptionprotected static final org.dom4j.io.OutputFormat
protected int
Stores the last type of node written so algorithms can refer to the previous node typeprotected static final String[]
protected boolean
Stores the xml:space attribute value of preserve for whitespace flagprotected Writer
The Writer used to output to -
Constructor Summary
ConstructorsConstructorDescriptionXMLWriter
(OutputStream out) XMLWriter
(OutputStream out, org.dom4j.io.OutputFormat format) XMLWriter
(org.dom4j.io.OutputFormat format) -
Method Summary
Modifier and TypeMethodDescriptionvoid
characters
(char[] ch, int start, int length) void
close()
Closes the underlying Writervoid
comment
(char[] ch, int start, int length) protected Writer
createWriter
(OutputStream outStream, String encoding) Get an OutputStreamWriter, use preferred encoding.protected int
Returns the maximum allowed character code that should be allowed unescaped which defaults to 127 in US-ASCII (7 bit) or 255 in ISO-* (8 bit).void
endCDATA()
void
void
endDTD()
void
endElement
(String namespaceURI, String localName, String qName) void
void
endPrefixMapping
(String prefix) protected String
This will take the pre-defined entities in XML 1.0 and convert their character representation to the appropriate entity reference, suitable for XML attributes.protected String
escapeElementEntities
(String text) This will take the pre-defined entities in XML 1.0 and convert their character representation to the appropriate entity reference, suitable for XML attributes.void
flush()
Flushes the underlying Writerint
Returns the maximum allowed character code that should be allowed unescaped which defaults to 127 in US-ASCII (7 bit) or 255 in ISO-* (8 bit).protected org.dom4j.io.OutputFormat
Lets subclasses get at the current format object, so they can call setTrimText, setNewLines, etc.getProperty
(String name) protected void
void
ignorableWhitespace
(char[] ch, int start, int length) protected void
indent()
protected void
protected final boolean
isElementSpacePreserved
(org.dom4j.Element element) Determines if element is a special case of XML elements where it contains an xml:space attribute of "preserve".boolean
protected boolean
protected boolean
isNamespaceDeclaration
(org.dom4j.Namespace ns) void
notationDecl
(String name, String publicID, String systemID) void
parse
(InputSource source) void
println()
Writes the new line text to the underlying Writervoid
processingInstruction
(String target, String data) boolean
void
setDocumentLocator
(Locator locator) void
setEscapeText
(boolean escapeText) Sets whether text output should be escaped or not.void
setIndentLevel
(int indentLevel) Set the initial indentation level.void
setLexicalHandler
(LexicalHandler handler) void
setMaximumAllowedCharacter
(int maximumAllowedCharacter) Sets the maximum allowed character code that should be allowed unescaped such as 127 in US-ASCII (7 bit) or 255 in ISO-* (8 bit) or -1 to not escape any characters (other than the special XML characters like < > &) If this is not explicitly set then it is defaulted from the encoding.void
void
setProperty
(String name, Object value) void
setResolveEntityRefs
(boolean resolve) void
protected boolean
shouldEncodeChar
(char c) Should the given character be escaped.void
void
void
void
startElement
(String namespaceURI, String localName, String qName, Attributes attributes) void
startEntity
(String name) void
startPrefixMapping
(String prefix, String uri) void
unparsedEntityDecl
(String name, String publicID, String systemID, String notationName) void
Writes the given object which should be a String, a Node or a List of Nodes.void
Print out aString
, Perfoms the necessary entity escaping and whitespace stripping.void
write
(org.dom4j.Attribute attribute) Writes the givenAttribute
.void
write
(org.dom4j.CDATA cdata) Writes the givenCDATA
.void
write
(org.dom4j.Comment comment) Writes the givenComment
.void
write
(org.dom4j.Document doc) This will print theDocument
to the current Writer.void
write
(org.dom4j.DocumentType docType) Writes the givenDocumentType
.void
write
(org.dom4j.Element element) Writes the
, including itsElement
s, and its value, and all its content (child nodes) to the current Writer.Attribute
void
write
(org.dom4j.Entity entity) Writes the givenEntity
.void
write
(org.dom4j.Namespace namespace) Writes the givenNamespace
.void
write
(org.dom4j.Node node) Writes the givenNode
.void
write
(org.dom4j.ProcessingInstruction processingInstruction) Writes the givenProcessingInstruction
.void
write
(org.dom4j.Text text) Writes the givenText
.protected void
writeAttribute
(org.dom4j.Attribute attribute) protected void
writeAttribute
(Attributes attributes, int index) protected void
writeAttributes
(org.dom4j.Element element) Writes the attributes of the given elementprotected void
writeAttributes
(Attributes attributes) protected void
writeCDATA
(String text) protected void
writeClose
(String qualifiedName) void
writeClose
(org.dom4j.Element element) Writes the closing tag of anElement
protected void
writeComment
(String text) protected void
This will write the declaration to the given Writer.protected void
writeDocType
(String name, String publicID, String systemID) protected void
writeDocType
(org.dom4j.DocumentType docType) protected void
writeElement
(org.dom4j.Element element) protected void
writeElementContent
(org.dom4j.Element element) Outputs the content of the given element.protected void
writeEmptyElementClose
(String qualifiedName) protected void
writeEntity
(org.dom4j.Entity entity) protected void
writeEntityRef
(String name) protected void
protected void
writeNamespace
(String prefix, String uri) Writes the SAX namepsacesprotected void
writeNamespace
(org.dom4j.Namespace namespace) protected void
Writes the SAX namepsacesprotected void
writeNode
(org.dom4j.Node node) protected void
writeNodeText
(org.dom4j.Node node) This method is used to write out Nodes that contain text and still allow for xml:space to be handled properly.void
writeOpen
(org.dom4j.Element element) Writes the opening tag of anElement
, including itsAttribute
s but without its content.protected void
This will print a new line only if the newlines flag was set to trueprotected void
writeProcessingInstruction
(org.dom4j.ProcessingInstruction processingInstruction) protected void
writeString
(String text) Methods inherited from class org.xml.sax.helpers.XMLFilterImpl
error, fatalError, getContentHandler, getDTDHandler, getEntityResolver, getErrorHandler, getFeature, getParent, parse, resolveEntity, setContentHandler, setDTDHandler, setEntityResolver, setErrorHandler, setFeature, setParent, skippedEntity, warning
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.xml.sax.ContentHandler
declaration
-
Field Details
-
LEXICAL_HANDLER_NAMES
-
DEFAULT_FORMAT
protected static final org.dom4j.io.OutputFormat DEFAULT_FORMAT -
lastOutputNodeType
protected int lastOutputNodeTypeStores the last type of node written so algorithms can refer to the previous node type -
preserve
protected boolean preserveStores the xml:space attribute value of preserve for whitespace flag -
writer
The Writer used to output to
-
-
Constructor Details
-
XMLWriter
-
XMLWriter
-
XMLWriter
- Throws:
UnsupportedEncodingException
-
XMLWriter
- Throws:
UnsupportedEncodingException
-
XMLWriter
public XMLWriter(OutputStream out, org.dom4j.io.OutputFormat format) throws UnsupportedEncodingException - Throws:
UnsupportedEncodingException
-
XMLWriter
- Throws:
UnsupportedEncodingException
-
-
Method Details
-
setWriter
-
setOutputStream
- Throws:
UnsupportedEncodingException
-
isEscapeText
public boolean isEscapeText()- Returns:
- true if text thats output should be escaped. This is enabled by default. It could be disabled if the output format is textual, like in XSLT where we can have xml, html or text output.
-
setEscapeText
public void setEscapeText(boolean escapeText) Sets whether text output should be escaped or not. This is enabled by default. It could be disabled if the output format is textual, like in XSLT where we can have xml, html or text output.- Parameters:
escapeText
-true
to escape text, otherwisefalse
-
setIndentLevel
public void setIndentLevel(int indentLevel) Set the initial indentation level. This can be used to output a document (or, more likely, an element) starting at a given indent level, so it's not always flush against the left margin. Default: 0- Parameters:
indentLevel
- the number of indents to start with
-
getMaximumAllowedCharacter
public int getMaximumAllowedCharacter()Returns the maximum allowed character code that should be allowed unescaped which defaults to 127 in US-ASCII (7 bit) or 255 in ISO-* (8 bit).- Returns:
- the maximum character code
-
setMaximumAllowedCharacter
public void setMaximumAllowedCharacter(int maximumAllowedCharacter) Sets the maximum allowed character code that should be allowed unescaped such as 127 in US-ASCII (7 bit) or 255 in ISO-* (8 bit) or -1 to not escape any characters (other than the special XML characters like < > &) If this is not explicitly set then it is defaulted from the encoding.- Parameters:
maximumAllowedCharacter
- The maximumAllowedCharacter to set
-
flush
Flushes the underlying Writer- Throws:
IOException
- if the writer could not be flushed
-
close
Closes the underlying Writer- Throws:
IOException
- if the writer could not be closed
-
println
Writes the new line text to the underlying Writer- Throws:
IOException
- if the new line could not be written
-
write
Writes the givenAttribute
.- Parameters:
attribute
-Attribute
to output.- Throws:
IOException
- if the attribute could not be written
-
write
This will print the
Document
to the current Writer.Warning: using your own Writer may cause the writer's preferred character encoding to be ignored. If you use encodings other than UTF8, we recommend using the method that takes an OutputStream instead.
Note: as with all Writers, you may need to flush() yours after this method returns.
- Parameters:
doc
-Document
to format.- Throws:
IOException
- - if there's any problem writing.
-
write
Writes the
, including itsElement
s, and its value, and all its content (child nodes) to the current Writer.Attribute
- Parameters:
element
-Element
to output.- Throws:
IOException
- if the element could not be written
-
write
Writes the givenCDATA
.- Parameters:
cdata
-CDATA
to output.- Throws:
IOException
- if the cdata could not be written
-
write
Writes the givenComment
.- Parameters:
comment
-Comment
to output.- Throws:
IOException
- if the comment could not be written
-
write
Writes the givenDocumentType
.- Parameters:
docType
-DocumentType
to output.- Throws:
IOException
- if the docType could not be written
-
write
Writes the givenEntity
.- Parameters:
entity
-Entity
to output.- Throws:
IOException
- if the entity could not be written
-
write
Writes the givenNamespace
.- Parameters:
namespace
-Namespace
to output.- Throws:
IOException
- if the namespace could not be written
-
write
Writes the givenProcessingInstruction
.- Parameters:
processingInstruction
-ProcessingInstruction
to output.- Throws:
IOException
- if the instruction could not be written
-
write
Print out a
String
, Perfoms the necessary entity escaping and whitespace stripping.- Parameters:
text
- is the text to output- Throws:
IOException
- if the text could not be written
-
write
Writes the givenText
.- Parameters:
text
-Text
to output.- Throws:
IOException
- if the text could not be written
-
write
Writes the givenNode
.- Parameters:
node
-Node
to output.- Throws:
IOException
- if the node could not be written
-
write
Writes the given object which should be a String, a Node or a List of Nodes.- Parameters:
object
- is the object to output.- Throws:
IOException
- if the object could not be written
-
writeOpen
Writes the opening tag of an
Element
, including itsAttribute
s but without its content.- Parameters:
element
-Element
to output.- Throws:
IOException
- if the element could not be written
-
writeClose
Writes the closing tag of an
Element
- Parameters:
element
-Element
to output.- Throws:
IOException
- if the element could not be written
-
parse
- Specified by:
parse
in interfaceXMLReader
- Overrides:
parse
in classXMLFilterImpl
- Throws:
IOException
SAXException
-
setProperty
public void setProperty(String name, Object value) throws SAXNotRecognizedException, SAXNotSupportedException - Specified by:
setProperty
in interfaceXMLReader
- Overrides:
setProperty
in classXMLFilterImpl
- Throws:
SAXNotRecognizedException
SAXNotSupportedException
-
getProperty
- Specified by:
getProperty
in interfaceXMLReader
- Overrides:
getProperty
in classXMLFilterImpl
- Throws:
SAXNotRecognizedException
SAXNotSupportedException
-
setLexicalHandler
-
getLexicalHandler
-
setDocumentLocator
- Specified by:
setDocumentLocator
in interfaceContentHandler
- Overrides:
setDocumentLocator
in classXMLFilterImpl
-
startDocument
- Specified by:
startDocument
in interfaceContentHandler
- Overrides:
startDocument
in classXMLFilterImpl
- Throws:
SAXException
-
endDocument
- Specified by:
endDocument
in interfaceContentHandler
- Overrides:
endDocument
in classXMLFilterImpl
- Throws:
SAXException
-
startPrefixMapping
- Specified by:
startPrefixMapping
in interfaceContentHandler
- Overrides:
startPrefixMapping
in classXMLFilterImpl
- Throws:
SAXException
-
endPrefixMapping
- Specified by:
endPrefixMapping
in interfaceContentHandler
- Overrides:
endPrefixMapping
in classXMLFilterImpl
- Throws:
SAXException
-
startElement
public void startElement(String namespaceURI, String localName, String qName, Attributes attributes) throws SAXException - Specified by:
startElement
in interfaceContentHandler
- Overrides:
startElement
in classXMLFilterImpl
- Throws:
SAXException
-
endElement
- Specified by:
endElement
in interfaceContentHandler
- Overrides:
endElement
in classXMLFilterImpl
- Throws:
SAXException
-
characters
- Specified by:
characters
in interfaceContentHandler
- Overrides:
characters
in classXMLFilterImpl
- Throws:
SAXException
-
ignorableWhitespace
- Specified by:
ignorableWhitespace
in interfaceContentHandler
- Overrides:
ignorableWhitespace
in classXMLFilterImpl
- Throws:
SAXException
-
processingInstruction
- Specified by:
processingInstruction
in interfaceContentHandler
- Overrides:
processingInstruction
in classXMLFilterImpl
- Throws:
SAXException
-
notationDecl
- Specified by:
notationDecl
in interfaceDTDHandler
- Overrides:
notationDecl
in classXMLFilterImpl
- Throws:
SAXException
-
unparsedEntityDecl
public void unparsedEntityDecl(String name, String publicID, String systemID, String notationName) throws SAXException - Specified by:
unparsedEntityDecl
in interfaceDTDHandler
- Overrides:
unparsedEntityDecl
in classXMLFilterImpl
- Throws:
SAXException
-
startDTD
- Specified by:
startDTD
in interfaceLexicalHandler
- Throws:
SAXException
-
endDTD
- Specified by:
endDTD
in interfaceLexicalHandler
- Throws:
SAXException
-
startCDATA
- Specified by:
startCDATA
in interfaceLexicalHandler
- Throws:
SAXException
-
endCDATA
- Specified by:
endCDATA
in interfaceLexicalHandler
- Throws:
SAXException
-
startEntity
- Specified by:
startEntity
in interfaceLexicalHandler
- Throws:
SAXException
-
endEntity
- Specified by:
endEntity
in interfaceLexicalHandler
- Throws:
SAXException
-
comment
- Specified by:
comment
in interfaceLexicalHandler
- Throws:
SAXException
-
writeElement
- Throws:
IOException
-
isElementSpacePreserved
protected final boolean isElementSpacePreserved(org.dom4j.Element element) Determines if element is a special case of XML elements where it contains an xml:space attribute of "preserve". If it does, then retain whitespace.- Parameters:
element
- the element to check- Returns:
true
if whitespace should be preserved, otherwisefalse
-
writeElementContent
Outputs the content of the given element. If whitespace trimming is enabled then all adjacent text nodes are appended together before the whitespace trimming occurs to avoid problems with multiple text nodes being created due to text content that spans parser buffers in a SAX parser.- Parameters:
element
- the element to write- Throws:
IOException
- if the element could not be written
-
writeCDATA
- Throws:
IOException
-
writeDocType
- Throws:
IOException
-
writeNamespace
- Throws:
IOException
-
writeNamespaces
Writes the SAX namepsaces- Throws:
IOException
- if the namespaces could not be written
-
writeNamespace
Writes the SAX namepsaces- Parameters:
prefix
- the namespace prefixuri
- the URL of the namespace- Throws:
IOException
- if the namespace could not be written
-
writeProcessingInstruction
protected void writeProcessingInstruction(org.dom4j.ProcessingInstruction processingInstruction) throws IOException - Throws:
IOException
-
writeString
- Throws:
IOException
-
writeNodeText
This method is used to write out Nodes that contain text and still allow for xml:space to be handled properly.- Parameters:
node
- the node to write- Throws:
IOException
- if the node could not be written
-
writeNode
- Throws:
IOException
-
installLexicalHandler
protected void installLexicalHandler() -
writeDocType
- Throws:
IOException
-
writeEntity
- Throws:
IOException
-
writeEntityRef
- Throws:
IOException
-
writeComment
- Throws:
IOException
-
writeAttributes
Writes the attributes of the given element- Parameters:
element
- the element whose attributes should be written- Throws:
IOException
- if the element could not be written
-
writeAttribute
- Throws:
IOException
-
writeAttributes
- Throws:
IOException
-
writeAttribute
- Throws:
IOException
-
indent
- Throws:
IOException
-
writePrintln
This will print a new line only if the newlines flag was set to true
- Throws:
IOException
- if the new line could not be written
-
createWriter
protected Writer createWriter(OutputStream outStream, String encoding) throws UnsupportedEncodingException Get an OutputStreamWriter, use preferred encoding.- Parameters:
outStream
- the outut streamencoding
- the encoding of the stream- Returns:
- the IO writer
- Throws:
UnsupportedEncodingException
- if the encoding is not support
-
writeDeclaration
This will write the declaration to the given Writer. Assumes XML version 1.0 since we don't directly know.
- Throws:
IOException
- if the declaration could not be written
-
writeClose
- Throws:
IOException
-
writeEmptyElementClose
- Throws:
IOException
-
isExpandEmptyElements
protected boolean isExpandEmptyElements() -
escapeElementEntities
This will take the pre-defined entities in XML 1.0 and convert their character representation to the appropriate entity reference, suitable for XML attributes.- Parameters:
text
- the entities to escale- Returns:
- the escaped entities
-
writeEscapeAttributeEntities
- Throws:
IOException
-
escapeAttributeEntities
This will take the pre-defined entities in XML 1.0 and convert their character representation to the appropriate entity reference, suitable for XML attributes.- Parameters:
text
- the entitie to escape- Returns:
- the escaped entity
-
shouldEncodeChar
protected boolean shouldEncodeChar(char c) Should the given character be escaped. This depends on the encoding of the document.- Parameters:
c
- the character to check- Returns:
true
to escape the character, otherwisefalse
-
defaultMaximumAllowedCharacter
protected int defaultMaximumAllowedCharacter()Returns the maximum allowed character code that should be allowed unescaped which defaults to 127 in US-ASCII (7 bit) or 255 in ISO-* (8 bit).- Returns:
- the maximum allow character code
-
isNamespaceDeclaration
protected boolean isNamespaceDeclaration(org.dom4j.Namespace ns) -
handleException
- Throws:
SAXException
-
getOutputFormat
protected org.dom4j.io.OutputFormat getOutputFormat()Lets subclasses get at the current format object, so they can call setTrimText, setNewLines, etc. Put in to support the HTMLWriter, in the way that it pushes the current newline/trim state onto a stack and overrides the state within preformatted tags.- Returns:
- the output format
-
resolveEntityRefs
public boolean resolveEntityRefs() -
setResolveEntityRefs
public void setResolveEntityRefs(boolean resolve)
-