Node (Java Platform SE 7)

既知のすべてのサブインタフェース:: Attr, CDATASection, CharacterData, Comment, Detail, DetailEntry, Document, DocumentFragment, DocumentType, Element, Entity, EntityReference, Node, Notation, ProcessingInstruction, SOAPBody, SOAPBodyElement, SOAPElement, SOAPEnvelope, SOAPFault, SOAPFaultElement, SOAPHeader, SOAPHeaderElement, Text, Text

既知のすべての実装クラス:: IIOMetadataNode, SOAPPart

public interface Node

Node インタフェースは Document Object Model 全体の主要なデータ型です。これはドキュメントツリーの単一のノードを表します。Node インタフェースを実装するすべてのオブジェクトが子を処理するためのメソッドを公開していますが、Node インタフェースを実装するすべてのオブジェクトが子を持てるわけではありません。たとえば、Text ノードは子を持つことができないため、このようなノードに子を追加すると DOMException が発生します。

nodeName、nodeValue、attributes の各属性は、特定の派生インタフェースにとらわれずにノード情報を取得するメカニズムとして含まれています。これらの属性の特定の nodeType への明確なマッピング (たとえば、Element への nodeValue や Comment への attributes) が存在しない場合は null を返します。各種専用インタフェースは、これ以外にも、関連情報を取得および設定する便利なメカニズムを多数備えています。

nodeName、nodeValue、および attributes の値は、次のようにノード型によって異なります。

インタフェース	nodeName	nodeValue	attributes
`Attr`	`Attr.name` と同じ	`Attr.value` と同じ	`null`
`CDATASection`	`"#cdata-section"`	`CharacterData.data` (CDATA セクションの内容) と同じ	`null`
`Comment`	`"#comment"`	`CharacterData.data` (コメントの内容) と同じ	`null`
`Document`	`"#document"`	`null`	`null`
`DocumentFragment`	`"#document-fragment"`	`null`	`null`
`DocumentType`	`DocumentType.name` と同じ	`null`	`null`
`Element`	`Element.tagName` と同じ	`null`	`NamedNodeMap`
`Entity`	エンティティー名	`null`	`null`
`EntityReference`	参照されるエンティティーの名前	`null`	`null`
`Notation`	表記法名	`null`	`null`
`ProcessingInstruction`	`ProcessingInstruction.target` と同じ	`ProcessingInstruction.data` と同じ	`null`
`Text`	`"#text"`	`CharacterData.data` (テキストノードの内容) と同じ	`null`

