javax.imageio.metadata

接口
类
异常

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,