javax.imageio.metadata
类 IIOMetadataNode

java.lang.Object
  javax.imageio.metadata.IIOMetadataNode

所有已实现的接口：

Element, Node, NodeList

public class IIOMetadataNode
extends Object
implements Element, NodeList

表示元数据树中节点的类，该类实现 org.w3c.dom.Element 接口，还允许通过 getUserObject 和 setUserObject 方法存储非文本对象。

此类不用于进行通用 XML 处理。尤其是，在 Image I/O API 中创建的 Element 节点与 SUN 的 org.w3.dom API 标准实现创建的节点不兼容。特别是该实现经过调整只能用于一些简单用途，它不能很好地进行密集处理。

在此实现中名称空间将被忽略。术语“标记名称”和“节点名称”始终被视为同义。

另请参见：

IIOMetadata.getAsTree(java.lang.String), IIOMetadata.setFromTree(java.lang.String, org.w3c.dom.Node), IIOMetadata.mergeTree(java.lang.String, org.w3c.dom.Node)

字段摘要

从接口 org.w3c.dom.Node 继承的字段

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

构造方法摘要

IIOMetadataNode()
构造一个空的 IIOMetadataNode。

IIOMetadataNode(String nodeName)
构造一个具有给定节点名称的 IIOMetadataNode。

方法摘要

Node	appendChild(Node newChild) 将节点 newChild 添加到此节点子节点列表的末尾。
Node	cloneNode(boolean deep) 返回此节点的复本。
short	compareDocumentPosition(Node other) 就节点在文档中的位置并按照文档的顺序，比较引用节点（即在其上调用此方法的节点）与作为参数传递的节点。
String	getAttribute(String name) 通过名称获得属性值。
Attr	getAttributeNode(String name) 通过名称获得属性节点。
Attr	getAttributeNodeNS(String namespaceURI, String localName) 等效于 getAttributeNode(localName)。
String	getAttributeNS(String namespaceURI, String localName) 等效于 getAttribute(localName)。
NamedNodeMap	getAttributes() 包含此节点的属性的 NamedNodeMap（如果它是 Element）；否则为 null。
String	getBaseURI() 此节点的绝对基 URI；如果实现不能获得绝对 URI，则为 null。
NodeList	getChildNodes() 包含此节点的所有子节点的 NodeList。
NodeList	getElementsByTagName(String name) 以文档顺序返回具有给定标记名称的所有后代 Elements 的 NodeList。
NodeList	getElementsByTagNameNS(String namespaceURI, String localName) 等效于 getElementsByTagName(localName)。
Object	getFeature(String feature, String version) 此方法返回一个特定的对象，该对象实现指定功能或版本的特定 API，如下所述。
Node	getFirstChild() 此节点的第一个子节点；如果该节点没有子节点，则返回 null。
Node	getLastChild() 返回此节点的最后一个子节点；如果该节点没有子节点，则返回 null。
int	getLength() 列表中的节点数。
String	getLocalName() 等效于 getNodeName。
String	getNamespaceURI() 返回 null，因为不支持名称空间。
Node	getNextSibling() 返回此节点的下一个兄弟节点；如果该节点没有下一个兄弟节点，则返回 null。
String	getNodeName() 返回与此节点关联的节点名称。
short	getNodeType() 返回节点类型，其始终为 ELEMENT_NODE。
String	getNodeValue() 此节点的值，取决于其类型；参见上表。
Document	getOwnerDocument() 返回 null，因为 IIOMetadataNode 不属于任何 Document。
Node	getParentNode() 返回此节点的父节点。
String	getPrefix() 返回 null，因为不支持名称空间。
Node	getPreviousSibling() 返回此节点的上一个兄弟节点；如果该节点没有上一个兄弟节点，则返回 null。
TypeInfo	getSchemaTypeInfo() 与此元素相关的类型信息。
String	getTagName() 元素的名称。
String	getTextContent() 此属性返回此节点及其后代的文本内容。
Object	getUserData(String key) 检索与此节点上的某个键相关联的对象。
Object	getUserObject() 返回与此节点关联的 Object 值。
boolean	hasAttribute(String name) 当具有给定名称的属性在此元素上被指定一个值或具有默认值时，返回 true；否则返回 false。
boolean	hasAttributeNS(String namespaceURI, String localName) 等效于 hasAttribute(localName)。
boolean	hasAttributes() 返回此节点（如果它是一个元素）是否具有任何属性。
boolean	hasChildNodes() 如果此节点有子节点，则返回 true。
Node	insertBefore(Node newChild, Node refChild) 在现有子节点 refChild 之前插入节点 newChild。
boolean	isDefaultNamespace(String namespaceURI) 此方法检查指定的 namespaceURI 是否是默认名称空间。
boolean	isEqualNode(Node node) 测试两个节点是否相等。
boolean	isSameNode(Node node) 返回此节点是否是与给定节点相同的节点。
boolean	isSupported(String feature, String version) 返回 false，因为不支持 DOM 功能。
Node	item(int index) 返回集合中的第 index 个项。
String	lookupNamespaceURI(String prefix) 从此节点开始，查找与给定前缀相关的名称空间 URI。
String	lookupPrefix(String namespaceURI) 从此节点开始，查找与给定名称空间 URI 相关的前缀。
void	normalize() 不执行任何操作，因为 IIOMetadataNode 不包含 Text 子节点。
void	removeAttribute(String name) 通过名称移除一个属性。
Attr	removeAttributeNode(Attr oldAttr) 移除指定的属性节点。
void	removeAttributeNS(String namespaceURI, String localName) 等效于 removeAttribute(localName)。
Node	removeChild(Node oldChild) 从子节点列表中移除 oldChild 所指示的子节点，并将其返回。
Node	replaceChild(Node newChild, Node oldChild) 将子节点 oldChild 替换为子节点列表中的 newChild，并返回 oldChild 节点。
void	setAttribute(String name, String value) 添加一个新属性。
Attr	setAttributeNode(Attr newAttr) 添加新的属性节点。
Attr	setAttributeNodeNS(Attr newAttr) 等效于 setAttributeNode(newAttr)。
void	setAttributeNS(String namespaceURI, String qualifiedName, String value) 等效于 setAttribute(qualifiedName, value)。
void	setIdAttribute(String name, boolean isId) 如果参数 isId 为 true，则此方法将指定的属性声明为用于确定用户的 ID 属性。
void	setIdAttributeNode(Attr idAttr, boolean isId) 如果参数 isId 为 true，则此方法将指定的属性声明为用户确定的 ID 属性。
void	setIdAttributeNS(String namespaceURI, String localName, boolean isId) 如果参数 isId 为 true，则此方法将指定的属性声明为用户确定的 ID 属性。
void	setNodeValue(String nodeValue) 此节点的值，取决于其类型；参见上表。
void	setPrefix(String prefix) 不执行任何操作，因为不支持名称空间。
void	setTextContent(String textContent) 此属性返回此节点及其后代的文本内容。
Object	setUserData(String key, Object data, UserDataHandler handler) 将对象与此节点上的键相关联。
void	setUserObject(Object userObject) 设置与此节点关联的值。