「Document Object Model (DOM) Level 3 Core Specification」も参照してください。

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static short`	`ATTRIBUTE_NODE` ノードは `Attr` です。
`static short`	`CDATA_SECTION_NODE` ノードは `CDATASection` です。
`static short`	`COMMENT_NODE` ノードは `Comment` です。
`static short`	`DOCUMENT_FRAGMENT_NODE` ノードは `DocumentFragment` です。
`static short`	`DOCUMENT_NODE` ノードは `Document` です。
`static short`	`DOCUMENT_POSITION_CONTAINED_BY` ノードは参照ノードに含まれています。
`static short`	`DOCUMENT_POSITION_CONTAINS` ノードは参照ノードを含みます。
`static short`	`DOCUMENT_POSITION_DISCONNECTED` 2 つのノードは切断されます。
`static short`	`DOCUMENT_POSITION_FOLLOWING` ノードは参照ノードのあとに続きます。
`static short`	`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC` 先行するかあとにくるかは実装に固有です。
`static short`	`DOCUMENT_POSITION_PRECEDING` 2 番目のノードは参照ノードの前にあります。
`static short`	`DOCUMENT_TYPE_NODE` ノードは `DocumentType` です。
`static short`	`ELEMENT_NODE` ノードは `Element` です。
`static short`	`ENTITY_NODE` ノードは `Entity` です。
`static short`	`ENTITY_REFERENCE_NODE` ノードは `EntityReference` です。
`static short`	`NOTATION_NODE` ノードは `Notation` です。
`static short`	`PROCESSING_INSTRUCTION_NODE` ノードは `ProcessingInstruction` です。
`static short`	`TEXT_NODE` ノードは `Text` ノードです。

メソッドのサマリー

メソッド
修飾子と型	メソッドと説明
`Node`	`appendChild(Node newChild)` ノード `newChild` をこのノードの子のリストの末尾に追加します。
`Node`	`cloneNode(boolean deep)` ノードのジェネリックコピーコンストラクタとして、このノードの複製を返します。
`short`	`compareDocumentPosition(Node other)` 参照ノードを比較します。
`NamedNodeMap`	`getAttributes()` このノードが `Element` の場合、このノードの属性を含む `NamedNodeMap`。それ以外の場合は `null`。
`String`	`getBaseURI()` このノードの絶対ベース URI。実装が絶対 URI を取得できなかった場合は `null`。
`NodeList`	`getChildNodes()` このノードの子をすべて含む `NodeList`。
`Object`	`getFeature(String feature, String version)` このメソッドは、指定した機能とバージョンを持つ特殊な形式の API を指定されたとおりに実装する特殊な形式のオブジェクトを返します。
`Node`	`getFirstChild()` このノードの最初の子ノードです。
`Node`	`getLastChild()` このノードの最後の子ノードです。
`String`	`getLocalName()` このノードの修飾名のローカル部分を返します。
`String`	`getNamespaceURI()` このノードの名前空間 URI。未指定の場合は `null`。
`Node`	`getNextSibling()` このノードの直後のノードです。
`String`	`getNodeName()` このノードの名前です。この名前は型によって異なります。上記の表を参照してください。
`short`	`getNodeType()` オブジェクトの型を表すコードです。上記の定義を参照してください。
`String`	`getNodeValue()` このノードの値です。この値は型によって異なります。前述の表を参照してください。
`Document`	`getOwnerDocument()` このノードに関連付けられた `Document` オブジェクト。
`Node`	`getParentNode()` このノードの親ノードです。
`String`	`getPrefix()` このノードの名前空間接頭辞です。未指定の場合は `null` になります。
`Node`	`getPreviousSibling()` このノードの直前のノードです。
`String`	`getTextContent()` この属性は、指定されたノードとノードの子孫のテキストコンテンツを返します。
`Object`	`getUserData(String key)` このノードのキーに関連付けられたオブジェクトを取得します。
`boolean`	`hasAttributes()` このノードが要素である場合、属性を持っているかどうかを判断します。
`boolean`	`hasChildNodes()` このノードが子ノードを持っているかどうかを判断します。
`Node`	`insertBefore(Node newChild, Node refChild)` 既存の `refChild` 子ノードの前に `newChild` ノードを挿入します。
`boolean`	`isDefaultNamespace(String namespaceURI)` このメソッドは、指定された `namespaceURI` がデフォルトの名前空間であるかどうかをチェックします。
`boolean`	`isEqualNode(Node arg)` 2 つのノードが等しいかどうかをテストします。
`boolean`	`isSameNode(Node other)` このノードが指定されたノードと同じノードであるかどうかを返します。
`boolean`	`isSupported(String feature, String version)` DOM 実装が特定の機能を実装しており、このノードがその機能を指定されたとおりにサポートしているかどうかを判定します。
`String`	`lookupNamespaceURI(String prefix)` 指定したノードから開始して、所定の接頭辞に関連する名前空間 URI を検索します。
`String`	`lookupPrefix(String namespaceURI)` 指定されたノードから開始して、所定の名前空間 URI に関連する接頭辞を検索します。
`void`	`normalize()` この `Node` のサブツリーの最深部までに存在するすべての `Text` ノード (属性ノードを含む) を、`Text` ノードが構造 (要素、コメント、処理命令、CDATA セクション、エンティティー参照など) のみによって分離される、「正規」形式にします。その結果、隣接する `Text` ノードも空の `Text` ノードも存在しない状態になります。
`Node`	`removeChild(Node oldChild)` 子リストから `oldChild` で示される子ノードを削除し、この子ノードを返します。
`Node`	`replaceChild(Node newChild, Node oldChild)` 子リストの中の子ノード `oldChild` を `newChild` で置き換え、`oldChild` ノードを返します。
`void`	`setNodeValue(String nodeValue)` このノードの値です。この値は型によって異なります。前述の表を参照してください。
`void`	`setPrefix(String prefix)` このノードの名前空間接頭辞です。未指定の場合は `null` になります。
`void`	`setTextContent(String textContent)` この属性は、指定されたノードとノードの子孫のテキストコンテンツを返します。
`Object`	`setUserData(String key, Object data, UserDataHandler handler)` このノードのキーにオブジェクトを関連付けます。

フィールドの詳細
- ELEMENT_NODE
```
static final short ELEMENT_NODE
```
  ノードは Element です。
  
  関連項目:
  定数フィールド値
- ATTRIBUTE_NODE
```
static final short ATTRIBUTE_NODE
```
  ノードは Attr です。
  
  関連項目:
  定数フィールド値
- TEXT_NODE
```
static final short TEXT_NODE
```
  ノードは Text ノードです。
  
  関連項目:
  定数フィールド値
- CDATA_SECTION_NODE
```
static final short CDATA_SECTION_NODE
```
  ノードは CDATASection です。
  
  関連項目:
  定数フィールド値
- ENTITY_REFERENCE_NODE
```
static final short ENTITY_REFERENCE_NODE
```
  ノードは EntityReference です。
  
  関連項目:
  定数フィールド値
- ENTITY_NODE
```
static final short ENTITY_NODE
```
  ノードは Entity です。
  
  関連項目:
  定数フィールド値
- PROCESSING_INSTRUCTION_NODE
```
static final short PROCESSING_INSTRUCTION_NODE
```
  ノードは ProcessingInstruction です。
  
  関連項目:
  定数フィールド値
- COMMENT_NODE
```
static final short COMMENT_NODE
```
  ノードは Comment です。
  
  関連項目:
  定数フィールド値
- DOCUMENT_NODE
```
static final short DOCUMENT_NODE
```
  ノードは Document です。
  
  関連項目:
  定数フィールド値
- DOCUMENT_TYPE_NODE
```
static final short DOCUMENT_TYPE_NODE
```
  ノードは DocumentType です。
  
  関連項目:
  定数フィールド値
- DOCUMENT_FRAGMENT_NODE
```
static final short DOCUMENT_FRAGMENT_NODE
```
  ノードは DocumentFragment です。
  
  関連項目:
  定数フィールド値
- NOTATION_NODE
```
static final short NOTATION_NODE
```
  ノードは Notation です。
  
  関連項目:
  定数フィールド値
- DOCUMENT_POSITION_DISCONNECTED
```
static final short DOCUMENT_POSITION_DISCONNECTED
```
  2 つのノードは切断されます。切断されたノードの順序は、常に実装に固有の順序です。
  
  関連項目:
  定数フィールド値
- DOCUMENT_POSITION_PRECEDING
```
static final short DOCUMENT_POSITION_PRECEDING
```
  2 番目のノードは参照ノードの前にあります。
  
  関連項目:
  定数フィールド値
- DOCUMENT_POSITION_FOLLOWING
```
static final short DOCUMENT_POSITION_FOLLOWING
```
  ノードは参照ノードのあとに続きます。
  
  関連項目:
  定数フィールド値
- DOCUMENT_POSITION_CONTAINS
```
static final short DOCUMENT_POSITION_CONTAINS
```
  ノードは参照ノードを含みます。含むノードは、常に参照ノードに先行します。
  
  関連項目:
  定数フィールド値
- DOCUMENT_POSITION_CONTAINED_BY
```
static final short DOCUMENT_POSITION_CONTAINED_BY
```
  ノードは参照ノードに含まれています。含まれるノードは、常に参照ノードのあとに続きます。
  
  関連項目:
  定数フィールド値
- DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
```
static final short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
```
  先行するかあとにくるかは実装に固有です。
  
  関連項目:
  定数フィールド値

メソッドの詳細

getNodeName
```
String getNodeName()
```
このノードの名前です。この名前は型によって異なります。上記の表を参照してください。

getNodeValue
```
String getNodeValue()
                    throws DOMException
