org.dom4j.tree

Class DefaultDocument

java.lang.Object

org.dom4j.tree.AbstractNode

org.dom4j.tree.AbstractBranch

org.dom4j.tree.AbstractDocument

org.dom4j.tree.DefaultDocument

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Branch, Document, Node

Direct Known Subclasses:

DOMDocument

public class DefaultDocument
extends AbstractDocument

DefaultDocument is the default DOM4J default implementation of an XML document.

See Also:

Serialized Form

Field Summary

Fields inherited from class org.dom4j.tree.AbstractDocument

encoding

Fields inherited from class org.dom4j.tree.AbstractBranch

DEFAULT_CONTENT_LIST_SIZE

Fields inherited from class org.dom4j.tree.AbstractNode

NODE_TYPE_NAMES

Fields inherited from interface org.dom4j.Node

ANY_NODE, ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_REFERENCE_NODE, MAX_NODE_TYPE, NAMESPACE_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE, UNKNOWN_NODE

Constructor Summary

Constructors

Constructor and Description
DefaultDocument()
DefaultDocument(DocumentType docType)
DefaultDocument(Element rootElement)
DefaultDocument(Element rootElement, DocumentType docType)
DefaultDocument(java.lang.String name)
DefaultDocument(java.lang.String name, Element rootElement, DocumentType docType)

Method Summary

Modifier and Type	Method and Description
Document	addDocType(java.lang.String docTypeName, java.lang.String publicId, java.lang.String systemId) Adds a DOCTYPE declaration to this document
protected void	addNode(int index, Node node)
protected void	addNode(Node node)
void	clearContent() Clears the content for this branch, removing any Node instances this branch may contain.
java.lang.Object	clone() clone will return a deep clone or if this node is read-only then clone will return the same instance.
protected java.util.List<Node>	contentList() DOCUMENT ME!
DocumentType	getDocType() DOCUMENT ME!
protected DocumentFactory	getDocumentFactory()
org.xml.sax.EntityResolver	getEntityResolver() DOCUMENT ME!
java.lang.String	getName() getName returns the name of this node.
Element	getRootElement() Returns the root Elementfor this document.
java.lang.String	getXMLEncoding() Return the encoding of this document, as part of the XML declaration This is null when unspecified or when it is not known (such as when the Document was created in memory) or when the implementation does not support this operation.
ProcessingInstruction	processingInstruction(java.lang.String target) DOCUMENT ME!
java.util.List<ProcessingInstruction>	processingInstructions() Returns a list of all the processing instructions in this branch.
java.util.List<ProcessingInstruction>	processingInstructions(java.lang.String target) Returns a list of the processing instructions for the given target.
protected boolean	removeNode(Node node)
boolean	removeProcessingInstruction(java.lang.String target) Removes the processing instruction for the given target if it exists
protected void	rootElementAdded(Element element) Called to set the root element variable
void	setContent(java.util.List<Node> content) Sets the contents of this branch as a List of Node instances.
void	setDocType(DocumentType docType) Sets the DocumentType property
void	setDocumentFactory(DocumentFactory documentFactory)
void	setEntityResolver(org.xml.sax.EntityResolver entityResolver) Sets the EntityResolver used to find resolve URIs such as for DTDs, or XML Schema documents
void	setName(java.lang.String name) Sets the text data of this node or this method will throw an UnsupportedOperationException if it is read-only.

Methods inherited from class org.dom4j.tree.AbstractDocument

accept, add, addComment, addElement, addElement, addElement, addProcessingInstruction, addProcessingInstruction, asXML, asXPathResult, checkAddElementAllowed, childAdded, childRemoved, getDocument, getNodeType, getPath, getStringValue, getUniquePath, normalize, remove, setRootElement, setXMLEncoding, toString, write

Methods inherited from class org.dom4j.tree.AbstractBranch

add, add, add, addElement, appendContent, content, contentRemoved, createContentList, createContentList, createEmptyList, createResultList, createSingleResultList, elementByID, elementID, getContentAsStringValue, getContentAsText, getText, getTextTrim, hasContent, indexOf, invalidNodeTypeAddException, isReadOnly, node, nodeCount, nodeIterator, remove, remove, remove, setProcessingInstructions

Methods inherited from class org.dom4j.tree.AbstractNode

createPattern, createXPath, createXPathFilter, createXPathResult, detach, getNodeTypeName, getParent, getPath, getUniquePath, matches, numberValueOf, selectNodes, selectNodes, selectNodes, selectObject, selectSingleNode, setDocument, setParent, setText, supportsParent, valueOf

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.dom4j.Branch

add, add, add, appendContent, content, elementByID, indexOf, node, nodeCount, nodeIterator, remove, remove, remove, setProcessingInstructions

Methods inherited from interface org.dom4j.Node

createXPath, detach, getNodeTypeName, getParent, getPath, getText, getUniquePath, hasContent, isReadOnly, matches, numberValueOf, selectNodes, selectNodes, selectNodes, selectObject, selectSingleNode, setDocument, setParent, setText, supportsParent, valueOf

Constructor Detail

DefaultDocument

public DefaultDocument()

DefaultDocument

public DefaultDocument(java.lang.String name)

DefaultDocument

public DefaultDocument(Element rootElement)

DefaultDocument

public DefaultDocument(DocumentType docType)

DefaultDocument

public DefaultDocument(Element rootElement,
                       DocumentType docType)