从类 java.lang.Object 继承的方法

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

构造方法详细信息

IIOMetadataNode

public IIOMetadataNode()

构造一个空的 IIOMetadataNode。

IIOMetadataNode

public IIOMetadataNode(String nodeName)

构造一个具有给定节点名称的 IIOMetadataNode。

参数：

nodeName - 以 String 形式表示的节点名称。

方法详细信息

getNodeName

public String getNodeName()

返回与此节点关联的节点名称。

指定者：

接口 Node 中的 getNodeName

返回：

以 String 形式表示的节点名称。

getNodeValue

public String getNodeValue()
                    throws DOMException

从接口 Node 复制的描述

此节点的值，取决于其类型；参见上表。当将它定义为 null 时，设置它无效，包括节点为只读的情况。

指定者：

接口 Node 中的 getNodeValue

抛出：

DOMException - DOMSTRING_SIZE_ERR: 在它返回的字符多于实现平台上 DOMString 变量中适合的字符时引发此异常。

setNodeValue

public void setNodeValue(String nodeValue)
                  throws DOMException

从接口 Node 复制的描述

此节点的值，取决于其类型；参见上表。当将它定义为 null 时，设置它无效，包括节点为只读的情况。

指定者：

接口 Node 中的 setNodeValue

抛出：

DOMException - NO_MODIFICATION_ALLOWED_ERR: 当节点为只读且未将它定义为 null 时引发此异常。

getNodeType

public short getNodeType()

返回节点类型，其始终为 ELEMENT_NODE。

指定者：

接口 Node 中的 getNodeType

返回：

short 值 ELEMENT_NODE。

getParentNode

public Node getParentNode()

返回此节点的父节点。null 值指示该节点是它自己的树的根。要在现有树中添加节点，请使用 insertBefore、replaceChild 或 appendChild 方法之一。

指定者：

接口 Node 中的 getParentNode

返回：

以 Node 形式表示的父节点。

另请参见：