```
このノードの値です。この値は型によって異なります。前述の表を参照してください。null と定義されている場合、ノードが読み取り専用である場合を含めて、設定は何も影響を与えません。

例外:

DOMException - DOMSTRING_SIZE_ERR: 実装プラットフォームの DOMString 変数に収まらない多数の文字を返す場合に発生します。

setNodeValue
```
void setNodeValue(String nodeValue)
                  throws DOMException
```
このノードの値です。この値は型によって異なります。前述の表を参照してください。null と定義されている場合、ノードが読み取り専用である場合を含めて、設定は何も影響を与えません。

例外:

DOMException - NO_MODIFICATION_ALLOWED_ERR: ノードが読み取り専用の場合、および null であると定義されていない場合に発生します。

getNodeType
```
short getNodeType()
```
オブジェクトの型を表すコードです。上記の定義を参照してください。

getParentNode
```
Node getParentNode()
```
このノードの親ノードです。Attr、Document、DocumentFragment、Entity、および Notation を除くすべてのノードは、親ノードを持つ可能性があります。ただし、ノードが作成されたばかりでまだツリーに追加されていない場合や、ツリーから削除された場合は null になります。

getChildNodes
```
NodeList getChildNodes()
```
このノードの子をすべて含む NodeList。子が存在しない場合は、ノードが含まれていない NodeList になります。

getFirstChild
```
Node getFirstChild()
```
このノードの最初の子ノードです。該当するノードが存在しない場合は null が返されます。

getLastChild
```
Node getLastChild()
```
このノードの最後の子ノードです。該当するノードが存在しない場合は null が返されます。

getPreviousSibling
```
Node getPreviousSibling()
```
このノードの直前のノードです。該当するノードが存在しない場合は null が返されます。

getNextSibling
```
Node getNextSibling()
```
このノードの直後のノードです。該当するノードが存在しない場合は null が返されます。

getAttributes
```
NamedNodeMap getAttributes()
```
このノードが Element の場合、このノードの属性を含む NamedNodeMap。それ以外の場合は null。

getOwnerDocument
```
Document getOwnerDocument()
```
このノードに関連付けられた Document オブジェクト。これはまた、新しいノードを作成するために使用される Document オブジェクトでもあります。このノードが、まだどの Document でも使用されていない Document または DocumentType である場合は、null になります。

導入されたバージョン:

DOM Level 2

insertBefore
```
Node insertBefore(Node newChild,
                Node refChild)
                  throws DOMException
