Lotus Domino Designer 8 ヘルプ

LOTUS DOMINO の XML

Node
Node インターフェースは文書オブジェクトモデル全体の主要なデータタイプです。文書ツリーの単体のノードを表します。Node インターフェースを実装するすべてのオブジェクトが子ノードを処理するためのメソッドを公開しますが、Node インターフェースを実装するすべてのオブジェクトが子ノードを持つとは限りません。たとえば、Text ノードには子ノードがないことがありますが、このようなノードに子ノードを追加すると、DOMException が発生します。nodeName や nodeValue 属性は、特定の継承元のインターフェースまで対象を広げなくても、ノードの情報を取得するためのメカニズムとして組み込まれています。これらの属性を (たとえば nodeValue を Element に、または属性を Comment にマップするなど) 特定の nodeType に明確にマップしていない場合は、ヌルが返されます。特別なインターフェースには、適切な情報を取得し設定するために、より便利な追加のメカニズムが組み込まれている可能性があります。

NodeTypes は次の通りです。

ELEMENT_NODE

public static final short ELEMENT_NODE

ATTRIBUTE_NODE

public static final short ATTRIBUTE_NODE

TEXT_NODE

public static final short TEXT_NODE

CDATA_SECTION_NODE

public static final short CDATA_SECTION_NODE

ENTITY_REFERENCE_NODE

public static final short ENTITY_REFERENCE_NODE

ENTITY_NODE

public static final short ENTITY_NODE

PROCESSING_INSTRUCTION_NODE

public static final short PROCESSING_INSTRUCTION_NODE

COMMENT_NODE

public static final short COMMENT_NODE

DOCUMENT_NODE

public static final short DOCUMENT_NODE

DOCUMENT_TYPE_NODE

public static final short DOCUMENT_TYPE_NODE

DOCUMENT_FRAGMENT_NODE

public static final short DOCUMENT_FRAGMENT_NODE

NOTATION_NODE

public static final short NOTATION_NODE

メソッドappendChild
cloneNode

appendChildnewChild ノードを、このノードの子ノードのリストの最後に追加します。newChild がツリーにすでにある場合は、先に削除されます。
構文:

public Node appendChild(Node newChild)
throws DOMException

パラメータ

newChild - 追加するノードです。newChild が DocumentFragment オブジェクトなら、文書の断片の内容全体が、このノードの子ノードリストに移動されます。

戻り値:

追加されたノードです。

例外処理:

DOMException - HIERARCHY_REQUEST_ERR:ノードが、newChild ノードのタイプの子ノードを許可しないタイプの場合に発生します。あるいは追加するノードが、このノードの子である場合に発生します。

WRONG_DOCUMENT_ERR:newChild がこのノードを生成した文書以外の文書から生成された場合に発生します。

NO_MODIFICATION_ALLOWED_ERR:ノードが読み込み専用の場合に発生します。

cloneNodeこのノードの複製を返します。つまり、ノードを複製するための汎用的なコンストラクタの役割を果たします。複製したノードには親ノードは存在しません (parentNode はヌルを返します)。
Element のクローンを生成すると、属性とその値もすべてコピーされます。これらは XML プロセッサがデフォルトの属性を表すために生成した情報も含みます。しかしこのメソッドでは、ノードが深層の (deep) クローンでない限り、ノードに含まれる Text はコピーされません。これは Text が子の Text ノードに含まれているためです。他のタイプのノードのクローンを生成すると、単にこのノードのコピーが返されます。

構文:

public Node cloneNode(boolean deep)

パラメータ

deep - true なら、指定したノードの下のサブツリーのクローンを再帰的に作成します。false なら、ノードのクローン (ノードが Element の場合は属性も含めて) のみを作成します。

戻り値:

複製されたノードを返します。

getAttributes(ノードが Element なら) このノードの属性を含む NamedNodeMap です。それ以外はヌルです。
構文:

public NamedNodeMap getAttributes()

getChildNodesこのノードのすべての子ノードを含む NodeList です。子ノードがない場合は、ノードを含まない NodeList になります。返される NodeList の内容は「動的」です。たとえば、NodeList 生成の元になったノードオブジェクトの子ノードへの変更は、NodeList へのアクセサによって返されるノードにすぐに反映されます。これはノードの内容の静的なスナップショットではありません。このことは、getElementsByTagName メソッドで返されたリストも含めてすべての NodeList に当てはまります。
構文:

public NodeList getChildNodes()