insertBefore(org.w3c.dom.Node, org.w3c.dom.Node), replaceChild(org.w3c.dom.Node, org.w3c.dom.Node), appendChild(org.w3c.dom.Node)

getChildNodes

public NodeList getChildNodes()

从接口 Node 复制的描述

包含此节点的所有子节点的 NodeList。如果不存在子节点，则这是不包含节点的 NodeList。

指定者：

接口 Node 中的 getChildNodes

getFirstChild

public Node getFirstChild()

此节点的第一个子节点；如果该节点没有子节点，则返回 null。

指定者：

接口 Node 中的 getFirstChild

返回：

以 Node 形式表示的第一个子节点；或者 null

getLastChild

public Node getLastChild()

返回此节点的最后一个子节点；如果该节点没有子节点，则返回 null。

指定者：

接口 Node 中的 getLastChild

返回：

以 Node 形式表示的最后一个子节点；或者 null。

getPreviousSibling

public Node getPreviousSibling()

返回此节点的上一个兄弟节点；如果该节点没有上一个兄弟节点，则返回 null。

指定者：

接口 Node 中的 getPreviousSibling

返回：

以 Node 形式表示的上一个兄弟节点；或者 null。

getNextSibling

public Node getNextSibling()

返回此节点的下一个兄弟节点；如果该节点没有下一个兄弟节点，则返回 null。

指定者：

接口 Node 中的 getNextSibling

返回：

以 Node 形式表示的下一个兄弟节点；或者 null。

getAttributes

public NamedNodeMap getAttributes()

从接口 Node 复制的描述

包含此节点的属性的 NamedNodeMap（如果它是 Element）；否则为 null。

指定者：

接口 Node 中的 getAttributes

getOwnerDocument

public Document getOwnerDocument()

返回 null，因为 IIOMetadataNode 不属于任何 Document。

指定者：

接口 Node 中的 getOwnerDocument

返回：

null。

insertBefore

public Node insertBefore(Node newChild,
                         Node refChild)

在现有子节点 refChild 之前插入节点 newChild。如果 refChild 为 null，则将 newChild 插入到子节点列表的末尾。

指定者：

接口 Node 中的 insertBefore

参数：

newChild - 要插入的 Node。

refChild - 引用 Node。

返回：

要插入的节点。

抛出：

IllegalArgumentException - 如果 newChild 为 null。

replaceChild

public Node replaceChild(Node newChild,
                         Node oldChild)

将子节点 oldChild 替换为子节点列表中的 newChild，并返回 oldChild 节点。

指定者：

接口 Node 中的 replaceChild

参数：

newChild - 要插入的 Node。

oldChild - 要替换的 Node。

返回：

替换的节点。

抛出：

IllegalArgumentException - 如果 newChild 为 null。

removeChild

public Node removeChild(Node oldChild)

从子节点列表中移除 oldChild 所指示的子节点，并将其返回。

指定者：

接口 Node 中的 removeChild

参数：

oldChild - 要移除的 Node。

返回：

移除的节点。

抛出：

IllegalArgumentException - 如果 oldChild 为 null。

appendChild

public Node appendChild(Node newChild)

将节点 newChild 添加到此节点子节点列表的末尾。

指定者：

接口 Node 中的 appendChild

参数：

newChild - 要插入的 Node。

返回：

添加的节点。

抛出：

IllegalArgumentException - 如果 newChild 为 null。

hasChildNodes

public boolean hasChildNodes()

如果此节点有子节点，则返回 true。

指定者：

接口 Node 中的 hasChildNodes

返回：

如果此节点有子节点，则返回 true。

cloneNode

public Node cloneNode(boolean deep)

返回此节点的复本。复本节点没有父节点（getParentNode 返回 null）。如果正在执行浅表克隆（deep 为 false），则新节点将没有任何子节点或兄弟节点。如果正在执行深层克隆，则新节点将形成完整克隆的子树的根。

指定者：

接口 Node 中的 cloneNode

参数：

deep - 如果为 true，则在指定节点下递归式克隆子树；如果为 false，则仅克隆节点本身。

返回：

复本节点。

normalize

public void normalize()

不执行任何操作，因为 IIOMetadataNode 不包含 Text 子节点。

指定者：

接口 Node 中的 normalize

isSupported

public boolean isSupported(String feature,
                           String version)

返回 false，因为不支持 DOM 功能。

指定者：

接口 Node 中的 isSupported

参数：

feature - 一个 String，忽略该参数。

version - 一个 String，忽略该参数。

返回：

false。

getNamespaceURI

public String getNamespaceURI()
                       throws DOMException

返回 null，因为不支持名称空间。

指定者：