```
既存の refChild 子ノードの前に newChild ノードを挿入します。refChild が null の場合は、子のリストの最後に newChild を挿入します。
newChild が DocumentFragment オブジェクトである場合は、そのすべての子が同じ順序で refChild の前に挿入されます。newChild がツリー内にすでに存在する場合、最初に既存のものが削除されます。
注: ノードのそのノード自体の前への挿入は実装に依存します。

パラメータ:
newChild - 挿入するノード。
refChild - 参照ノード、新しいノードはこのノードの直前に挿入される。

戻り値:
挿入されたノード。

例外:

DOMException - HIERARCHY_REQUEST_ERR: このノードが newChild ノードの型の子を許可しない型のノードである場合、挿入するノードがこのノードの先祖のいずれかまたはこのノード自体である場合、またはこのノードが Document 型であり、かつ DOM アプリケーションが 2 番目の DocumentType または Element ノードを挿入しようとした場合に発生します。
WRONG_DOCUMENT_ERR: newChild がこのノードを作成した文書とは異なる文書から作成された場合に発生します。
NO_MODIFICATION_ALLOWED_ERR:このノードが読み取り専用であるか、挿入されるノードの親が読み取り専用である場合に発生します。
NOT_FOUND_ERR: refChild がこのノードの子でない場合に発生します。
NOT_SUPPORTED_ERR: このノードが Document 型の場合、この例外は、DOM 実装が DocumentType または Element ノードの挿入をサポートしていない場合に発生する可能性があります。
導入されたバージョン:

DOM Level 3

replaceChild
```
Node replaceChild(Node newChild,
                Node oldChild)
                  throws DOMException
```
子リストの中の子ノード oldChild を newChild で置き換え、oldChild ノードを返します。
newChild が DocumentFragment オブジェクトである場合、oldChild は DocumentFragment のすべての子に置き換えられます。これらの子は、同じ順序で挿入されます。newChild がツリー内にすでに存在する場合、最初に既存のものが削除されます。
注: ノードのそのノード自体への置き換えは実装に依存します。

パラメータ:
newChild - 子リストに挿入する新しいノード。
oldChild - リスト内の置き換えられるノード。

戻り値:
置き換えられたノード。

例外:

DOMException - HIERARCHY_REQUEST_ERR: このノードが newChild ノードの型の子を許可しない型のノードである場合、挿入するノードがこのノードの先祖のいずれかまたはこのノード自体である場合、またはこのノードが Document 型であり、かつ置換操作の結果として Document ノードに 2 番目の DocumentType または Element が追加される場合に発生します。
WRONG_DOCUMENT_ERR: newChild がこのノードを作成した文書とは異なる文書から作成された場合に発生します。
NO_MODIFICATION_ALLOWED_ERR:このノードが読み取り専用であるか、新しいノードの親が読み取り専用である場合に発生します。
NOT_FOUND_ERR: oldChild がこのノードの子でない場合に発生します。
NOT_SUPPORTED_ERR: このノードが Document 型である場合、この例外は、DOM 実装が DocumentType の子または Element の子の置換をサポートしていない場合に発生する可能性があります。
導入されたバージョン:

DOM Level 3

removeChild
```
Node removeChild(Node oldChild)
                 throws DOMException
```
子リストから oldChild で示される子ノードを削除し、この子ノードを返します。

パラメータ:
oldChild - 削除されるノード。

戻り値:
削除されたノード。

例外:

DOMException - NO_MODIFICATION_ALLOWED_ERR:このノードが読み取り専用の場合に発生します。
NOT_FOUND_ERR: oldChild がこのノードの子でない場合に発生します。
NOT_SUPPORTED_ERR: このノードが Document 型である場合、この例外は、DOM 実装が DocumentType の子または Element の子の削除をサポートしていない場合に発生する可能性があります。
導入されたバージョン:

DOM Level 3

appendChild
```
Node appendChild(Node newChild)
                 throws DOMException
