モジュール java.desktop
パッケージ 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処理に使用することを想定していません。 特に、イメージ入出力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。

    • getParentNode

      public Node getParentNode()
      このノードの親を返します。 null値は、ノードが独自のツリーのルートであることを示します。 ノードを既存のツリーに追加するには、insertBefore、replaceChild、またはappendChildメソッドの1つを使用します。
      定義:
      getParentNode、インタフェース: Node
      戻り値:
      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()
      このノードの子をすべて含む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

    • getNamespaceURI

      public String getNamespaceURI() throws DOMException
      名前空間はサポートされないので、nullを返します。
      定義:
      getNamespaceURI、インタフェース: Node
      例外:
      DOMException

    • getPrefix

      public String getPrefix()
      名前空間はサポートされないので、nullを返します。
      定義:
      getPrefix、インタフェース: Node
      戻り値:
      null
      関連項目:
      setPrefix(java.lang.String)

    • 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。

    • 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
      この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 - 常に。