接口 Node 中的 getNamespaceURI

抛出：

DOMException

getPrefix

public String getPrefix()

返回 null，因为不支持名称空间。

指定者：

接口 Node 中的 getPrefix

返回：

null。

另请参见：

setPrefix(java.lang.String)

setPrefix

public void setPrefix(String prefix)

不执行任何操作，因为不支持名称空间。

指定者：

接口 Node 中的 setPrefix

参数：

prefix - 一个 String，忽略该参数。

另请参见：

getPrefix()

getLocalName

public String getLocalName()

等效于 getNodeName。

指定者：

接口 Node 中的 getLocalName

返回：

以 String 形式表示的节点名称。

getTagName

public String getTagName()

从接口 Element 复制的描述

元素的名称。如果 Node.localName 与 null 不同，则此属性为一个限定名称。例如，在以下示例中：

 <elementExample id="demo"> ... 
 </elementExample> , 

tagName 具有值 "elementExample"。注意，这在 XML 中是保留大小写的，DOM 中的所有操作也是这样。HTML DOM 以规范的大写形式返回 HTML 元素的 tagName，而不考虑源 HTML 文档中的大小写形式。

指定者：

接口 Element 中的 getTagName

getAttribute

public String getAttribute(String name)

从接口 Element 复制的描述

通过名称获得属性值。

指定者：

接口 Element 中的 getAttribute

参数：

name - 要获得的属性名称。

返回：

字符串形式的 Attr 值；如果该属性没有指定值或默认值，则返回空字符串。

getAttributeNS

public String getAttributeNS(String namespaceURI,
                             String localName)

等效于 getAttribute(localName)。

指定者：

接口 Element 中的 getAttributeNS

参数：

namespaceURI - 要获得的属性的名称空间 URI。

localName - 要获得的属性的本地名称。

返回：

字符串形式的 Attr 值；如果该属性没有指定值或默认值，则返回空字符串。

另请参见：

setAttributeNS(java.lang.String, java.lang.String, java.lang.String)

setAttribute

public void setAttribute(String name,
                         String value)

从接口 Element 复制的描述

添加一个新属性。如果具有该名称的属性已经出现在元素中，则将其值更改为值参数的值。此值为简单的字符串；在设置它时没有对它进行解析。因此，将任何标记（如作为实体引用而被识别的语法）视为字面值文本，并且需要在写出时由实现适当转义。为了分配包含实体引用的属性值，用户必须创建一个 Attr 节点，加上所有 Text 和 EntityReference 节点，构建适当的子树，并将它作为属性值，通过 setAttributeNode 方法来分配。
要设置具有限定名称和名称空间 URI 的属性，使用 setAttributeNS 方法。

指定者：

接口 Element 中的 setAttribute

参数：

name - 要创建或更改的属性名称。

value - 以字符串形式设置的值。

setAttributeNS

public void setAttributeNS(String namespaceURI,
                           String qualifiedName,
                           String value)

等效于 setAttribute(qualifiedName, value)。

指定者：

接口 Element 中的 setAttributeNS

参数：

namespaceURI - 要创建或更改的属性的名称空间 URI。

qualifiedName - 要创建或更改的属性的限定名称。

value - 以字符串形式设置的值。

另请参见：

getAttributeNS(java.lang.String, java.lang.String)

removeAttribute

public void removeAttribute(String name)

从接口 Element 复制的描述

通过名称移除一个属性。如果被移除属性的默认值在 DTD 中定义，则新的属性值将在可用时随该默认值以及相应名称空间 URI、本地名称和前缀立即出现。类似地，实现可以处理其他模式的默认值，但应用程序应该使用 Document.normalizeDocument() 来保证此信息最新。
如果找不到具有此名称的属性，则此方法无效。
要通过本地名称和名称空间 URI 移除属性，使用 removeAttributeNS 方法。

指定者：

接口 Element 中的 removeAttribute

参数：

name - 要移除的属性的名称。

removeAttributeNS

public void removeAttributeNS(String namespaceURI,
                              String localName)

等效于 removeAttribute(localName)。

指定者：

接口 Element 中的 removeAttributeNS

参数：

namespaceURI - 要移除的属性的名称空间 URI。

localName - 要移除的属性的本地名称。

getAttributeNode

public Attr getAttributeNode(String name)

从接口 Element 复制的描述

通过名称获得属性节点。
要通过限定名称和名称空间 URI 获得属性节点，使用 getAttributeNodeNS 方法。

指定者：

接口 Element 中的 getAttributeNode

参数：

name - 要获得的属性名称 (nodeName)。

返回：