```
ノード newChild をこのノードの子のリストの末尾に追加します。newChild がツリー内にすでに存在する場合、最初に既存のものが削除されます。

パラメータ:
newChild - 追加するノード。これが DocumentFragment オブジェクトである場合は、文書フラグメントのコンテンツ全体がこのノードの子リストに移動される

戻り値:
追加されたノード。

例外:

DOMException - HIERARCHY_REQUEST_ERR: このノードが newChild ノードの型の子を許可しない型のノードである場合、追加するノードがこのノードの先祖のいずれかまたはこのノード自体である場合、またはこのノードが Document 型であり、かつ DOM アプリケーションが 2 番目の DocumentType または Element ノードを追加しようとした場合に発生します。
WRONG_DOCUMENT_ERR: newChild がこのノードを作成した文書とは異なる文書から作成された場合に発生します。
NO_MODIFICATION_ALLOWED_ERR:このノードが読み取り専用であるか、挿入されるノードの以前の親が読み取り専用である場合に発生する。
NOT_SUPPORTED_ERR: newChild ノードが Document ノードの子である場合、この例外は、DOM 実装が DocumentType の子または Element の子の削除をサポートしていない場合に発生する可能性があります。
導入されたバージョン:

DOM Level 3

hasChildNodes
```
boolean hasChildNodes()
```
このノードが子ノードを持っているかどうかを判断します。

戻り値:
このノードに子がある場合は true を、それ以外の場合は false を返す。

cloneNode
```
Node cloneNode(boolean deep)
```
ノードのジェネリックコピーコンストラクタとして、このノードの複製を返します。複製ノードには親がなく (parentNode は null)、ユーザーデータもありません。インポートされているノードに関連するユーザーデータは持ち越されません。ただし、関連するデータとともに UserDataHandlers が指定された場合は、このメソッドから戻る前に、それらのハンドラが該当するパラメータで呼び出されます。
Element を複製すると、デフォルトの属性を表すためにすべての属性とその値 (XML プロセッサによって生成されたものを含む) がコピーされますが、これが深い複製でないかぎり、このメソッドではそこに含まれている子はコピーされません。テキストは子の Text ノードに含まれているため、これには Element に含まれているテキストが含まれます。Element の複製操作の一部として複製するのではなく、直接 Attr を複製すると、指定された属性が返されます (specified は true)。Attr を複製すると、常にその子が複製されます。それは、これが深い複製かどうかにかかわらず、それらの子がその値を表すためです。EntityReference を複製すると、これが深い複製かどうかにかかわらず、対応する Entity が使用可能な場合はそのサブツリーが自動的に構築されます。別の型のノードを複製すると、このノードのコピーが返されます。
不変のサブツリーを複製すると可変のコピーが作成されますが、EntityReference の複製の子は読み取り専用になります。さらに、未指定の Attr ノードの複製が指定されます。また、Document、DocumentType、Entity、および Notation ノードの複製は実装に依存します。

パラメータ:
deep - true の場合は指定されたノードの下のサブツリーを再帰的に複製し、false の場合は指定されたノードのみを (これが Element である場合はその属性も) 複製する。

戻り値:
複製ノード。

normalize
```
void normalize()
```
この Node のサブツリーの最深部までに存在するすべての Text ノード (属性ノードを含む) を、Text ノードが構造 (要素、コメント、処理命令、CDATA セクション、エンティティー参照など) のみによって分離される、「正規」形式にします。その結果、隣接する Text ノードも空の Text ノードも存在しない状態になります。これは、文書の DOM ビューを保存後ロードし直した状態にすることができるという点で、特定の文書ツリー構造に依存する操作 (XPointer「XPointer」ルックアップなどの) を使用する必要がある場合に便利です。Node.ownerDocument に接続された DOMConfiguration オブジェクトの「normalize-characters」パラメータが true の場合、このメソッドは、Text ノードの文字の完全な正規化も行います。
注: 文書に CDATASections が含まれている場合は、XPointers が Text ノードと CDATASection ノードを区別しないため、正規化操作だけでは十分でない可能性があります。

導入されたバージョン:

DOM Level 3

isSupported
```
boolean isSupported(String feature,
                  String version)
```
DOM 実装が特定の機能を実装しており、このノードがその機能を指定されたとおりにサポートしているかどうかを判定します。

パラメータ:
feature - テストする機能の名前。
version - テストする機能のバージョン番号。

戻り値:
指定された機能がこのノードでサポートされている場合は true を、それ以外の場合は false を返す。
導入されたバージョン:

DOM Level 2

getNamespaceURI
```
String getNamespaceURI()
```
このノードの名前空間 URI。未指定の場合は null。
これは、スコープ内の名前空間宣言の検査に基づいた名前空間の検索の結果のような計算された値ではありません。これは単に作成時に与えられた URI 名前空間です。
ELEMENT_NODE および ATTRIBUTE_NODE 以外の型のノードと、Document.createElement() などの DOM レベル 1 メソッドで作成されたノードに対しては、常に null が返されます。
注: 「Namespaces in XML」仕様の「XML 名前空間」に従い、属性は、接続先の要素からその名前空間を継承しません。属性に対して明示的に名前空間を指定しないかぎり、その属性は名前空間を持たないことになります。

導入されたバージョン:

DOM Level 2

getPrefix
```
String getPrefix()
```
このノードの名前空間接頭辞です。未指定の場合は null になります。null と定義されている場合、ノードが読み取り専用である場合を含めて、設定は何も影響を与えません。
この属性を設定すると、許容される場合は、nodeName 属性が変更されます。この属性は、Element インタフェースと Attr インタフェースの tagName および name 属性とともに、修飾名を保持しています (それが適切な場合)。
接頭辞を null に設定すると、接頭辞は指定されません。また、空の文字列に設定することは実装依存です。
デフォルト値を持つ属性の接頭辞を変更すると、namespaceURI と localName がそのままなので、そのデフォルト値と元の接頭辞を持つ新しい属性は作成されません。
ELEMENT_NODE と ATTRIBUTE_NODE 以外の型のノードと、Document インタフェースの createElement のように DOM レベル 1 メソッドで作成されたノードに対しては、常に null が返されます。

導入されたバージョン:

DOM Level 2

setPrefix
```
void setPrefix(String prefix)
               throws DOMException
