模块  java.desktop

Class IIOMetadataNode

  • 实现的所有接口
    ElementNodeNodeList

    public class IIOMetadataNode
    extends Object
    implements Element, NodeList
    表示元数据树中的节点的类,它实现org.w3c.dom.Element接口,并且还允许通过getUserObjectsetUserObject方法存储非文本对象。

    此类不适用于常规XML处理。 特别是,在Image I / O API中创建的Element节点与Sun的org.w3.dom API标准实现创建的节点不兼容。 特别是,该实现被调整用于简单的用途,并且可能不能用于密集处理。

    在此实现中忽略命名空间。 术语“标签名称”和“节点名称”始终被视为同义词。 注:DOM Level 3的规格增加了一些新的方法到NodeElementAttr是有价值的不是接口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 如果refChildnullnewChild在子项列表的末尾插入newChild
        Specified by:
        insertBefore接口 Node
        参数
        newChild - 要插入的 Node
        refChild - 参考 Node
        结果
        正在插入的节点。
        异常
        IllegalArgumentException - 如果 newChildnull
      • replaceChild

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

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

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

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

        public Node cloneNode​(boolean deep)
        返回此节点的副本。 重复节点没有父节点( getParentNode返回null )。 如果正在执行浅层克隆( deepfalse ),则新节点将不会有任何子节点或兄弟节点。 如果正在执行深度克隆,则新节点将形成完整克隆子树的根。
        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 - 永远。