DOMDocumentオブジェクト
コンポーネント情報 | |
---|---|
version | 1.0 |
since | 5.0 |
XML 文書全体を表す DOM Document オブジェクト。
このオブジェクトでは、XML の各タグをノードとして管理します。
各ノードは、属性と子供ノードを持ちます。
属性と子供ノードは複数持つ事ができ、子供ノードは更に属性と子供ノードを持つ事が出来ます。 すべてのノードの頂点となる親ノード(ドキュメントノード)は、XML ソース中の最も外側のタグであり、getDocumentElement() によって取得する事が出来ます。
XMLを解析してDOMツリーを作成するには、XMLParserオブジェクトのparse()メソッド、または、parseString()メソッドを使います。
(ドキュメントノードが複数存在する場合は、XML 解析エラーとなりますのでご注意下さい。)
例えば、以下のようなXML
このオブジェクトでは、XML の各タグをノードとして管理します。
各ノードは、属性と子供ノードを持ちます。
属性と子供ノードは複数持つ事ができ、子供ノードは更に属性と子供ノードを持つ事が出来ます。 すべてのノードの頂点となる親ノード(ドキュメントノード)は、XML ソース中の最も外側のタグであり、getDocumentElement() によって取得する事が出来ます。
XMLを解析してDOMツリーを作成するには、XMLParserオブジェクトのparse()メソッド、または、parseString()メソッドを使います。
(ドキュメントノードが複数存在する場合は、XML 解析エラーとなりますのでご注意下さい。)
例えば、以下のようなXML
<A> <B>Bタグの中のテキスト</B> <C>Cタグの中のテキスト</C> </A>から、<C> タグに囲まれたテキスト値を取得する場合は以下のようにプログラムします。
var xmlString = "<A><B>Bタグの中のテキスト</B><C>Cタグの中のテキスト</C></A>"; var parser = new XMLParser(); var dom = parser.parseString(xmlString); if (!parser.isError()) { var elms = dom.getElementsByTagName("C"); var elm = elms[0]; var childs = elm.getChildNodes(); var data = childs[0].getValue(); Debug.print("C's text: " + data); } else { Debug.print("Error occured ! : " + parser.getErrorMessage()); }
メソッドの概要
返却値の型 | メソッド名 |
---|---|
DOMNode | createElement (String tagName ) 新しいノードを作成します。 |
DOMNode | createTextNode (String data ) 新しいテキストノードを作成します。 |
DOMDocumentType | getDoctype () ドキュメントタイプを取得します。 |
DOMNode | getDocumentElement () Documentノードを取得します。 |
DOMNode | getElementById (String elementId ) 識別子に該当するノードを取得します。 |
Array | getElementsByTagName (String tagname ) 指定のタグにマッチするエレメントを取得します。 |
String | getErrorMessage () エラーメッセージの取得を行います。 |
Boolean | isError () エラー発生のチェックを行います。 |
メソッドの詳細
DOMNode createElement (String tagName )
新しいノードを作成します。
パラメータ
返却値
|
DOMNode createTextNode (String data )
新しいテキストノードを作成します。
パラメータ
返却値
|
DOMDocumentType getDoctype ()
ドキュメントタイプを取得します。
返却値
|
DOMNode getDocumentElement ()
Documentノードを取得します。
返却値
|
DOMNode getElementById (String elementId )
識別子に該当するノードを取得します。
指定の識別子にマッチしたノードを返します。 指定の識別子を持つノードが存在しなかった場合 null を返します。
パラメータ
返却値
|
Array getElementsByTagName (String tagname )
指定のタグにマッチするエレメントを取得します。
XML ソース中から指定のタグに該当するエンティティを返します。 返却値は、DOMNode オブジェクトを要素に持つ配列です。
パラメータ
返却値
|
String getErrorMessage ()
エラーメッセージの取得を行います。
新しいノード作成時にエラーが発生していた場合、そのエラーメッセージを返します。
返却値
|
Boolean isError ()
エラー発生のチェックを行います。
新しいノード作成時にエラーが発生していた場合 true を返します。
返却値
|