モジュール java.desktop
パッケージ javax.imageio.metadata

クラスIIOMetadataNode

  • すべての実装されたインタフェース:
    Element, Node, NodeList
    public class IIOMetadataNode
extends Object
implements Element, NodeList
    org.w3c.dom.Elementインタフェースを実装し、getUserObjectメソッドとsetUserObjectメソッドを介した外部オブジェクトのストレージを追加可能にする、メタデータ・ツリー内のノードを表すクラス。

    このクラスは、一般のXML処理に使用することを想定していません。 特に、イメージ入出力APIで作成されたElementノードは、Sunのorg.w3.dom APIの標準実装で作成されたノードと互換性がありません。 特に、実装は単純な使い方をするように調整されており、集中的な処理では十分に動作しない場合があります。

    この実装では名前空間は無視されます。 用語の「タグ名」と「ノード名」は、常に同義と見なされます。 ノート: DOM Level 3仕様では、Node、Element、およびAttrインタフェースに、IIOMetadataNode実装または仕様への値ではない新しいメソッドがいくつか追加されました。 IIOMetadataNode、またはIIOMetadataNodeから返されたAttrインスタンスでそのようなメソッドを呼び出すと、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()
        このノードに関連したノード名を返します。
        定義:
        getNodeName、インタフェースNode
        戻り値:
        Stringとしてのノード名。

      • getNodeValue

        public String getNodeValue()
        このノードに関連した値を返します。
        定義:
        getNodeValue、インタフェースNode
        戻り値:
        Stringとしてのノード値。

      • setNodeValue

        public void setNodeValue​(String nodeValue)
        このノードに関連したString値を設定します。
        定義:
        setNodeValue、インタフェースNode

      • getNodeType

        public short getNodeType()
        常にELEMENT_NODEであるノードの型を返します。
        定義:
        getNodeType、インタフェースNode
        戻り値:
        short値のELEMENT_NODE。

      • getChildNodes

        public NodeList getChildNodes()
        このノードの子をすべて含むNodeListを返します。 子が存在しない場合は、ノードが含まれていないNodeListになります。
        定義:
        getChildNodes、インタフェースNode
        戻り値:
        NodeListとしての子。

      • getFirstChild

        public Node getFirstChild()
        このノードの最初の子を返します。ノードに子がない場合はnullを返します。
        定義:
        getFirstChild、インタフェースNode
        戻り値:
        Nodeとしての最初の子、またはnull

      • getLastChild

        public Node getLastChild()
        このノードの最後の子を返します。ノードに子がない場合はnullを返します。
        定義:
        getLastChild、インタフェースNode
        戻り値:
        Nodeとしての最後の子、またはnull。

      • getPreviousSibling

        public Node getPreviousSibling()
        このノードの前の兄弟ウィジェットを返します。このノードに前の兄弟ウィジェットがない場合はnullを返します。
        定義:
        getPreviousSibling、インタフェースNode
        戻り値:
        Nodeとしての前の兄弟ウィジェット、またはnull。

      • getNextSibling

        public Node getNextSibling()
        このノードの次の兄弟ウィジェットを返します。このノードに次の兄弟ウィジェットがない場合はnullを返します。
        定義:
        getNextSibling、インタフェースNode
        戻り値:
        Nodeとしての次の兄弟ウィジェット、またはnull。

      • getAttributes

        public NamedNodeMap getAttributes()
        このノードの属性を含むNamedNodeMapを返します。
        定義:
        getAttributes、インタフェースNode
        戻り値:
        このノードの属性を含むNamedNodeMap。

      • getOwnerDocument

        public Document getOwnerDocument()
        IIOMetadataNodeはどのDocumentにも属していないので、nullを返します。
        定義:
        getOwnerDocument、インタフェースNode
        戻り値:
        null。

      • insertBefore

        public Node insertBefore​(Node newChild,
                         Node refChild)
        既存のrefChild子ノードの前にnewChildノードを挿入します。 refChildがnullの場合は、子のリストの最後にnewChildを挿入します。
        定義:
        insertBefore、インタフェースNode
        パラメータ:
        newChild - 挿入するNode。
        refChild - 参照Node。
        戻り値:
        挿入されるノード。
        例外:
        IllegalArgumentException - newChildがnullの場合。

      • replaceChild

        public Node replaceChild​(Node newChild,
                         Node oldChild)
        子リストの中の子ノードoldChildをnewChildで置き換え、oldChildノードを返します。
        定義:
        replaceChild、インタフェースNode
        パラメータ:
        newChild - 挿入するNode。
        oldChild - 置換されるNode。
        戻り値:
        置換されたノード。
        例外:
        IllegalArgumentException - newChildがnullの場合。

      • removeChild

        public Node removeChild​(Node oldChild)
        子リストからoldChildで示される子ノードを削除し、この子ノードを返します。
        定義:
        removeChild、インタフェースNode
        パラメータ:
        oldChild - 削除されるNode。
        戻り値:
        削除されたノード
        例外:
        IllegalArgumentException - oldChildがnullの場合。

      • appendChild

        public Node appendChild​(Node newChild)
        ノードnewChildをこのノードの子のリストの末尾に追加します。
        定義:
        appendChild、インタフェースNode
        パラメータ:
        newChild - 挿入するNode。
        戻り値:
        追加されたノード
        例外:
        IllegalArgumentException - newChildがnullの場合。

      • hasChildNodes

        public boolean hasChildNodes()
        このノードに子ノードがある場合はtrueを返します。
        定義:
        hasChildNodes、インタフェースNode
        戻り値:
        このノードに子がある場合はtrue。

      • cloneNode

        public Node cloneNode​(boolean deep)
        このノードの複製を返します。 複製ノードには親がありません(getParentNodeはnullを返します)。 シャロー複製を実行すると(deepはfalse)、新しいノードには子や兄弟ウィジェットがありません。 ディープ複製を実行すると、新しいノードは完全に複製されたサブツリーのルートを形成します。
        定義:
        cloneNode、インタフェースNode
        パラメータ:
        deep - trueの場合は、指定されたノードの下にサブツリーを再帰的に複製し、falseの場合は、ノード自体だけを複製する。
        戻り値:
        複製されたノード。

      • normalize

        public void normalize()
        IIOMetadataNodeには子Textが格納されないので、何も実行しません。
        定義:
        normalize、インタフェースNode

      • isSupported

        public boolean isSupported​(String feature,
                           String version)
        DOM機能はサポートされていないので、falseを返します。
        定義:
        isSupported、インタフェースNode
        パラメータ:
        feature - String (無視されます)。
        version - String (無視されます)。
        戻り値:
        false

      • setPrefix

        public void setPrefix​(String prefix)
        名前空間はサポートされないので、何も実行しません。
        定義:
        setPrefix、インタフェースNode
        パラメータ:
        prefix - String (無視されます)。
        関連項目:
        getPrefix()

      • getLocalName

        public String getLocalName()
        getNodeNameと同等です。
        定義:
        getLocalName、インタフェースNode
        戻り値:
        Stringとしてのノード名。

      • getTagName

        public String getTagName()
        getNodeNameと同等です。
        定義:
        getTagName、インタフェースElement
        戻り値:
        Stringとしてのノード名

      • getAttribute

        public String getAttribute​(String name)
        名前を指定して属性を取得します。
        定義:
        getAttribute、インタフェースElement
        パラメータ:
        name - 取得する属性の名前。
        戻り値:
        文字列で表現されたAttrの値。その属性が指定された値またはデフォルト値を持たない場合は空文字列。

      • getAttributeNS

        public String getAttributeNS​(String namespaceURI,
                             String localName)
        getAttribute(localName)と同等です。
        定義:
        getAttributeNS、インタフェースElement
        パラメータ:
        namespaceURI - 取得する属性の名前空間URI。
        localName - 取得する属性のローカル名。
        戻り値:
        文字列で表現されたAttrの値。その属性が指定された値またはデフォルト値を持たない場合は空文字列。
        関連項目:
        setAttributeNS(java.lang.String, java.lang.String, java.lang.String)

      • setAttributeNS

        public void setAttributeNS​(String namespaceURI,
                           String qualifiedName,
                           String value)
        setAttribute(qualifiedName, value)と同等です。
        定義:
        setAttributeNS、インタフェースElement
        パラメータ:
        namespaceURI - 作成または変更する属性の名前空間URI。
        qualifiedName - 作成または変更する属性の修飾名。
        value - 設定する値を表す文字列。
        関連項目:
        getAttributeNS(java.lang.String, java.lang.String)

      • removeAttributeNS

        public void removeAttributeNS​(String namespaceURI,
                              String localName)
        removeAttribute(localName)と同等です。
        定義:
        removeAttributeNS、インタフェースElement
        パラメータ:
        namespaceURI - 削除する属性の名前空間URI。
        localName - 削除する属性のローカル名。

      • getAttributeNodeNS

        public Attr getAttributeNodeNS​(String namespaceURI,
                               String localName)
        getAttributeNode(localName)と同等です。
        定義:
        getAttributeNodeNS、インタフェースElement
        パラメータ:
        namespaceURI - 取得する属性の名前空間URI。
        localName - 取得する属性のローカル名。
        戻り値:
        指定された属性ローカル名と名前空間URIを持つAttrノード。このような属性が存在しない場合はnull。
        関連項目:
        setAttributeNodeNS(org.w3c.dom.Attr)

      • setAttributeNodeNS

        public Attr setAttributeNodeNS​(Attr newAttr)
        setAttributeNode(newAttr)と同等です。
        定義:
        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)と同等です。
        定義:
        getElementsByTagNameNS、インタフェースElement
        パラメータ:
        namespaceURI - 一致する要素の名前空間URI。 特殊な値「*」はすべての名前空間に一致する。
        localName - 一致する要素のローカル名。 特殊な値「*」はすべてのローカル名に一致する。
        戻り値:
        一致するすべてのElementsを含む新しいNodeListオブジェクト。

      • hasAttributeNS

        public boolean hasAttributeNS​(String namespaceURI,
                              String localName)
        hasAttribute(localName)と同等です。
        定義:
        hasAttributeNS、インタフェースElement
        パラメータ:
        namespaceURI - 検索する属性の名前空間URI。
        localName - 検索する属性のローカル名。
        戻り値:
        指定されたローカル名と名前空間URIを持つ属性が指定されているか、この要素上でデフォルト値を持っている場合はtrue。それ以外の場合はfalse。

      • setUserObject

        public void setUserObject​(Object userObject)
        このノードに関連した値を設定します。
        パラメータ:
        userObject - ユーザーObject。
        関連項目:
        getUserObject()

      • setIdAttribute

        public void setIdAttribute​(String name,
                           boolean isId)
                    throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        setIdAttribute、インタフェースElement
        パラメータ:
        name - 属性の名前。
        isId - 属性が型IDの属性であるかどうかを判定。
        例外:
        DOMException - 常に。

      • setIdAttributeNS

        public void setIdAttributeNS​(String namespaceURI,
                             String localName,
                             boolean isId)
                      throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        setIdAttributeNS、インタフェースElement
        パラメータ:
        namespaceURI - 属性の名前空間URI。
        localName - 属性のローカル名。
        isId - 属性が型IDの属性であるかどうかを判定。
        例外:
        DOMException - 常に。

      • setIdAttributeNode

        public void setIdAttributeNode​(Attr idAttr,
                               boolean isId)
                        throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        setIdAttributeNode、インタフェースElement
        パラメータ:
        idAttr - 属性ノード。
        isId - 属性が型IDの属性であるかどうかを判定。
        例外:
        DOMException - 常に。

      • getSchemaTypeInfo

        public TypeInfo getSchemaTypeInfo()
                           throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        getSchemaTypeInfo、インタフェースElement
        例外:
        DOMException - 常に。

      • setUserData

        public Object setUserData​(String key,
                          Object data,
                          UserDataHandler handler)
                   throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        setUserData、インタフェースNode
        パラメータ:
        key - オブジェクトを関連付けるキー。
        data - 指定されたキーに関連付けるオブジェクト。そのキーへの既存の関連付けをすべて削除する場合はnull。
        handler - そのキーに関連付けるハンドラ、またはnull。
        戻り値:
        このノード上で指定されたキーに以前に関連付けられていたDOMUserDataを返す。何も関連付けられていなかった場合はnull。
        例外:
        DOMException - 常に。

      • getUserData

        public Object getUserData​(String key)
                   throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        getUserData、インタフェースNode
        パラメータ:
        key - オブジェクトが関連付けられているキー。
        戻り値:
        このノード上で指定されたキーに関連付けられているDOMUserDataを返す。何も関連付けられていなかった場合はnull。
        例外:
        DOMException - 常に。

      • getFeature

        public Object getFeature​(String feature,
                         String version)
                  throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        getFeature、インタフェースNode
        パラメータ:
        feature - 要求された機能の名前。 機能名の前に追加されるプラス記号「+」は、このメソッドのコンテキストでは有意ではないので無視される。
        version - テストする機能のバージョン番号。
        戻り値:
        指定された機能とバージョンの特殊なAPIを実装するオブジェクト(存在する場合)を返します。指定された機能に関連付けられたインタフェースを実装するオブジェクトがない場合はnullを返します。 このメソッドによって返されたDOMObjectがNodeインタフェースを実装する場合は、主要コアNodeに委譲し、attributesやchildNodesなどの主要コアNodeと整合性のない結果を返さないようにする必要がある。
        例外:
        DOMException - 常に。

      • isSameNode

        public boolean isSameNode​(Node node)
                   throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        isSameNode、インタフェースNode
        パラメータ:
        node - テスト対象のノード。
        戻り値:
        ノードが同じである場合はtrueを、それ以外の場合はfalseを返す。
        例外:
        DOMException - 常に。

      • isEqualNode

        public boolean isEqualNode​(Node node)
                    throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        isEqualNode、インタフェースNode
        パラメータ:
        node - 同等性を比較する対象のノード。
        戻り値:
        ノードが同等である場合はtrueを、それ以外の場合はfalseを返す。
        例外:
        DOMException - 常に。

      • lookupNamespaceURI

        public String lookupNamespaceURI​(String prefix)
                          throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        lookupNamespaceURI、インタフェースNode
        パラメータ:
        prefix - 検索する接頭辞。 このパラメータがnullの場合、このメソッドはデフォルトの名前空間URI (存在する場合)を返す。
        戻り値:
        関連付けられた名前空間URIを返す。見つからなかった場合はnullを返す。
        例外:
        DOMException - 常に。

      • isDefaultNamespace

        public boolean isDefaultNamespace​(String namespaceURI)
                           throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        isDefaultNamespace、インタフェースNode
        パラメータ:
        namespaceURI - 検索する名前空間URI。
        戻り値:
        指定されたnamespaceURIがデフォルトの名前空間である場合はtrueを、それ以外の場合はfalseを返す。
        例外:
        DOMException - 常に。

      • lookupPrefix

        public String lookupPrefix​(String namespaceURI)
                    throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        lookupPrefix、インタフェースNode
        パラメータ:
        namespaceURI - 検索する名前空間URI。
        戻り値:
        見つかった場合は関連付けられた名前空間接頭辞を返す。見つからなかった場合はnullを返す。 複数の接頭辞が名前空間接頭辞に関連付けられている場合、返される名前空間接頭辞は実装に応じて異なる。
        例外:
        DOMException - 常に。

      • getTextContent

        public String getTextContent()
                      throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        getTextContent、インタフェースNode
        例外:
        DOMException - 常に。

      • setTextContent

        public void setTextContent​(String textContent)
                    throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        setTextContent、インタフェースNode
        例外:
        DOMException - 常に。

      • compareDocumentPosition

        public short compareDocumentPosition​(Node other)
                              throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        compareDocumentPosition、インタフェースNode
        パラメータ:
        other - 参照ノードと比較するノード。
        戻り値:
        参照ノードに対してノードの相対的な位置を決める方法。
        例外:
        DOMException - 常に。

      • getBaseURI

        public String getBaseURI()
                  throws DOMException
        このDOM Level 3メソッドはIIOMetadataNodeではサポートされていないため、DOMExceptionがスローされます。
        定義:
        getBaseURI、インタフェースNode
        例外:
        DOMException - 常に。