模块  java.desktop
软件包  javax.imageio.metadata

Class 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标准实现创建的节点不兼容。 特别是，该实现被调整用于简单的用途，并且可能不能用于密集处理。

    在此实现中忽略命名空间。 术语“标签名称”和“节点名称”始终被视为同义词。 注：DOM Level 3的规格增加了一些新的方法到Node ， Element和Attr是有价值的不是接口IIOMetadataNode实施或规范。 调用上的这种方法IIOMetadataNode ，或Attr从返回的实例IIOMetadataNode将导致DOMException抛出。

    另请参见：
    IIOMetadata.getAsTree(java.lang.String) ， IIOMetadata.setFromTree(java.lang.String, org.w3c.dom.Node) ， IIOMetadata.mergeTree(java.lang.String, org.w3c.dom.Node)

    • 构造方法详细信息

      • IIOMetadataNode

        public IIOMetadataNode()
        构造一个空的 IIOMetadataNode 。

      • IIOMetadataNode

        public IIOMetadataNode​(String nodeName)
        构造具有给定节点名称的 IIOMetadataNode 。
        参数
        nodeName - 节点的名称，如 String 。

    • 方法详细信息

      • getNodeName

        public String getNodeName()
        返回与此节点关联的节点名称。
        Specified by:
        getNodeName接口 Node
        结果
        节点名称，如 String 。

      • getNodeValue

        public String getNodeValue()
        返回与此节点关联的值。
        Specified by:
        getNodeValue在界面 Node
        结果
        节点值，如 String 。

      • setNodeValue

        public void setNodeValue​(String nodeValue)
        设置与此节点关联的 String值。
        Specified by:
        setNodeValue接口 Node

      • getNodeType

        public short getNodeType()
        返回节点类型，始终为 ELEMENT_NODE 。
        Specified by:
        getNodeType ，界面 Node
        结果
        short ELEMENT_NODE 。

      • getChildNodes

        public NodeList getChildNodes()
        返回包含此节点的所有子节点的NodeList 。 如果没有子节点，则这是一个NodeList包含节点的NodeList 。
        Specified by:
        getChildNodes ，界面 Node
        结果
        孩子们为 NodeList

      • getFirstChild

        public Node getFirstChild()
        返回此节点的第一个子节点，如果节点没有子节点，则返回 null 。
        Specified by:
        getFirstChild接口 Node
        结果
        第一个孩子，为 Node ，或 null

      • getLastChild

        public Node getLastChild()
        返回此节点的最后一个子节点，如果节点没有子节点，则返回 null 。
        Specified by:
        getLastChild在界面 Node
        结果
        最后一个孩子，如 Node ，或 null 。

      • getPreviousSibling

        public Node getPreviousSibling()
        返回此节点的上一个兄弟节点，如果此节点没有先前的兄弟节点，则返回 null 。
        Specified by:
        getPreviousSibling ，界面 Node
        结果
        以前的兄弟姐妹，作为 Node ，或 null 。

      • getNextSibling

        public Node getNextSibling()
        返回此节点的下一个兄弟节点，如果节点没有下一个兄弟节点，则返回 null 。
        Specified by:
        getNextSibling在界面 Node
        结果
        下一个兄弟，作为 Node ，或 null 。

      • getAttributes

        public NamedNodeMap getAttributes()
        返回包含此节点的属性的 NamedNodeMap 。
        Specified by:
        getAttributes在界面 Node
        结果
        NamedNodeMap包含此节点的属性。

      • getOwnerDocument

        public Document getOwnerDocument()
        返回 null ，因为 IIOMetadataNode s不属于任何 Document 。
        Specified by:
        getOwnerDocument接口 Node
        结果
        null 。

      • insertBefore

        public Node insertBefore​(Node newChild,
                         Node refChild)
        插入节点newChild现有的子节点之前refChild 。 如果refChild是null ， newChild在子项列表的末尾插入newChild 。
        Specified by:
        insertBefore接口 Node
        参数
        newChild - 要插入的 Node 。
        refChild - 参考 Node 。
        结果
        正在插入的节点。
        异常
        IllegalArgumentException - 如果 newChild是 null 。

      • replaceChild

        public Node replaceChild​(Node newChild,
                         Node oldChild)
        替换子节点 oldChild与 newChild儿童的名单，并返回 oldChild节点。
        Specified by:
        replaceChild在界面 Node
        参数
        newChild - 要插入的 Node 。
        oldChild - 待更换的 Node 。
        结果
        节点被替换了。
        异常
        IllegalArgumentException - 如果 newChild是 null 。

      • removeChild

        public Node removeChild​(Node oldChild)
        从子项列表中删除 oldChild指示的子节点，并将其返回。
        Specified by:
        removeChild在界面 Node
        参数
        oldChild - 要删除的 Node 。
        结果
        节点已删除。
        异常
        IllegalArgumentException - 如果 oldChild是 null 。

      • appendChild

        public Node appendChild​(Node newChild)
        将节点 newChild添加到此节点的子级列表的末尾。
        Specified by:
        appendChild在界面 Node
        参数
        newChild - 要插入的 Node 。
        结果
        节点已添加。
        异常
        IllegalArgumentException - 如果 newChild是 null 。

      • hasChildNodes

        public boolean hasChildNodes()
        如果此节点具有子节点，则返回 true 。
        Specified by:
        hasChildNodes在界面 Node
        结果
        true此节点是否有子节点。

      • cloneNode

        public Node cloneNode​(boolean deep)
        返回此节点的副本。 重复节点没有父节点（ getParentNode返回null ）。 如果正在执行浅层克隆（ deep是false ），则新节点将不会有任何子节点或兄弟节点。 如果正在执行深度克隆，则新节点将形成完整克隆子树的根。
        Specified by:
        cloneNode ，界面 Node
        参数
        deep - 如果是true ，则递归克隆指定节点下的子树; 如果false ，只克隆节点本身。
        结果
        重复的节点。

      • normalize

        public void normalize()
        什么都不做，因为 IIOMetadataNode s不包含 Text孩子。
        Specified by:
        normalize在界面 Node

      • isSupported

        public boolean isSupported​(String feature,
                           String version)
        返回 false因为不支持DOM功能。
        Specified by:
        isSupported ，界面 Node
        参数
        feature - String ，被忽略。
        version - String ，将被忽略。
        结果
        false 。

      • setPrefix

        public void setPrefix​(String prefix)
        什么都不做，因为不支持名称空间。
        Specified by:
        setPrefix接口 Node
        参数
        prefix - String ，被忽略。
        另请参见：
        getPrefix()

      • getLocalName

        public String getLocalName()
        相当于 getNodeName 。
        Specified by:
        getLocalName接口 Node
        结果
        节点名称，如 String 。

      • getTagName

        public String getTagName()
        相当于 getNodeName 。
        Specified by:
        getTagName在界面 Element
        结果
        节点名称，如 String

      • getAttribute

        public String getAttribute​(String name)
        按名称检索属性值。
        Specified by:
        getAttribute在界面 Element
        参数
        name - 要检索的属性的名称。
        结果
        Attr值为字符串，如果该属性没有指定或默认值，则为空字符串。

      • setAttributeNS

        public void setAttributeNS​(String namespaceURI,
                           String qualifiedName,
                           String value)
        相当于 setAttribute(qualifiedName, value) 。
        Specified by:
        setAttributeNS ，界面 Element
        参数
        namespaceURI - 要创建或更改的属性的名称空间URI。
        qualifiedName - 要创建或更改的属性的限定名称。
        value - 以字符串形式设置的值。
        另请参见：
        getAttributeNS(java.lang.String, java.lang.String)

      • removeAttributeNS

        public void removeAttributeNS​(String namespaceURI,
                              String localName)
        相当于 removeAttribute(localName) 。
        Specified by:
        removeAttributeNS在界面 Element
        参数
        namespaceURI - 要删除的属性的名称空间URI。
        localName - 要删除的属性的本地名称。

      • getAttributeNodeNS

        public Attr getAttributeNodeNS​(String namespaceURI,
                               String localName)
        相当于 getAttributeNode(localName) 。
        Specified by:
        getAttributeNodeNS在界面 Element
        参数
        namespaceURI - 要检索的属性的名称空间URI。
        localName - 要检索的属性的本地名称。
        结果
        Attr节点具有指定的属性本地名称和名称空间URI或 null如果没有此类属性）。
        另请参见：
        setAttributeNodeNS(org.w3c.dom.Attr)

      • setAttributeNodeNS

        public Attr setAttributeNodeNS​(Attr newAttr)
        相当于 setAttributeNode(newAttr) 。
        Specified by:
        setAttributeNodeNS在界面 Element
        参数
        newAttr - 要添加到属性列表的 Attr节点。
        结果
        如果 newAttr属性使用相同的本地名称和名称空间URI替换现有属性，则返回替换的 Attr节点，否则返回 null 。
        另请参见：
        getAttributeNodeNS(java.lang.String, java.lang.String)

      • getElementsByTagNameNS

        public NodeList getElementsByTagNameNS​(String namespaceURI,
                                       String localName)
        相当于 getElementsByTagName(localName) 。
        Specified by:
        getElementsByTagNameNS在界面 Element
        参数
        namespaceURI - 要匹配的元素的名称空间URI。 特殊值“*”匹配所有名称空间。
        localName - 要匹配的元素的本地名称。 特殊值“*”匹配所有本地名称。
        结果
        一个新的 NodeList对象，包含所有匹配的 Elements 。

      • hasAttributeNS

        public boolean hasAttributeNS​(String namespaceURI,
                              String localName)
        相当于 hasAttribute(localName) 。
        Specified by:
        hasAttributeNS在界面 Element
        参数
        namespaceURI - 要查找的属性的名称空间URI。
        localName - 要查找的属性的本地名称。
        结果
        true如果指定了具有给定本地名称和名称空间URI的属性，或者在此元素上具有默认值， false 。

      • setUserObject

        public void setUserObject​(Object userObject)
        设置与此节点关联的值。
        参数
        userObject - 用户 Object 。
        另请参见：
        getUserObject()

      • setIdAttribute

        public void setIdAttribute​(String name,
                           boolean isId)
                    throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        setIdAttribute在界面 Element
        参数
        name - 属性的名称。
        isId - 属性是否为类型ID。
        异常
        DOMException - 永远。

      • setIdAttributeNS

        public void setIdAttributeNS​(String namespaceURI,
                             String localName,
                             boolean isId)
                      throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        setIdAttributeNS在界面 Element
        参数
        namespaceURI - 属性的名称空间URI。
        localName - 属性的本地名称。
        isId - 属性是否为类型ID。
        异常
        DOMException - 永远。

      • setIdAttributeNode

        public void setIdAttributeNode​(Attr idAttr,
                               boolean isId)
                        throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        setIdAttributeNode在界面 Element
        参数
        idAttr - 属性节点。
        isId - 属性是否为类型ID。
        异常
        DOMException - 永远。

      • setUserData

        public Object setUserData​(String key,
                          Object data,
                          UserDataHandler handler)
                   throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        setUserData ，界面 Node
        参数
        key - 将对象关联到的键。
        data - 要与给定键关联的对象，或 null以删除与该键的任何现有关联。
        handler - 与该键关联的处理程序，或 null 。
        结果
        返回先前与此节点上给定键关联的 null如果没有，则返回 DOMUserData 。
        异常
        DOMException - 永远。

      • getUserData

        public Object getUserData​(String key)
                   throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        getUserData在界面 Node
        参数
        key - 与对象关联的键。
        结果
        返回与此节点上给定键关联的 null如果没有，则返回 DOMUserData 。
        异常
        DOMException - 永远。

      • getFeature

        public Object getFeature​(String feature,
                         String version)
                  throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        getFeature在界面 Node
        参数
        feature - 请求的功能的名称。 请注意，将忽略该特征名称前面的任何加号“+”，因为它在此方法的上下文中不重要。
        version - 这是要测试的功能的版本号。
        结果
        返回实现指定功能和版本（如果有）的专用API的对象，如果没有实现与该功能关联的接口的对象，则null 。 如果此方法返回的DOMObject实现了Node接口，则它必须委托给主核Node ，而不返回与主核Node不一致的结果，例如attributes，childNodes等。
        异常
        DOMException - 永远。

      • isSameNode

        public boolean isSameNode​(Node node)
                   throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        isSameNode在界面 Node
        参数
        node - 要测试的节点。
        结果
        返回 true如果节点是相同的， false否则。
        异常
        DOMException - 永远。

      • isEqualNode

        public boolean isEqualNode​(Node node)
                    throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        isEqualNode接口 Node
        参数
        node - 用于比较相等性的节点。
        结果
        返回 true如果节点相等， false否则。
        异常
        DOMException - 永远。

      • lookupNamespaceURI

        public String lookupNamespaceURI​(String prefix)
                          throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        lookupNamespaceURI在界面 Node
        参数
        prefix - 要查找的前缀。 如果此参数为null ，则该方法将返回默认名称空间URI（如果有）。
        结果
        如果未找到，则返回关联的命名空间URI或 null 。
        异常
        DOMException - 永远。

      • isDefaultNamespace

        public boolean isDefaultNamespace​(String namespaceURI)
                           throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        isDefaultNamespace在界面 Node
        参数
        namespaceURI - 要查找的名称空间URI。
        结果
        返回 true如果指定 namespaceURI是默认的命名空间， false否则。
        异常
        DOMException - 永远。

      • lookupPrefix

        public String lookupPrefix​(String namespaceURI)
                    throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        lookupPrefix在界面 Node
        参数
        namespaceURI - 要查找的名称空间URI。
        结果
        如果找到则返回关联的命名空间前缀，如果未找到，则返回null 。 如果多个前缀与名称空间前缀相关联，则返回的名称空间前缀与实现有关。
        异常
        DOMException - 永远。

      • setTextContent

        public void setTextContent​(String textContent)
                    throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        setTextContent ，界面 Node
        异常
        DOMException - 永远。

      • compareDocumentPosition

        public short compareDocumentPosition​(Node other)
                              throws DOMException
        IIOMetadataNode不支持此DOM Level 3方法，并将抛出 DOMException 。
        Specified by:
        compareDocumentPosition接口 Node
        参数
        other - 要与引用节点进行比较的节点。
        结果
        返回节点相对于参考节点的定位方式。
        异常
        DOMException - 永远。