返回具有指定名称 (nodeName) 的 Attr 节点；如果没有这样的属性，则返回 null。

getAttributeNodeNS

public Attr getAttributeNodeNS(String namespaceURI,
                               String localName)

等效于 getAttributeNode(localName)。

指定者：

接口 Element 中的 getAttributeNodeNS

参数：

namespaceURI - 要获得的属性的名称空间 URI。

localName - 要获得的属性的本地名称。

返回：

具有特定属性名称和名称空间 URI 的 Attr 节点；如果没有这样的属性，则返回 null。

另请参见：

setAttributeNodeNS(org.w3c.dom.Attr)

setAttributeNode

public Attr setAttributeNode(Attr newAttr)
                      throws DOMException

从接口 Element 复制的描述

添加新的属性节点。如果具有该名称 (nodeName) 的属性已经出现在元素中，则用新属性替换它。用自身替换属性节点无效。
要添加具有限定名称和名称空间 URI 的新属性节点，使用 setAttributeNodeNS 方法。

指定者：

接口 Element 中的 setAttributeNode

参数：

newAttr - 要添加到属性列表的 Attr 节点。

返回：

如果用 newAttr 属性替换现有属性，则返回被替换的 Attr 节点；否则返回 null。

抛出：

DOMException - WRONG_DOCUMENT_ERR: 如果 newAttr 是从不同的文档创建的，不是从创建该元素的文档创建的，则引发此异常。
NO_MODIFICATION_ALLOWED_ERR: 如果此节点为只读的，则引发此异常。
INUSE_ATTRIBUTE_ERR: 如果 newAttr 已经是另一个 Element 对象的属性，则引发此异常。DOM 用户必须显式地克隆 Attr 节点，以便在其他元素中重新使用它们。

setAttributeNodeNS

public Attr setAttributeNodeNS(Attr newAttr)

等效于 setAttributeNode(newAttr)。

指定者：

接口 Element 中的 setAttributeNodeNS

参数：

newAttr - 要添加到属性列表的 Attr 节点。

返回：

如果用 newAttr 属性替换具有相同本地名称和名称空间 URI 的现有属性，则返回被替换的 Attr 节点；否则返回 null。

另请参见：

getAttributeNodeNS(java.lang.String, java.lang.String)

removeAttributeNode

public Attr removeAttributeNode(Attr oldAttr)

从接口 Element 复制的描述

移除指定的属性节点。如果在 DTD 中定义了被移除 Attr 节点的默认值，则新的节点将在可用时随该默认值以及相应名称空间 URI、本地名称和前缀一起立即出现。类似地，实现可以处理其他模式的默认值，但应用程序应该使用 Document.normalizeDocument() 来保证此信息最新。

指定者：

接口 Element 中的 removeAttributeNode

参数：

oldAttr - 从属性列表中移除的 Attr 节点。

返回：

被移除的 Attr 节点。

getElementsByTagName

public NodeList getElementsByTagName(String name)

从接口 Element 复制的描述

以文档顺序返回具有给定标记名称的所有后代 Elements 的 NodeList。

指定者：

接口 Element 中的 getElementsByTagName

参数：

name - 要匹配的标记的名称。特殊值 "*" 匹配所有标记。

返回：

匹配的 Element 节点列表。

getElementsByTagNameNS

public NodeList getElementsByTagNameNS(String namespaceURI,
                                       String localName)

等效于 getElementsByTagName(localName)。

指定者：

接口 Element 中的 getElementsByTagNameNS

参数：

namespaceURI - 要匹配的元素的名称空间 URI。特殊值 "*" 匹配所有名称空间。

localName - 要匹配的元素的本地名称。特殊值 "*" 匹配所有本地名称。

返回：

包含所有匹配的 Elements 的新 NodeList 对象。

hasAttributes

public boolean hasAttributes()

从接口 Node 复制的描述

返回此节点（如果它是一个元素）是否具有任何属性。

指定者：

接口 Node 中的 hasAttributes

返回：

如果此节点具有任何属性，则返回 true；否则返回 false。

hasAttribute

public boolean hasAttribute(String name)

从接口 Element 复制的描述

当具有给定名称的属性在此元素上被指定一个值或具有默认值时，返回 true；否则返回 false。

指定者：

接口 Element 中的 hasAttribute

参数：

name - 要查找的属性名称。

返回：

如果具有给定名称的属性在此元素上被指定一个值或具有默认值，则返回 true；否则返回 false。

hasAttributeNS

public boolean hasAttributeNS(String namespaceURI,
                              String localName)

等效于 hasAttribute(localName)。

指定者：

接口 Element 中的 hasAttributeNS

