Package org.dom4j
Interface Document
-
- All Known Implementing Classes:
AbstractDocument
,DefaultDocument
,DOMDocument
public interface Document extends Branch
Document
defines an XML Document.
-
-
Field Summary
-
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
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Document
addComment(String comment)
Adds a newComment
node with the given text to this branch.Document
addDocType(String name, String publicId, String systemId)
Adds a DOCTYPE declaration to this documentDocument
addProcessingInstruction(String target, String text)
Adds a processing instruction for the given targetDocument
addProcessingInstruction(String target, Map<String,String> data)
Adds a processing instruction for the given targetDocumentType
getDocType()
DOCUMENT ME!EntityResolver
getEntityResolver()
DOCUMENT ME!Element
getRootElement()
Returns the rootElement
for this document.String
getXMLEncoding()
Return the encoding of this document, as part of the XML declaration This isnull
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.void
setDocType(DocumentType docType)
Sets the DocumentType propertyvoid
setEntityResolver(EntityResolver entityResolver)
Sets the EntityResolver used to find resolve URIs such as for DTDs, or XML Schema documentsvoid
setRootElement(Element rootElement)
Sets the root element for this documentvoid
setXMLEncoding(String encoding)
Sets the encoding of this document as it will appear in the XML declaration part of the document.-
Methods inherited from interface org.dom4j.Branch
add, add, add, add, addElement, addElement, addElement, appendContent, clearContent, content, elementByID, indexOf, node, nodeCount, nodeIterator, normalize, processingInstruction, processingInstructions, processingInstructions, remove, remove, remove, remove, removeProcessingInstruction, setContent, setProcessingInstructions
-
Methods inherited from interface org.dom4j.Node
accept, asXML, asXPathResult, clone, createXPath, detach, getDocument, getName, getNodeType, getNodeTypeName, getParent, getPath, getPath, getStringValue, getText, getUniquePath, getUniquePath, hasContent, isReadOnly, matches, numberValueOf, selectNodes, selectNodes, selectNodes, selectObject, selectSingleNode, setDocument, setName, setParent, setText, supportsParent, valueOf, write
-
-
-
-
Method Detail
-
getRootElement
Element getRootElement()
Returns the rootElement
for this document.- Returns:
- the root element for this document
-
setRootElement
void setRootElement(Element rootElement)
Sets the root element for this document- Parameters:
rootElement
- the new root element for this document
-
addComment
Document addComment(String comment)
Adds a newComment
node with the given text to this branch.- Parameters:
comment
- is the text for theComment
node.- Returns:
- this
Document
instance.
-
addProcessingInstruction
Document addProcessingInstruction(String target, String text)
Adds a processing instruction for the given target- Parameters:
target
- is the target of the processing instructiontext
- is the textual data (key/value pairs) of the processing instruction- Returns:
- this
Document
instance.
-
addProcessingInstruction
Document addProcessingInstruction(String target, Map<String,String> data)
Adds a processing instruction for the given target- Parameters:
target
- is the target of the processing instructiondata
- is a Map of the key / value pairs of the processing instruction- Returns:
- this
Document
instance.
-
addDocType
Document addDocType(String name, String publicId, String systemId)
Adds a DOCTYPE declaration to this document- Parameters:
name
- is the name of the root elementpublicId
- is the PUBLIC URIsystemId
- is the SYSTEM URI- Returns:
- this
Document
instance.
-
getDocType
DocumentType getDocType()
DOCUMENT ME!- Returns:
- the DocumentType property
-
setDocType
void setDocType(DocumentType docType)
Sets the DocumentType property- Parameters:
docType
- DOCUMENT ME!
-
getEntityResolver
EntityResolver getEntityResolver()
DOCUMENT ME!- Returns:
- the EntityResolver used to find resolve URIs such as for DTDs, or XML Schema documents
-
setEntityResolver
void setEntityResolver(EntityResolver entityResolver)
Sets the EntityResolver used to find resolve URIs such as for DTDs, or XML Schema documents- Parameters:
entityResolver
- DOCUMENT ME!
-
getXMLEncoding
String getXMLEncoding()
Return the encoding of this document, as part of the XML declaration This isnull
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 theorg.xml.sax.ext.Locator2
interface, the result returned by this method is specified by thegetEncoding()
method of that interface.- Returns:
- The encoding of this document, as stated in the XML declaration,
or
null
if unknown. - Since:
- 1.5
-
setXMLEncoding
void setXMLEncoding(String encoding)
Sets the encoding of this document as it will appear in the XML declaration part of the document.- Parameters:
encoding
- the encoding of the document- Since:
- 1.6
-
-