|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
Document インタフェースは、HTML 文書または XML 文書全体を表します。概念上は文書ツリーのルートであり、文書データへの一次アクセスを提供します。
要素、テキストノード、コメント、処理命令などのオブジェクトは、Document のコンテキスト外では存在し得ません。このため、Document インタフェースには、これらのオブジェクトを作成するために必要なファクトリメソッドが含まれています。作成された Node オブジェクトは、その作成コンテキスト内で自身と Document を関連付ける ownerDocument 属性を持っています。
「Document Object Model (DOM) Level 2 Core Specification」を参照してください。
| フィールドの概要 |
| インタフェース org.w3c.dom.Node から継承したフィールド |
ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE |
| メソッドの概要 | |
Attr |
createAttribute(String name)
所定の名前の Attr を作成します。 |
Attr |
createAttributeNS(String namespaceURI,
String qualifiedName)
所定の修飾名とネームスペース URI を持つ属性を作成します。 |
CDATASection |
createCDATASection(String data)
指定された文字列を値として持つ CDATASection ノードを作成します。 |
Comment |
createComment(String data)
指定された文字列を持つ Comment ノードを作成します。 |
DocumentFragment |
createDocumentFragment()
空の DocumentFragment オブジェクトを生成します。 |
Element |
createElement(String tagName)
指定された型の要素を作成します。 |
Element |
createElementNS(String namespaceURI,
String qualifiedName)
所定の修飾名とネームスペース URI を持つ要素を作成します。 |
EntityReference |
createEntityReference(String name)
EntityReference オブジェクトを作成します。 |
ProcessingInstruction |
createProcessingInstruction(String target,
String data)
指定された名前およびデータを持つ ProcessingInstruction ノードを作成します。 |
Text |
createTextNode(String data)
指定された文字列を持つ Text ノードを作成します。 |
DocumentType |
getDoctype()
この文書に関連付けられた文書タイプ宣言です ( DocumentType を参照)。 |
Element |
getDocumentElement()
文書のルート要素になっている子ノードへの直接アクセスを可能にする便利な属性です。 |
Element |
getElementById(String elementId)
elementId から与えられた ID を持つ Element を返します。 |
NodeList |
getElementsByTagName(String tagname)
所定のタグ名とともに、すべての Elements の NodeList を返します。 |
NodeList |
getElementsByTagNameNS(String namespaceURI,
String localName)
所定のローカル名およびネームスペース URI とともに、すべての Elements の NodeList を返します。 |
DOMImplementation |
getImplementation()
この文書を処理する DOMImplementation オブジェクトです。 |
Node |
importNode(Node importedNode,
boolean deep)
その他の文書から現在の文書へノードをインポートします。 |
| インタフェース org.w3c.dom.Node から継承したメソッド |
appendChild, cloneNode, getAttributes, getChildNodes, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, hasAttributes, hasChildNodes, insertBefore, isSupported, normalize, removeChild, replaceChild, setNodeValue, setPrefix |
| メソッドの詳細 |
public DocumentType getDoctype()
DocumentType を参照)。文書タイプ宣言のない XML 文書および HTML 文書に対しては null を返します。DOM レベル 2 では、文書タイプ宣言の変更はサポートされていません。いかなる方法によっても、docType を変更することはできません。たとえば、Node インタフェースから継承されたメソッド (insertNode、removeNode など) を使用する方法も許可されていません。
public DOMImplementation getImplementation()
DOMImplementation オブジェクトです。DOM アプリケーションは、複数の実装のオブジェクトを使用できます。
public Element getDocumentElement()
public Element createElement(String tagName)
throws DOMException
Element インタフェースを実装するため、属性は返されるオブジェクトに直接指定できます。
Attr ノードが自動的に作成され、要素に付加されます。
createElementNS メソッドを使用します。
tagName - インスタンス化する要素型の名前。XML の場合、アルファベットの大文字と小文字が区別される。このような区別は、HTML の tagName パラメータには適用されない。ただし、DOM 実装はこのパラメータを大文字 (標準仕様) でマッピングする
tagName に設定された nodeName 属性、localName、prefix、null に設定された namespaceURI を持つ新しい Element オブジェクト
DOMException - INVALID_CHARACTER_ERR: 指定された名前に不正な文字が含まれている場合public DocumentFragment createDocumentFragment()
DocumentFragment オブジェクトを生成します。
DocumentFragmentpublic Text createTextNode(String data)
Text ノードを作成します。
data - ノードのデータ
Text オブジェクトpublic Comment createComment(String data)
Comment ノードを作成します。
data - ノードのデータ
Comment オブジェクト
public CDATASection createCDATASection(String data)
throws DOMException
CDATASection ノードを作成します。
data - CDATASection に含まれるデータ
CDATASection オブジェクト
DOMException - NOT_SUPPORTED_ERR: この文書が HTML 文書の場合
public ProcessingInstruction createProcessingInstruction(String target,
String data)
throws DOMException
ProcessingInstruction ノードを作成します。
target - 処理命令のターゲット部分data - ノードのデータ
ProcessingInstruction オブジェクト
DOMException - INVALID_CHARACTER_ERR: 指定されたターゲットに不正な文字が含まれている場合
public Attr createAttribute(String name)
throws DOMException
Attr を作成します。その後、この Attr インスタンスは、setAttributeNode メソッドにより Element に設定されます。
createAttributeNS メソッドを使用します。
name - 属性の名前
name に設定された nodeName 属性、localName、prefix、null に設定された namespaceURI を持つ新しい Attr オブジェクト
DOMException - INVALID_CHARACTER_ERR: 指定された名前に不正な文字が含まれている場合
public EntityReference createEntityReference(String name)
throws DOMException
EntityReference オブジェクトを作成します。さらに、参照されるエンティティが既知の場合は、Entity ノードの子リストが作成されるのと同じように、EntityReference ノードの子リストが作成されます。Entity ノードの子孫がバインドされていないネームスペース修飾子を持っている場合、作成された EntityReference ノードの対応する子孫もバインドされていません (namespaceURI が null)。DOM レベル 2 では、ネームスペース修飾子を解決するメカニズムはサポートされていません。
name - 参照されるエンティティの名前
EntityReference オブジェクト
DOMException - INVALID_CHARACTER_ERR: 指定された名前に不正な文字が含まれている場合
public NodeList getElementsByTagName(String tagname)
Elements の NodeList を返します。返される順番は、Document ツリーの先行順 (preorder traversal) で検出された順番になります。
tagname - 一致するタグの名前。特殊な値 "*" はすべてのタグに一致する
Elements を含む新しい NodeList オブジェクト
public Node importNode(Node importedNode,
boolean deep)
throws DOMException
parentNode が null)。このメソッドはソースコードの新しいコピーを作成するだけです。元の文書のソースノードが変更または削除されることはありません。
nodeName および nodeType とまったく同じ属性値に加えて、ネームスペース関連属性 (prefix、localName、namespaceURI) を持っています。Node に対する cloneNode 操作の場合と同じく、ソースノードは変更されません。
nodeType にコピーされます。XML ソースまたは HTML ソースのフラグメントが一方の文書からもう一方の文書にコピーされた場合、2 つの文書が XML ケース内に異なった DTD を持つ可能性があることを受けて、適切な動作のミラー化が試行されます。以下では、各ノード型の特性を解説します。
Attr 上で、ownerElement 属性は null、specified フラグは true に設定されます。ソースである Attr の子孫の再帰的インポートと結果ノードの再アセンブルにより、対応するサブツリーが形成されます。なお、deep パラメータは Attr ノードに影響を及ぼしません。これらのパラメータは、子とともにインポートされます。deep オプションが true に設定されている場合、ソース要素の子孫の再帰的インポートと結果ノードの再アセンブルにより、対応するサブツリーが形成されます。それ以外の場合は、空の DocumentFragment が生成されるだけです。Document ノードはインポートできません。DocumentType ノードはインポートできません。Attr ノードが同じく生成された Element に追加されます。インポートされる文書がこの要素名のデフォルト属性 (割り当て済み) を定義する場合も、デフォルト属性はコピーされません。importNode の deep パラメータが true に設定されている場合は、ソース要素の子孫が再帰的にインポートされ、結果ノードが再アセンブルされて、対応するサブツリーを形成します。DocumentType は読み取り専用ですが、Entity ノードはインポート可能です。こうしてインポートされたノードを DocumentType に追加する機能は、将来の DOM のリリースで追加される予定です。インポート時には、publicId、systemId、notationName の各属性がコピーされます。deep のインポートが要求された場合は、Entity (ソース) の子孫が再帰的にインポートされ、結果ノードが再アセンブルされて、対応するサブツリーを形成します。deep のインポートが要求された場合も、ソース文書とディスティネーション文書でエンティティの定義が異なる場合があるので、EntityReference だけがコピーされることになります。インポートされる文書がこのエントリ名を定義する場合は、その値が割り当てられます。DocumentType は読み取り専用ですが、Notation ノードはインポート可能です。こうしてインポートされたノードを DocumentType に追加する機能は、将来の DOM のリリースで追加される予定です。インポート時には、publicId 属性と systemId 属性がコピーされます。子を持つことがない deep パラメータは、Notation ノードに対して何の影響も及ぼしません。target と data の値をコピーします。CharacterData を継承する 3 つのノード型です。自身の data 属性と length 属性をソースノードからコピーします。
importedNode - インポートされるノードdeep - true の場合は指定されたノードのサブツリーをインポートし、false の場合は指定されたノードだけをインポートする (上記の説明を参照)。Attr、EntityReference、Notation の各ノードには影響を及ぼさない
Document に所属する、インポートされたノード
DOMException - NOT_SUPPORTED_ERR: インポートされるノード型がサポート対象外の場合
public Element createElementNS(String namespaceURI,
String qualifiedName)
throws DOMException
namespaceURI - 作成する要素のネームスペース URIqualifiedName - インスタンス化する要素型の修飾名
Element オブジェクト: | 属性 | 値 |
|---|---|
Node.nodeName | qualifiedName |
Node.namespaceURI | namespaceURI |
Node.prefix | qualifiedName から抽出された前置修飾子。前置修飾子が存在しない場合は null |
Node.localName | qualifiedNameから抽出されたローカル名 |
Element.tagName | qualifiedName |
DOMException - INVALID_CHARACTER_ERR: 指定された修飾名に XML 1.0 仕様に定められている不正な文字が含まれている場合
qualifiedName が XML 仕様のネームスペースの定義に沿ったものでない場合。qualifiedName が前置修飾子を持ち、namespaceURI が null の場合。qualifiedName が前置修飾子 "xml" を持ち、namespaceURI が "http://www.w3.org/XML/1998/namespace" 以外である場合
"XML" をサポートしない場合 (ネームスペースは XML によって定義されている)
public Attr createAttributeNS(String namespaceURI,
String qualifiedName)
throws DOMException
namespaceURI - 作成する属性のネームスペース URIqualifiedName - インスタンス化する属性の修飾名
Attr オブジェクト: | 属性 | 値 | Node.nodeName | | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
namespaceURI | |||||||||||
Node.prefix | qualifiedName から抽出された前置修飾子。前置修飾子が存在しない場合は null | ||||||||||
Node.localName | qualifiedNameから抽出されたローカル名 | ||||||||||
Element.tagName | qualifiedName | ||||||||||
|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
| 前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
| 概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド | ||||||||||
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.