adoptNode
public Node adoptNode(Node source)
throws DOMException
NEEDSDOC Method adoptNode
NEEDSDOC @param source
NEEDSDOC (adoptNode) @return
appendChild
public Node appendChild(Node newChild)
throws DOMException
Unimplemented. See org.w3c.dom.Node
newChild
- New node to append to the list of this node's children
appendData
public void appendData(String arg)
throws DOMException
Unimplemented.
arg
- String data to append
cloneNode
public Node cloneNode(boolean deep)
Unimplemented. See org.w3c.dom.Node
deep
- Flag indicating whether to clone deep (clone member variables)
compareDocumentPosition
public short compareDocumentPosition(Node other)
throws DOMException
Compares a node with this node with regard to their position in the
document.
other
- The node to compare against this node.
- Returns how the given node is positioned relatively to this
node.
createAttribute
public Attr createAttribute(String name)
throws DOMException
Unimplemented. See org.w3c.dom.Document
createAttributeNS
public Attr createAttributeNS(String namespaceURI,
String qualifiedName)
throws DOMException
Unimplemented. See org.w3c.dom.Document
namespaceURI
- Namespace URI of the attributequalifiedName
- Qualified name of the attribute
createCDATASection
public CDATASection createCDATASection(String data)
throws DOMException
Unimplemented. See org.w3c.dom.Document
data
- Data for CDATA section
createComment
public Comment createComment(String data)
Unimplemented. See org.w3c.dom.Document
createDocumentFragment
public DocumentFragment createDocumentFragment()
Unimplemented. See org.w3c.dom.Document
createElement
public Element createElement(String tagName)
throws DOMException
Unimplemented. See org.w3c.dom.Document
tagName
- Element tag name
createElementNS
public Element createElementNS(String namespaceURI,
String qualifiedName)
throws DOMException
Unimplemented. See org.w3c.dom.Document
namespaceURI
- Namespace URI for the elementqualifiedName
- Qualified name of the element
createEntityReference
public EntityReference createEntityReference(String name)
throws DOMException
Unimplemented. See org.w3c.dom.Document
name
- Entity Reference name
createProcessingInstruction
public ProcessingInstruction createProcessingInstruction(String target,
String data)
throws DOMException
Unimplemented. See org.w3c.dom.Document
target
- Target for Processing instructiondata
- Data for Processing instruction
createTextNode
public Text createTextNode(String data)
Unimplemented. See org.w3c.dom.Document
data
- Data for text node
deleteData
public void deleteData(int offset,
int count)
throws DOMException
Unimplemented.
offset
- Start offset of substring to delete.count
- The length of the substring to delete.
error
public void error(String msg)
Throw an error.
msg
- Message Key for the error
error
public void error(String msg,
Object[] args)
Throw an error.
msg
- Message Key for the errorargs
- Array of arguments to be used in the error message
getActualEncoding
public String getActualEncoding()
DOM Level 3
An attribute specifying the actual encoding of this document. This is
null
otherwise.
This attribute represents the property [character encoding scheme]
defined in .
getAttribute
public String getAttribute(String name)
Unimplemented. See org.w3c.dom.Element
name
- Name of attribute to get
getAttributeNS
public String getAttributeNS(String namespaceURI,
String localName)
Unimplemented. See org.w3c.dom.Element
namespaceURI
- Namespace URI of attribute node to getlocalName
- Local part of qualified name of attribute node to get
getAttributeNode
public Attr getAttributeNode(String name)
Unimplemented. See org.w3c.dom.Element
name
- Attribute node name
getAttributeNodeNS
public Attr getAttributeNodeNS(String namespaceURI,
String localName)
Unimplemented. See org.w3c.dom.Element
namespaceURI
- Namespace URI of attribute node to getlocalName
- Local part of qualified name of attribute node to get
getAttributes
public NamedNodeMap getAttributes()
Unimplemented. See org.w3c.dom.Node
getBaseURI
public String getBaseURI()
The absolute base URI of this node or null
if undefined.
This value is computed according to . However, when the
Document
supports the feature "HTML" , the base URI is
computed using first the value of the href attribute of the HTML BASE
element if any, and the value of the documentURI
attribute from the Document
interface otherwise.
When the node is an Element
, a Document
or a a ProcessingInstruction
, this attribute represents
the properties [base URI] defined in . When the node is a
Notation
, an Entity
, or an
EntityReference
, this attribute represents the
properties [declaration base URI] in the . How will this be affected
by resolution of relative namespace URIs issue?It's not.Should this
only be on Document, Element, ProcessingInstruction, Entity, and
Notation nodes, according to the infoset? If not, what is it equal to
on other nodes? Null? An empty string? I think it should be the
parent's.No.Should this be read-only and computed or and actual
read-write attribute?Read-only and computed (F2F 19 Jun 2000 and
teleconference 30 May 2001).If the base HTML element is not yet
attached to a document, does the insert change the Document.baseURI?
Yes. (F2F 26 Sep 2001)
getChildNodes
public NodeList getChildNodes()
Unimplemented. See org.w3c.dom.Node
getDoctype
public DocumentType getDoctype()
Unimplemented. See org.w3c.dom.Document
getDocumentElement
public Element getDocumentElement()
Unimplemented. See org.w3c.dom.Document
getDocumentURI
public String getDocumentURI()
DOM Level 3
The location of the document or null
if undefined.
Beware that when the Document
supports the feature
"HTML" , the href attribute of the HTML BASE element takes precedence
over this attribute.
getDomConfig
public DOMConfiguration getDomConfig()
The configuration used when Document.normalizeDocument
is
invoked.
getElementById
public Element getElementById(String elementId)
Unimplemented. See org.w3c.dom.Document
elementId
- ID of the element to get
getElementsByTagName
public NodeList getElementsByTagName(String name)
Unimplemented. See org.w3c.dom.Element
name
- Name of the element
getElementsByTagNameNS
public NodeList getElementsByTagNameNS(String namespaceURI,
String localName)
Unimplemented. See org.w3c.dom.Element
namespaceURI
- Namespace URI of the elementlocalName
- Local part of qualified name of the element
getFeature
public Object getFeature(String feature,
String version)
This method returns a specialized object which implements the
specialized APIs of the specified feature and version. The
specialized object may also be obtained by using binding-specific
casting methods but is not necessarily expected to, as discussed in Mixed DOM implementations.
feature
- The name of the feature requested (case-insensitive).version
- This is the version number of the feature to test. If
the version is null
or the empty string, supporting
any version of the feature will cause the method to return an
object that supports at least one version of the feature.
- Returns an object which implements the specialized APIs of
the specified feature and version, if any, or
null
if
there is no object which implements interfaces associated with that
feature. If the DOMObject
returned by this method
implements the Node
interface, it must delegate to the
primary core Node
and not return results inconsistent
with the primary core Node
such as attributes,
childNodes, etc.
getFirstChild
public Node getFirstChild()
Unimplemented. See org.w3c.dom.Node
getImplementation
public DOMImplementation getImplementation()
Unimplemented. See org.w3c.dom.Document
getInputEncoding
public String getInputEncoding()
- DOM Level 3
NEEDSDOC ($objectName$) @return
getLastChild
public Node getLastChild()
Unimplemented. See org.w3c.dom.Node
getLength
public int getLength()
Unimplemented. See org.w3c.dom.NodeList
getLocalName
public String getLocalName()
Unimplemented. See org.w3c.dom.Node
getNamespaceURI
public String getNamespaceURI()
Unimplemented. See org.w3c.dom.Node
getNextSibling
public Node getNextSibling()
Unimplemented. See org.w3c.dom.Node
getNodeName
public String getNodeName()
Unimplemented. See org.w3c.dom.Node
getNodeType
public short getNodeType()
Unimplemented. See org.w3c.dom.Node
getNodeValue
public String getNodeValue()
throws DOMException
Unimplemented. See org.w3c.dom.Node
getOwnerDocument
public Document getOwnerDocument()
Unimplemented. See org.w3c.dom.Node
getOwnerElement
public Element getOwnerElement()
Unimplemented. See org.w3c.dom.Node
getParentNode
public Node getParentNode()
Unimplemented. See org.w3c.dom.Node
getPrefix
public String getPrefix()
Unimplemented. See org.w3c.dom.Node
getPreviousSibling
public Node getPreviousSibling()
Unimplemented. See org.w3c.dom.Node
getSchemaTypeInfo
public TypeInfo getSchemaTypeInfo()
Method getSchemaTypeInfo.
getSpecified
public boolean getSpecified()
Unimplemented. See org.w3c.dom.Node
getStrictErrorChecking
public boolean getStrictErrorChecking()
Based on the
Document
Object Model (DOM) Level 3 Core Specification of 07 April 2004..
An attribute specifying whether errors checking is enforced or not.
When set to
false
, the implementation is free to not
test every possible error case normally defined on DOM operations,
and not raise any
DOMException
. In case of error, the
behavior is undefined. This attribute is
true
by
defaults.
- DOM Level 3
NEEDSDOC ($objectName$) @return
getTagName
public String getTagName()
Unimplemented. See org.w3c.dom.Node
getTextContent
public String getTextContent()
throws DOMException
This attribute returns the text content of this node and its
descendants. When it is defined to be null, setting it has no effect.
When set, any possible children this node may have are removed and
replaced by a single
Text
node containing the string
this attribute is set to. On getting, no serialization is performed,
the returned string does not contain any markup. No whitespace
normalization is performed, the returned string does not contain the
element content whitespaces . Similarly, on setting, no parsing is
performed either, the input string is taken as pure textual content.
The string returned is made of the text content of this node
depending on its type, as defined below:
Node type | Content |
---|
ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE,
DOCUMENT_FRAGMENT_NODE | concatenation of the textContent
attribute value of every child node, excluding COMMENT_NODE and
PROCESSING_INSTRUCTION_NODE nodes |
ATTRIBUTE_NODE, TEXT_NODE,
CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE |
nodeValue |
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE |
null |
getUserData
public Object getUserData(String key)
Retrieves the object associated to a key on a this node. The object
must first have been set to this node by calling
setUserData
with the same key.
key
- The key the object is associated to.
- Returns the
DOMObject
associated to the given key
on this node, or null
if there was none.
getWholeText
public String getWholeText()
DOM Level 3
Returns all text of Text
nodes logically-adjacent text
nodes to this node, concatenated in document order.
getXmlEncoding
public String getXmlEncoding()
getXmlStandalone
public boolean getXmlStandalone()
getXmlVersion
public String getXmlVersion()
hasAttribute
public boolean hasAttribute(String name)
Unimplemented. See org.w3c.dom.Element
name
- Name of an attribute
hasAttributeNS
public boolean hasAttributeNS(String name,
String x)
Unimplemented. See org.w3c.dom.Element
hasAttributes
public boolean hasAttributes()
Unimplemented. Introduced in DOM Level 2.
hasChildNodes
public boolean hasChildNodes()
Unimplemented. See org.w3c.dom.Node
importNode
public Node importNode(Node importedNode,
boolean deep)
throws DOMException
Unimplemented. See org.w3c.dom.Document
importedNode
- The node to import.deep
- If true
, recursively import the subtree under
the specified node; if false
, import only the node
itself, as explained above. This has no effect on Attr
, EntityReference
, and Notation
nodes.
insertBefore
public Node insertBefore(Node newChild,
Node refChild)
throws DOMException
Unimplemented. See org.w3c.dom.Node
newChild
- New child node to insertrefChild
- Insert in front of this child
insertData
public void insertData(int offset,
String arg)
throws DOMException
Unimplemented.
offset
- Start offset of substring to insert.
NEEDSDOC @param arg
isDefaultNamespace
public boolean isDefaultNamespace(String namespaceURI)
DOM Level 3:
This method checks if the specified namespaceURI
is the
default namespace or not.
namespaceURI
- The namespace URI to look for.
true
if the specified namespaceURI
is the default namespace, false
otherwise.
isEqualNode
public boolean isEqualNode(Node arg)
Tests whether two nodes are equal.
This method tests for equality of nodes, not sameness (i.e.,
whether the two nodes are references to the same object) which can be
tested with Node.isSameNode
. All nodes that are the same
will also be equal, though the reverse may not be true.
Two nodes are equal if and only if the following conditions are
satisfied: The two nodes are of the same type.The following string
attributes are equal: nodeName
, localName
,
namespaceURI
, prefix
, nodeValue
, baseURI
. This is: they are both null
, or
they have the same length and are character for character identical.
The attributes
NamedNodeMaps
are equal.
This is: they are both null
, or they have the same
length and for each node that exists in one map there is a node that
exists in the other map and is equal, although not necessarily at the
same index.The childNodes
NodeLists
are
equal. This is: they are both null
, or they have the
same length and contain equal nodes at the same index. This is true
for Attr
nodes as for any other type of node. Note that
normalization can affect equality; to avoid this, nodes should be
normalized before being compared.
For two DocumentType
nodes to be equal, the following
conditions must also be satisfied: The following string attributes
are equal: publicId
, systemId
,
internalSubset
.The entities
NamedNodeMaps
are equal.The notations
NamedNodeMaps
are equal.
On the other hand, the following do not affect equality: the
ownerDocument
attribute, the specified
attribute for Attr
nodes, the
isWhitespaceInElementContent
attribute for
Text
nodes, as well as any user data or event listeners
registered on the nodes.
arg
- The node to compare equality with.
- If the nodes, and possibly subtrees are equal,
true
otherwise false
.
isId
public boolean isId()
isSameNode
public boolean isSameNode(Node other)
Returns whether this node is the same node as the given one.
This method provides a way to determine whether two
Node
references returned by the implementation reference
the same object. When two Node
references are references
to the same object, even if through a proxy, the references may be
used completely interchangably, such that all attributes have the
same values and calling the same DOM method on either reference
always has exactly the same effect.
other
- The node to test against.
- Returns
true
if the nodes are the same,
false
otherwise.
isSupported
public boolean isSupported(String feature,
String version)
Tests whether the DOM implementation implements a specific feature and
that feature is supported by this node.
feature
- The name of the feature to test. This is the same name
which can be passed to the method hasFeature
on
DOMImplementation
.version
- This is the version number of the feature to test. In
Level 2, version 1, this is the string "2.0". If the version is not
specified, supporting any version of the feature will cause the
method to return true
.
isWhitespaceInElementContent
public boolean isWhitespaceInElementContent()
DOM Level 3
Returns whether this text node contains whitespace in element content,
often abusively called "ignorable whitespace".
item
public Node item(int index)
Unimplemented. See org.w3c.dom.NodeList
index
- index of a child of this node in its list of children
lookupNamespaceURI
public String lookupNamespaceURI(String specifiedPrefix)
DOM Level 3:
Look up the namespace URI associated to the given prefix, starting from this node.
Use lookupNamespaceURI(null) to lookup the default namespace
lookupPrefix
public String lookupPrefix(String namespaceURI)
DOM Level 3:
Look up the prefix associated to the given namespace URI, starting from this node.
- the prefix for the namespace
normalize
public void normalize()
Unimplemented. See org.w3c.dom.Node
normalizeDocument
public void normalizeDocument()
DOM Level 3
Normalize document.
removeAttribute
public void removeAttribute(String name)
throws DOMException
Unimplemented. See org.w3c.dom.Element
name
- Attribute node name to remove from list of attributes
removeAttributeNS
public void removeAttributeNS(String namespaceURI,
String localName)
throws DOMException
Unimplemented. See org.w3c.dom.Element
namespaceURI
- Namespace URI of attribute node to removelocalName
- Local part of qualified name of attribute node to remove
removeAttributeNode
public Attr removeAttributeNode(Attr oldAttr)
throws DOMException
Unimplemented. See org.w3c.dom.Element
oldAttr
- Attribute to be removed from this node's list of attributes
removeChild
public Node removeChild(Node oldChild)
throws DOMException
Unimplemented. See org.w3c.dom.Node
oldChild
- Child to be removed
renameNode
public Node renameNode(Node n,
String namespaceURI,
String name)
throws DOMException
DOM Level 3
Renaming node
replaceChild
public Node replaceChild(Node newChild,
Node oldChild)
throws DOMException
Unimplemented. See org.w3c.dom.Node
newChild
- Replace existing child with this oneoldChild
- Existing child to be replaced
replaceData
public void replaceData(int offset,
int count,
String arg)
throws DOMException
Unimplemented.
offset
- Start offset of substring to replace.count
- The length of the substring to replace.arg
- substring to replace with
replaceWholeText
public Text replaceWholeText(String content)
throws DOMException
DOM Level 3
setActualEncoding
public void setActualEncoding(String value)
DOM Level 3
An attribute specifying the actual encoding of this document. This is
null
otherwise.
This attribute represents the property [character encoding scheme]
defined in .
setAttribute
public void setAttribute(String name,
String value)
throws DOMException
Unimplemented. See org.w3c.dom.Element
name
- Name of attribute to setvalue
- Value of attribute
setAttributeNS
public void setAttributeNS(String namespaceURI,
String qualifiedName,
String value)
throws DOMException
Unimplemented. See org.w3c.dom.Element
namespaceURI
- Namespace URI of attribute node to set
NEEDSDOC @param qualifiedNamevalue
- value of attribute
setAttributeNode
public Attr setAttributeNode(Attr newAttr)
throws DOMException
Unimplemented. See org.w3c.dom.Element
newAttr
- Attribute node to be added to this node's list of attributes
setAttributeNodeNS
public Attr setAttributeNodeNS(Attr newAttr)
throws DOMException
Unimplemented. See org.w3c.dom.Element
newAttr
- Attribute to set
setData
public void setData(String data)
throws DOMException
Set Node data
data
- data to set for this node
setDocumentURI
public void setDocumentURI(String documentURI)
DOM Level 3
setIdAttribute
public void setIdAttribute(String name,
boolean makeId)
DOM Level 3: register the given attribute node as an ID attribute
setIdAttribute
public void setIdAttribute(boolean id)
NON-DOM: set the type of this attribute to be ID type.
setIdAttributeNS
public void setIdAttributeNS(String namespaceURI,
String localName,
boolean makeId)
DOM Level 3: register the given attribute node as an ID attribute
setIdAttributeNode
public void setIdAttributeNode(Attr at,
boolean makeId)
DOM Level 3: register the given attribute node as an ID attribute
setInputEncoding
public void setInputEncoding(String encoding)
- DOM Level 3
NEEDSDOC @param encoding
setNodeValue
public void setNodeValue(String nodeValue)
throws DOMException
Unimplemented. See org.w3c.dom.Node
nodeValue
- Value to set this node to
setPrefix
public void setPrefix(String prefix)
throws DOMException
Unimplemented. See org.w3c.dom.Node
prefix
- Prefix to set for this node
setStrictErrorChecking
public void setStrictErrorChecking(boolean strictErrorChecking)
Based on the
Document
Object Model (DOM) Level 3 Core Specification of 07 April 2004..
An attribute specifying whether errors checking is enforced or not.
When set to
false
, the implementation is free to not
test every possible error case normally defined on DOM operations,
and not raise any
DOMException
. In case of error, the
behavior is undefined. This attribute is
true
by
defaults.
- DOM Level 3
NEEDSDOC @param strictErrorChecking
setTextContent
public void setTextContent(String textContent)
throws DOMException
This attribute returns the text content of this node and its
descendants. When it is defined to be null, setting it has no effect.
When set, any possible children this node may have are removed and
replaced by a single
Text
node containing the string
this attribute is set to. On getting, no serialization is performed,
the returned string does not contain any markup. No whitespace
normalization is performed, the returned string does not contain the
element content whitespaces . Similarly, on setting, no parsing is
performed either, the input string is taken as pure textual content.
The string returned is made of the text content of this node
depending on its type, as defined below:
Node type | Content |
---|
ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE,
DOCUMENT_FRAGMENT_NODE | concatenation of the textContent
attribute value of every child node, excluding COMMENT_NODE and
PROCESSING_INSTRUCTION_NODE nodes |
ATTRIBUTE_NODE, TEXT_NODE,
CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE |
nodeValue |
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE |
null |
setUserData
public Object setUserData(String key,
Object data,
UserDataHandler handler)
setValue
public void setValue(String value)
throws DOMException
Unimplemented. See org.w3c.dom.Node
value
- Value to set this node to
setXmlEncoding
public void setXmlEncoding(String xmlEncoding)
setXmlStandalone
public void setXmlStandalone(boolean xmlStandalone)
throws DOMException
setXmlVersion
public void setXmlVersion(String xmlVersion)
throws DOMException
splitText
public Text splitText(int offset)
throws DOMException
Unimplemented.
offset
- Offset into text to split
substringData
public String substringData(int offset,
int count)
throws DOMException
Unimplemented.
offset
- Start offset of substring to extract.count
- The length of the substring to extract.