getFirstChildこのノードの最初の子ノードです。すぐ前のノードが存在しない場合は、ヌルが返されます。
構文:

public Node getFirstChild()

getLastChildこのノードの最後の子ノードです。すぐ前のノードが存在しない場合は、ヌルが返されます。
構文:

public Node getLastChild()

getNextSiblingこのノードのすぐ次に続くノードです。すぐ前のノードが存在しない場合は、ヌルが返されます。
構文:

public Node getNextSibling()

getNodeNameこのノードの名前です。タイプによります。前述の NodeType リストを参照してください。
構文:

public java.lang.String getNodeName()

getNodeType下にあるオブジェクトのタイプを表すコードです。前述の NodeType リストを参照してください。
構文:

public short getNodeType()

getNodeValueこのノードの値です。タイプによります。前述の NodeType リストを参照してください。
構文:

public java.lang.String getNodeValue()
throws DOMException

例外処理:

DOMException - NO_MODIFICATION_ALLOWED_ERR:ノードが読み込み専用の場合に発生します。

DOMException - DOMSTRING_SIZE_ERR:実装プラットフォーム上の DOMString 変数の許容量を超える文字列が返された場合に発生します。

getOwnerDocumentこのノードに関連する Document オブジェクトです。新規のノードを作成するのに使われる Document オブジェクトでもあります。このノードが Document の場合は、ヌルが返されます。
構文:

public Document getOwnerDocument()

getParentNodeこのノードの親ノードです。Document、DocumentFragment、Attr 以外のすべてのノードは親を持つことができます。しかしノードが作成された直後でまだツリーに追加されていない場合、またはツリーから削除された場合は、ヌルになります。
構文:

public Node getParentNode()

getPreviousSiblingこのノードのすぐ前のノードです。すぐ前のノードが存在しない場合は、ヌルが返されます。
構文:

public Node getPreviousSibling()

hasChildNodesノードに子ノードが存在するかを簡単に確認できるようにするためのメソッドです。
構文:

public boolean hasChildNodes()

戻り値:

ノードに子があれば true を返します。子がなければ false です。

insertBefore既存の子ノード refChild の前に newChild ノードを挿入します。refChild がヌルの場合、子ノードリストの最後に newChild を追加します。newChild が DocumentFragment オブジェクトの場合、すべての子ノードが、同じ順番で refChild の前に挿入されます。newChild がツリーにすでにある場合は、先に削除されます。
構文:

public Node insertBefore(Node newChild, Node refChild)
throws DOMException

パラメータ

newChild - 挿入するノードです。

refChild - 参照ノードです。新規のノードがその前に挿入されます。

戻り値:

挿入されたノードです。

例外処理:

WRONG_DOCUMENT_ERR:newChild がこのノードを生成した文書以外の文書から生成された場合に発生します。

NO_MODIFICATION_ALLOWED_ERR:ノードが読み込み専用の場合に発生します。

NOT_FOUND_ERR:refChild がこのノードの子ノードでない場合に発生します。

removeChild子ノードのリストから oldChild で指定された子ノードを削除し、削除したノードを返します。
構文:

public Node removeChild(Node oldChild)
throws DOMException

パラメータ

oldChild - 削除するノードです。

戻り値:

削除されたノードです。

例外処理:

DOMException - NO_MODIFICATION_ALLOWED_ERR:ノードが読み込み専用の場合に発生します。

NOT_FOUND_ERR:oldChild がこのノードの子ノードでない場合に発生します。

replaceChild子ノードリストで、子ノード oldChild を newChild で置き換え、oldChild ノードを返します。newChild がツリーにすでにある場合は、先に削除されます。
構文:

public Node replaceChild(Node newChild, Node oldChild)
throws DOMException

パラメータ

newChild - 子ノードリストに追加される新規のノードです。

oldChild - 子ノードリストで置換されるノードです。

戻り値:

置換されるノードです。

例外処理:

WRONG_DOCUMENT_ERR:newChild がこのノードを生成した文書以外の文書から生成された場合に発生します。

NO_MODIFICATION_ALLOWED_ERR:ノードが読み込み専用の場合に発生します。

NOT_FOUND_ERR:oldChild がこのノードの子ノードでない場合に発生します。

setNodeValue構文:
public void setNodeValue(java.lang.String nodeValue)
throws DOMException

用語集

フィードバック ヘルプ または プロダクトユーザビリティ?

ヘルプの使い方

すべてのヘルプ項目

用語集