参数：

namespaceURI - 要查找的属性的名称空间 URI。

localName - 要查找的属性的本地名称。

返回：

如果具有给定本地名称和名称空间 URI 的属性在此元素上被指定一个值或具有默认值，则返回 true；否则返回 false。

getLength

public int getLength()

从接口 NodeList 复制的描述

列表中的节点数。有效子节点索引的范围是 0 到 length-1（包含此值）。

指定者：

接口 NodeList 中的 getLength

item

public Node item(int index)

从接口 NodeList 复制的描述

返回集合中的第 index 个项。如果 index 大于或等于此列表中的节点数，则返回 null。

指定者：

接口 NodeList 中的 item

参数：

index - 集合中的索引。

返回：

返回该 NodeList 中 index 位置处的节点；如果索引是无效索引，则返回 null。

getUserObject

public Object getUserObject()

返回与此节点关联的 Object 值。

返回：

用户 Object。

另请参见：

setUserObject(java.lang.Object)

setUserObject

public void setUserObject(Object userObject)

设置与此节点关联的值。

参数：

userObject - 用户 Object。

另请参见：

getUserObject()

setIdAttribute

public void setIdAttribute(String name,
                           boolean isId)
                    throws DOMException

从接口 Element 复制的描述

如果参数 isId 为 true，则此方法将指定的属性声明为用于确定用户的 ID 属性。此方法影响 Attr.isId 的值和 Document.getElementById 的行为，但不更改可能正在使用的任何模式；需要特别指出的是，此方法不影响指定 Attr 节点的 Attr.schemaTypeInfo。使用参数 isId 的值 false 来取消将属性声明为用户确定的 ID 属性。
要通过本地名称和名称空间 URI 指定属性，使用 setIdAttributeNS 方法。

指定者：

接口 Element 中的 setIdAttribute

参数：

name - 属性名称。

isId - 属性是否是 ID 类型。

抛出：

DOMException - NO_MODIFICATION_ALLOWED_ERR:如果此节点为只读的，则引发此异常。
NOT_FOUND_ERR:如果指定的节点不是此元素的属性，则引发此异常。

setIdAttributeNS

public void setIdAttributeNS(String namespaceURI,
                             String localName,
                             boolean isId)
                      throws DOMException

从接口 Element 复制的描述

如果参数 isId 为 true，则此方法将指定的属性声明为用户确定的 ID 属性。此方法影响 Attr.isId 的值和 Document.getElementById 的行为，但不更改可能正在使用的任何模式；需要特别指出的是，此方法不影响指定 Attr 节点的 Attr.schemaTypeInfo。使用参数 isId 的值 false 来取消将属性声明为用户确定的 ID 属性。

指定者：

接口 Element 中的 setIdAttributeNS

参数：

namespaceURI - 属性的名称空间 URI。

isId - 属性是否是 ID 类型。

抛出：

DOMException - NO_MODIFICATION_ALLOWED_ERR:如果此节点为只读的，则引发此异常。
NOT_FOUND_ERR: 如果指定的节点不是此元素的属性，则引发此异常。

setIdAttributeNode

public void setIdAttributeNode(Attr idAttr,
                               boolean isId)
                        throws DOMException

从接口 Element 复制的描述

如果参数 isId 为 true，则此方法将指定的属性声明为用户确定的 ID 属性。此方法影响 Attr.isId 的值和 Document.getElementById 的行为，但不更改可能正在使用的任何模式；需要特别指出的是，此方法不影响指定 Attr 节点的 Attr.schemaTypeInfo。使用参数 isId 的值 false 来取消将属性声明为用户确定的 ID 属性。

指定者：

接口 Element 中的 setIdAttributeNode

参数：

idAttr - 属性节点。

isId - 属性是否是 ID 类型。

抛出：

DOMException - NO_MODIFICATION_ALLOWED_ERR: 如果此节点为只读的，则引发此异常。
NOT_FOUND_ERR: 如果指定的节点不是此元素的属性，则引发此异常。

getSchemaTypeInfo

public TypeInfo getSchemaTypeInfo()

从接口 Element 复制的描述

与此元素相关的类型信息。

指定者：

接口 Element 中的 getSchemaTypeInfo

setUserData

public Object setUserData(String key,
                          Object data,
                          UserDataHandler handler)

从接口 Node 复制的描述

将对象与此节点上的键相关联。该对象以后可以通过使用相同键的调用 getUserData 从此节点检索到。

指定者：

接口 Node 中的 setUserData

参数：

key - 将该对象与其关联的键。

data - 与给定键相关联的对象；为 null 时表示移除与任何现有的与该键的关联。