```
このノードの名前空間接頭辞です。未指定の場合は null になります。null と定義されている場合、ノードが読み取り専用である場合を含めて、設定は何も影響を与えません。
この属性を設定すると、許容される場合は、nodeName 属性が変更されます。この属性は、Element インタフェースと Attr インタフェースの tagName および name 属性とともに、修飾名を保持しています (それが適切な場合)。
接頭辞を null に設定すると、接頭辞は指定されません。また、空の文字列に設定することは実装依存です。
デフォルト値を持つ属性の接頭辞を変更すると、namespaceURI と localName がそのままなので、そのデフォルト値と元の接頭辞を持つ新しい属性は作成されません。
ELEMENT_NODE と ATTRIBUTE_NODE 以外の型のノードと、Document インタフェースの createElement のように DOM レベル 1 メソッドで作成されたノードに対しては、常に null が返されます。

例外:

DOMException - INVALID_CHARACTER_ERR: 指定された接頭辞に、Document.xmlVersion 属性で指定された使用中の XML バージョンで定められている不正な文字が含まれている場合に発生します。
NO_MODIFICATION_ALLOWED_ERR:このノードが読み取り専用の場合に発生します。
NAMESPACE_ERR: 指定された prefix の形式が「Namespaces in XML」仕様に従っていない場合、このノードの namespaceURI が null である場合、指定された接頭辞が「xml」であり、かつこのノードの namespaceURI が「http://www.w3.org/XML/1998/namespace」とは異なる場合、このノードが属性であり、指定された接頭辞が「xmlns」であり、かつこのノードの namespaceURI が「http://www.w3.org/2000/xmlns/」とは異なる場合、またはこのノードが属性であり、かつこのノードの qualifiedName が「xmlns」の「XML 名前空間」である場合に発生します。
導入されたバージョン:

DOM Level 2

getLocalName
```
String getLocalName()
```
このノードの修飾名のローカル部分を返します。
ELEMENT_NODE および ATTRIBUTE_NODE 以外の型のノードと、Document.createElement() などの DOM レベル 1 メソッドで作成されたノードに対しては、常に null が返されます。

導入されたバージョン:

DOM Level 2

hasAttributes
```
boolean hasAttributes()
```
このノードが要素である場合、属性を持っているかどうかを判断します。

戻り値:
このノードに属性がある場合は true を、それ以外の場合は false を返す。
導入されたバージョン:

DOM Level 2

getBaseURI
```
String getBaseURI()
```
このノードの絶対ベース URI。実装が絶対 URI を取得できなかった場合は null。この値は、説明に従って計算されます。ただし、Document が「HTML」機能の「DOM Level 2 HTML」をサポートしている場合、ベース URI はまず、HTML BASE 要素の href 属性の値が存在する場合はその値を、それ以外の場合は Document インタフェースの documentURI 属性の値を使用して計算されます。

導入されたバージョン:

DOM Level 3

compareDocumentPosition
```
short compareDocumentPosition(Node other)
                              throws DOMException