DefaultDocument

public DefaultDocument(java.lang.String name,
                       Element rootElement,
                       DocumentType docType)

Method Detail

getName

public java.lang.String getName()

Description copied from interface: Node

getName returns the name of this node. This is the XML local name of the element, attribute, entity or processing instruction. For CDATA and Text nodes this method will return null.

Specified by:

getName in interface Node

Overrides:

getName in class AbstractNode

Returns:

the XML name of this node

setName

public void setName(java.lang.String name)

Description copied from interface: Node

Sets the text data of this node or this method will throw an UnsupportedOperationException if it is read-only.

Specified by:

setName in interface Node

Overrides:

setName in class AbstractNode

Parameters:

name - is the new name of this node

getRootElement

public Element getRootElement()

Description copied from interface: Document

Returns the root Elementfor this document.

Returns:

the root element for this document

getDocType

public DocumentType getDocType()

Description copied from interface: Document

DOCUMENT ME!

Returns:

the DocumentType property

setDocType

public void setDocType(DocumentType docType)

Description copied from interface: Document

Sets the DocumentType property

Parameters:

docType - DOCUMENT ME!

addDocType

public Document addDocType(java.lang.String docTypeName,
                           java.lang.String publicId,
                           java.lang.String systemId)

Description copied from interface: Document

Adds a DOCTYPE declaration to this document

Parameters:

docTypeName - is the name of the root element

publicId - is the PUBLIC URI

systemId - is the SYSTEM URI

Returns:

this Document instance.

getXMLEncoding

public java.lang.String getXMLEncoding()

Description copied from interface: Document

Return the encoding of this document, as part of the XML declaration This is null when unspecified or when it is not known (such as when the Document was created in memory) or when the implementation does not support this operation. The way this encoding is retrieved also depends on the way the XML source is parsed. For instance, if the SAXReader is used and if the underlying XMLReader implementation support the org.xml.sax.ext.Locator2 interface, the result returned by this method is specified by the getEncoding() method of that interface.

Specified by:

getXMLEncoding in interface Document

Overrides:

getXMLEncoding in class AbstractDocument

Returns:

The encoding of this document, as stated in the XML declaration, or null if unknown.

getEntityResolver

public org.xml.sax.EntityResolver getEntityResolver()

Description copied from interface: Document

DOCUMENT ME!

Returns:

the EntityResolver used to find resolve URIs such as for DTDs, or XML Schema documents

setEntityResolver

public void setEntityResolver(org.xml.sax.EntityResolver entityResolver)

Description copied from interface: Document

Sets the EntityResolver used to find resolve URIs such as for DTDs, or XML Schema documents

Parameters:

entityResolver - DOCUMENT ME!

clone

public java.lang.Object clone()

Description copied from interface: Node

clone will return a deep clone or if this node is read-only then clone will return the same instance.

Specified by:

clone in interface Node

Overrides:

clone in class AbstractNode

Returns:

a deep clone of myself or myself if I am read only.

processingInstructions

public java.util.List<ProcessingInstruction> processingInstructions()

Description copied from interface: Branch

Returns a list of all the processing instructions in this branch. The list is backed by this branch so that changes to the list will be reflected in the branch but the reverse is not the case.

Returns:

a backed list of the processing instructions

processingInstructions

public java.util.List<ProcessingInstruction> processingInstructions(java.lang.String target)

Description copied from interface: Branch

Returns a list of the processing instructions for the given target. The list is backed by this branch so that changes to the list will be reflected in the branch but the reverse is not the case.

Parameters:

target - DOCUMENT ME!

Returns:

a backed list of the processing instructions

processingInstruction

public ProcessingInstruction processingInstruction(java.lang.String target)

Description copied from interface: Branch

DOCUMENT ME!

Parameters:

target - DOCUMENT ME!

Returns:

the processing instruction for the given target

removeProcessingInstruction

public boolean removeProcessingInstruction(java.lang.String target)

Description copied from interface: Branch

Removes the processing instruction for the given target if it exists

Parameters:

target - DOCUMENT ME!

Returns:

true if a processing instruction was removed else false

setContent

public void setContent(java.util.List<Node> content)

Description copied from interface: Branch

Sets the contents of this branch as a List of Node instances.

Parameters:

content - is the list of nodes to use as the content for this branch.

clearContent

public void clearContent()

Description copied from interface: Branch

Clears the content for this branch, removing any Node instances this branch may contain.

setDocumentFactory

public void setDocumentFactory(DocumentFactory documentFactory)

contentList

protected java.util.List<Node> contentList()

Description copied from class: AbstractBranch

DOCUMENT ME!

Specified by:

contentList in class AbstractBranch

Returns:

the internal List used to manage the content

addNode

protected void addNode(Node node)

Specified by:

addNode in class AbstractBranch

addNode

protected void addNode(int index,
                       Node node)

Specified by:

addNode in class AbstractBranch

removeNode

protected boolean removeNode(Node node)

Specified by:

removeNode in class AbstractBranch

rootElementAdded

protected void rootElementAdded(Element element)

Description copied from class: AbstractDocument

Called to set the root element variable

Specified by:

rootElementAdded in class AbstractDocument

Parameters:

element - DOCUMENT ME!

getDocumentFactory

protected DocumentFactory getDocumentFactory()

Overrides:

getDocumentFactory in class AbstractNode