handler - 与该键关联的处理程序，或 null。

返回：

返回以前与此节点上的给定键关联的 DOMUserData；如果没有，则返回 null。

getUserData

public Object getUserData(String key)

从接口 Node 复制的描述

检索与此节点上的某个键相关联的对象。必须首先通过使用相同键的调用 setUserData 将该对象设置到此节点。

指定者：

接口 Node 中的 getUserData

参数：

key - 该对象所关联的键。

返回：

返回与此节点上的给定键关联的 DOMUserData；如果没有，则返回 null。

getFeature

public Object getFeature(String feature,
                         String version)

从接口 Node 复制的描述

此方法返回一个特定的对象，该对象实现指定功能或版本的特定 API，如下所述。该特殊对象也可以通过使用特定于绑定的强制转换方法获得，但不是必须期望这样，如文中讨论的那样。此方法还允许实现提供不支持 Node 接口的特殊对象。

指定者：

接口 Node 中的 getFeature

参数：

feature - 所请求的功能的名称。注意，追加到功能名称的任何加号 "+" 将被忽略，因为它在此方法的上下文中无关紧要。

version - 这是要测试的功能版本号。

返回：

返回实现指定功能和版本的特定 API 的对象（如果有）；如果不存在实现与该功能相关的接口的对象，则返回 null。如果此方法返回的 DOMObject 实现 Node 接口，则它必须委托给主要核心 Node 且不返回与主要核心 Node 不一致的结果，如属性、子节点，等等。

isSameNode

public boolean isSameNode(Node node)

从接口 Node 复制的描述

返回此节点是否是与给定节点相同的节点。
此方法提供一种方法来确定由实现返回的两个 Node 引用是否引用同一个对象。当两个 Node 引用引用同一个对象时，即使是通过代理，也可能完全可交换地使用这些引用，例如所有属性都有相同的值且在任何引用上调用同一个 DOM 方法总是起完全相同的作用。

指定者：

接口 Node 中的 isSameNode

参数：

node - 要测试的节点。

返回：

如果节点相同，则返回 true；否则，返回 false。

isEqualNode

public boolean isEqualNode(Node node)

从接口 Node 复制的描述

测试两个节点是否相等。
此方法测试节点的相等性，不是测试是否相同（即两个节点是否为对同一对象的引用），相同性可以使用 Node.isSameNode() 测试。所有相同的节点也将相等，尽管反之则不然。
当且仅当满足以下条件时，两个节点才相等：

• 这两个节点属于同一类型。
• 以下字符串属性相等：nodeName、localName、namespaceURI、prefix、nodeValue。也就是说：它们都为 null，或者它们具有相同的长度且是字符相等的字符。
• attributes NamedNodeMaps 相等。也就是说：它们都为 null，或者它们具有相同的长度，且对于一个映射中存在的每个节点来说，相应在另一个映射中有一个节点并且相等，尽管不是必须在同一个索引处。
• childNodes NodeLists 相等。也就是说：它们都为 null，或者它们具有相同的长度且在同一索引处包含相等的节点。注意，规范化可以影响相等性；要避免这种情况，应该在比较之前标准化这些节点。

两个 DocumentType 节点要是相等，还必须满足以下条件：

• 以下字符串属性相等：publicId、systemId、internalSubset。
• entities NamedNodeMaps 相等。
• notations NamedNodeMaps 相等。

另一方面，以下内容不影响相等性：ownerDocument、baseURI 和 parentNode 属性；Attr 节点的 specified 属性；Attr 和 Element 节点的 schemaTypeInfo 属性；Text 节点的 Text.isElementContentWhitespace 属性；以及在节点上注册的任何用户数据和事件侦听器。

注：通常，在相等性检查的考虑中，上面描述中未提到的任何情况都是无关紧要的。注意，此规范的未来版本可能考虑更多属性，并且期望遵守此规范的实现进行相应的更新。

指定者：

接口 Node 中的 isEqualNode

参数：

node - 与其比较相等性的节点。

返回：

如果节点相等，则返回 true；否则，返回 false。

lookupNamespaceURI

public String lookupNamespaceURI(String prefix)

从接口 Node 复制的描述

从此节点开始，查找与给定前缀相关的名称空间 URI。
有关此方法使用的算法的详细信息，请参见。

指定者：

接口 Node 中的 lookupNamespaceURI

参数：

prefix - 要查找的前缀。如果此参数为 null，则此方法将返回默认的名称空间 URI（如果有）。

返回：

返回相关的名称空间 URI；如果未找到，则返回 null。

isDefaultNamespace