```
このメソッドが呼び出されている参照ノードを、パラメータとして渡されるノードと、文書内の位置に関して文書順に比較します。

パラメータ:
other - 参照ノードと比較するノード。

戻り値:
参照ノードに対してノードの相対的な位置を決める方法。

例外:

DOMException - NOT_SUPPORTED_ERR:比較されたノードが、一貫した実装固有の結果を返すようになっていない、異なる DOM 実装からのものである場合に発生する。
導入されたバージョン:

DOM Level 3

getTextContent

String getTextContent()
                      throws DOMException

この属性は、指定されたノードとノードの子孫のテキストコンテンツを返します。null に定義した場合、設定による影響はありません。設定時には、このノードが持つことができると考えられる子はすべて削除され、新しい文字列が空または null でない場合、この属性が設定されている文字列を含む単一の Text ノードに置き換えられます。
取得時には、直列化は行われず、返される文字列はマークアップを含みません。空白文字の正規化は行われず、返される文字列は要素コンテンツに空白文字を含みません (Text.isElementContentWhitespace 属性を参照)。同様に、設定では、解析も行われません。入力文字列は純粋なテキスト形式のコンテンツとして取得されます。
返される文字列は、次に示すようにノードの型に応じて、ノードのテキストコンテンツで構成されています。

ノード型	コンテンツ
ELEMENT_NODE、ATTRIBUTE_NODE、ENTITY_NODE、ENTITY_REFERENCE_NODE、DOCUMENT_FRAGMENT_NODE	COMMENT_NODE ノードと PROCESSING_INSTRUCTION_NODE ノードを除く、すべての子ノードの `textContent` 属性値の連結。ノードが子を持たない場合は、空の文字列。
TEXT_NODE、CDATA_SECTION_NODE、COMMENT_NODE、PROCESSING_INSTRUCTION_NODE	`nodeValue`
DOCUMENT_NODE、DOCUMENT_TYPE_NODE、NOTATION_NODE	null

例外:: DOMException - DOMSTRING_SIZE_ERR: 実装プラットフォームの DOMString 変数に収まらない多数の文字を返す場合に発生します。
導入されたバージョン:: DOM Level 3

setTextContent

void setTextContent(String textContent)
                    throws DOMException

ノード型	コンテンツ
ELEMENT_NODE、ATTRIBUTE_NODE、ENTITY_NODE、ENTITY_REFERENCE_NODE、DOCUMENT_FRAGMENT_NODE	COMMENT_NODE ノードと PROCESSING_INSTRUCTION_NODE ノードを除く、すべての子ノードの `textContent` 属性値の連結。ノードが子を持たない場合は、空の文字列。
TEXT_NODE、CDATA_SECTION_NODE、COMMENT_NODE、PROCESSING_INSTRUCTION_NODE	`nodeValue`
DOCUMENT_NODE、DOCUMENT_TYPE_NODE、NOTATION_NODE	null

例外:: DOMException - NO_MODIFICATION_ALLOWED_ERR:ノードが読み取り専用の場合に発生します。
導入されたバージョン:: DOM Level 3

isSameNode
```
boolean isSameNode(Node other)
```
このノードが指定されたノードと同じノードであるかどうかを返します。
このメソッドは、実装によって返された 2 つの Node 参照が同じオブジェクトを参照しているかどうかを判定するための方法を提供します。2 つの Node 参照が同じオブジェクトへの参照であるときは (プロキシ経由の場合であっても)、すべての属性が同じ値を持ち、同じ DOM メソッドをどちらの参照で呼び出しても常に正確に同じ効果が得られるように、これらの参照を完全に区別なく使用できます。

パラメータ:
other - テスト対象のノード。

戻り値:
ノードが同じである場合は true を、それ以外の場合は false を返す。
導入されたバージョン:

DOM Level 3

lookupPrefix
```
String lookupPrefix(String namespaceURI)
```
指定されたノードから開始して、所定の名前空間 URI に関連する接頭辞を検索します。このメソッドは、デフォルトの名前空間宣言を無視します。
このメソッドで使用されるアルゴリズムの詳細は、を参照してください。

パラメータ:
namespaceURI - 検索する名前空間 URI。

戻り値:
見つかった場合は関連付けられた名前空間接頭辞を返す。見つからなかった場合は null を返す。複数の接頭辞が名前空間接頭辞に関連付けられている場合、返される名前空間接頭辞は実装に応じて異なる。
導入されたバージョン:

DOM Level 3

isDefaultNamespace
```
boolean isDefaultNamespace(String namespaceURI)
```
このメソッドは、指定された namespaceURI がデフォルトの名前空間であるかどうかをチェックします。

パラメータ:
namespaceURI - 検索する名前空間 URI。

戻り値:
指定された namespaceURI がデフォルトの名前空間である場合は true を、それ以外の場合は false を返す。
導入されたバージョン:

DOM Level 3

lookupNamespaceURI
```
String lookupNamespaceURI(String prefix)
```
指定したノードから開始して、所定の接頭辞に関連する名前空間 URI を検索します。
このメソッドで使用されるアルゴリズムの詳細は、を参照してください。

パラメータ:
prefix - 検索する接頭辞。このパラメータが null の場合、このメソッドはデフォルトの名前空間 URI (存在する場合) を返す。

戻り値:
関連付けられた名前空間 URI を返す。見つからなかった場合は null を返す。
導入されたバージョン:

DOM Level 3

isEqualNode
```
boolean isEqualNode(Node arg)
```
2 つのノードが等しいかどうかをテストします。
このメソッドは、Node.isSameNode() でテストできる同一性 (つまり、2 つのノードが同じオブジェクトへの参照であるかどうか) ではなく、ノードの同等性をテストします。同じであるすべてのノードは同等でもありますが、その逆は必ずしも当てはまりません。
2 つのノードが同等であるのは、次の条件が満たされている場合のみです。
- 2 つのノードが同じ型のノードである。
- 文字列属性 nodeName、localName、namespaceURI、prefix、nodeValue が等しい。つまり、両方とも null であるか、または同じ長さを持ち、かつ文字と文字を比較したときに同一である。
- attributes NamedNodeMaps が等しい。つまり、両方とも null であるか、または同じ長さを持ち、1 つのマップに存在する各ノードに対してほかのマップに存在するノードがあり、等しいが、必ずしも同じインデックスにはない。
- childNodes NodeLists が等しい。つまり、両方とも null であるか、または同じ長さを持ち、同じインデックスに等しいノードを持つ。正規化は、同等性に影響を及ぼす可能性がある。この影響を避けるには、ノードを正規化してから比較を行う必要がある。
2 つの DocumentType ノードが同等であるには、次の条件も満たされている必要があります。
- 文字列属性 publicId、systemId、internalSubset が等しい。
- entities NamedNodeMaps が等しい。
- notations NamedNodeMaps が等しい。
その一方で、次のものは同等性に影響を与えません。ownerDocument、baseURI、parentNode の各属性、Attr ノードの specified 属性、Attr ノードと Element ノードの schemaTypeInfo 属性、Text ノードの Text.isElementContentWhitespace 属性、およびノードに登録されているすべてのユーザーデータまたはイベントリスナー。
注: 一般に、上の説明で挙げられていないものはどれも、同等性チェックの面で有意ではありません。この仕様の将来バージョンでは、より多くの属性を考慮し、この仕様に準拠する実装を適宜更新する予定です。
パラメータ:
arg - 同等性を比較する対象のノード。

戻り値:
ノードが同等である場合は true を、それ以外の場合は false を返す。
導入されたバージョン:

DOM Level 3

getFeature
```
Object getFeature(String feature,
                String version)