public boolean isDefaultNamespace(String namespaceURI)

从接口 Node 复制的描述

此方法检查指定的 namespaceURI 是否是默认名称空间。

指定者：

接口 Node 中的 isDefaultNamespace

参数：

namespaceURI - 要查找的名称空间 URI。

返回：

如果指定的 namespaceURI 为默认名称空间，则返回 true；否则，返回 false。

lookupPrefix

public String lookupPrefix(String namespaceURI)

从接口 Node 复制的描述

从此节点开始，查找与给定名称空间 URI 相关的前缀。此方法忽略默认名称空间声明。
参见此方法使用的算法的详细信息。

指定者：

接口 Node 中的 lookupPrefix

参数：

namespaceURI - 要查找的名称空间 URI。

返回：

如果已找到，则返回相关的名称空间前缀；如果未找到任何前缀，则返回 null。如果一个以上的前缀与名称空间前缀相关，则返回的名称空间前缀与实现有关。

getTextContent

public String getTextContent()
                      throws DOMException

从接口 Node 复制的描述

此属性返回此节点及其后代的文本内容。将它定义为 null 时，设置它无效。设置后，移除此节点可能有的任何可能的子节点，并且如果新字符串不为空或 null，则用包含此属性设置的字符串的单个 Text 节点替换。
获取后，不执行序列化，且返回的字符串不包含任何标记。不执行空白规范化且在元素内容中返回的字符串不包含空白（参见属性 Text.isElementContentWhitespace）。类似地，设置后，也不执行解析，且以纯文本内容形式采用输入字符串。
根据下面定义的节点类型，返回的字符串由此节点的文本内容生成：

节点类型	内容
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE	串接每个子节点的 textContent 属性值，不包括 COMMENT_NODE 和 PROCESSING_INSTRUCTION_NODE 节点。如果该节点没有子节点，则这是空字符串。
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE	nodeValue
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE	null

指定者：

接口 Node 中的 getTextContent

抛出：

DOMException - DOMSTRING_SIZE_ERR:在它返回的字符多于实现平台上 DOMString 变量中适合的字符时引发此异常。

setTextContent

public void setTextContent(String textContent)
                    throws DOMException

从接口 Node 复制的描述

此属性返回此节点及其后代的文本内容。将它定义为 null 时，设置它无效。设置后，移除此节点可能有的任何可能的子节点，并且，如果新字符串不为空或 null，则用包含此属性设置的字符串的单个 Text 节点替换。
获取后，不执行序列化，且返回的字符串不包含任何标记。不执行空白规范化，且返回的字符串在元素内容中不包含空白（参见属性 Text.isElementContentWhitespace）。类似地，设置后，也不执行解析，且以纯文本内容形式采用输入字符串。
根据下面定义的节点类型，返回的字符串由此节点的文本内容生成：

节点类型	内容
ELEMENT_NODE, ATTRIBUTE_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, DOCUMENT_FRAGMENT_NODE	串接每个子节点的 textContent 属性值，不包括 COMMENT_NODE 和 PROCESSING_INSTRUCTION_NODE 节点。如果该节点没有子节点，则这是空字符串。
TEXT_NODE, CDATA_SECTION_NODE, COMMENT_NODE, PROCESSING_INSTRUCTION_NODE	nodeValue
DOCUMENT_NODE, DOCUMENT_TYPE_NODE, NOTATION_NODE	null

指定者：

接口 Node 中的 setTextContent

抛出：

DOMException - NO_MODIFICATION_ALLOWED_ERR: 节点为只读的时引发此异常。

compareDocumentPosition

public short compareDocumentPosition(Node other)
                              throws DOMException

从接口 Node 复制的描述

就节点在文档中的位置并按照文档的顺序，比较引用节点（即在其上调用此方法的节点）与作为参数传递的节点。

指定者：

接口 Node 中的 compareDocumentPosition

参数：

other - 与引用节点比较的节点。

返回：

返回相对于引用节点如何定位节点。

抛出：

DOMException - NOT_SUPPORTED_ERR: 当被比较的节点来自不同的 DOM 实现，未调整该 DOM 实现以返回一致的特定于实现的结果时。

getBaseURI

public String getBaseURI()

从接口 Node 复制的描述

此节点的绝对基 URI；如果实现不能获得绝对 URI，则为 null。此值如描述的那样计算。但是，当 Document 支持功能 "HTML" [DOM Level 2 HTML] 时，首先使用 HTML BASE 元素（如果有）的 href 属性的值计算基 URI；否则，使用 Document 接口中的 documentURI 属性的值计算。

指定者：

接口 Node 中的 getBaseURI