```
このメソッドは、指定した機能とバージョンを持つ特殊な形式の API を指定されたとおりに実装する特殊な形式のオブジェクトを返します。特殊な形式のオブジェクトは、バインディング固有のキャスティングメソッドを使用して取得することもできますが、必ずしも説明されているようにはいきません。このメソッドを使用すると、実装では Node インタフェースをサポートしない特殊な形式のオブジェクトを利用できます。

パラメータ:
feature - 要求された機能の名前。機能名の前に追加されるプラス記号「+」は、このメソッドのコンテキストでは有意ではないので無視される。
version - テストする機能のバージョン番号。

戻り値:
指定された機能とバージョンの特殊な API を実装するオブジェクト (存在する場合) を返します。指定された機能に関連付けられたインタフェースを実装するオブジェクトがない場合は null を返します。このメソッドによって返された DOMObject が Node インタフェースを実装する場合は、主要コア Node に委譲し、attributes や childNodes などの主要コア Node と整合性のない結果を返さないようにする必要がある。
導入されたバージョン:

DOM Level 3

setUserData
```
Object setUserData(String key,
                 Object data,
                 UserDataHandler handler)
```
このノードのキーにオブジェクトを関連付けます。このオブジェクトは、あとで同じキーで getUserData を呼び出すことによってこのノードから取得できます。

パラメータ:
key - オブジェクトを関連付けるキー。
data - 指定されたキーに関連付けるオブジェクト。そのキーへの既存の関連付けをすべて削除する場合は null。
handler - そのキーに関連付けるハンドラ、または null。

戻り値:
このノード上で指定されたキーに以前に関連付けられていた DOMUserData を返す。何も関連付けられていなかった場合は null。
導入されたバージョン:

DOM Level 3

getUserData
```
Object getUserData(String key)
```
このノードのキーに関連付けられたオブジェクトを取得します。このオブジェクトはまず、同じキーで setUserData を呼び出すことによってこのノードに設定されている必要があります。

パラメータ:
key - オブジェクトが関連付けられているキー。

戻り値:
このノード上で指定されたキーに関連付けられている DOMUserData を返す。何も関連付けられていなかった場合は null。
導入されたバージョン:

DOM Level 3

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

インタフェース Node

フィールドのサマリー

メソッドのサマリー

フィールドの詳細

ELEMENT_NODE

ATTRIBUTE_NODE

TEXT_NODE

CDATA_SECTION_NODE

ENTITY_REFERENCE_NODE

ENTITY_NODE

PROCESSING_INSTRUCTION_NODE

COMMENT_NODE

DOCUMENT_NODE

DOCUMENT_TYPE_NODE

DOCUMENT_FRAGMENT_NODE

NOTATION_NODE

DOCUMENT_POSITION_DISCONNECTED

DOCUMENT_POSITION_PRECEDING

DOCUMENT_POSITION_FOLLOWING

DOCUMENT_POSITION_CONTAINS

DOCUMENT_POSITION_CONTAINED_BY

DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

メソッドの詳細

getNodeName

getNodeValue

setNodeValue

getNodeType

getParentNode

getChildNodes

getFirstChild

getLastChild

getPreviousSibling

getNextSibling

getAttributes

getOwnerDocument

insertBefore

replaceChild

removeChild

appendChild

hasChildNodes

cloneNode

normalize

isSupported

getNamespaceURI

getPrefix

setPrefix

getLocalName

hasAttributes

getBaseURI

compareDocumentPosition

getTextContent

setTextContent

isSameNode

lookupPrefix

isDefaultNamespace

lookupNamespaceURI

isEqualNode

getFeature

setUserData

getUserData