継承図

解説

SophiaFramework では、W3C ( World Wide Web Consortium ) で定義される 12 種類のノードに対応する、 以下の 12 のクラスを使って DOM ツリーを構築して XML 文書を処理します。 これらのクラスは SFXXMLNode クラスを継承します。

	注意
	nodeType, nodeName, nodeValue 属性の値は、それぞれ SFXXMLNode::GetNodeType, SFXXMLNode::GetNodeName, SFXXMLNode::GetNodeValue 関数で取得できます。

	注意
	attributes 属性の値は、Element ノードに対してのみ有効で SFXXMLElement::GetAttributes 関数で取得できます。

	Document Object Model ( DOM ) の仕様
	W3C DOM レベル 1 勧告 : Document Object Model Level 1 Specification

参照

SFXXMLAttribute | SFXXMLCDATASection | SFXXMLComment | SFXXMLDocument | SFXXMLDocumentFragment | SFXXMLDocumentType | SFXXMLElement | SFXXMLEntity | SFXXMLEntityReference | SFXXMLNode | SFXXMLNotation | SFXXMLProcessingInstruction | SFXXMLText

メンバ

参照

SFXXMLNode::RemoveChild | SFXXMLNode::ReplaceChild | SFXXMLNode::CloneNode | SFXXMLNode::InsertBefore

戻り値

SFERR_UNSUPPORTED を返します。

参照

SFXXMLNode::RemoveChild | SFXXMLNode::ReplaceChild | SFXXMLNode::AppendChild | SFXXMLNode::InsertBefore

戻り値

解説

SFXXMLNode::EqualNode 関数は、ノードの同一性 ( ノードへの参照で同じであるかどうか ) ではなく、 ノードの同等性 ( ノードの内容が同じであるかどうか ) を判定します。

同一性の判定には SFXXMLNode::IsSameNode 関数を使います。

参照

SFXXMLNode::IsSameNode

戻り値

null を返します。

解説

すべての子ノードを SFXXMLNode::DOMNodeList 形式で取得します。

	注意
	SFXXMLNode::DOMNodeList の各要素は、SFXXMLNode 型へのポインターです。

参照

SFXXMLNode::DOMNodeList | SFXXMLNode::GetFirstChild | SFXXMLNode::GetLastChild | SFXXMLNode::GetNextSibling | SFXXMLNode::GetParentNode | SFXXMLNode::GetPreviousSibling

戻り値

null を返します。

参照

SFXXMLNode::GetLastChild | SFXXMLNode::GetChildNodes | SFXXMLNode::GetNextSibling | SFXXMLNode::GetPreviousSibling | SFXXMLNode::GetParentNode

戻り値

null を返します。

参照

SFXXMLNode::GetFirstChild | SFXXMLNode::GetChildNodes | SFXXMLNode::GetNextSibling | SFXXMLNode::GetPreviousSibling | SFXXMLNode::GetParentNode

戻り値

null を返します。

参照

SFXXMLNode::GetPreviousSibling | SFXXMLNode::GetFirstChild | SFXXMLNode::GetLastChild | SFXXMLNode::GetChildNodes | SFXXMLNode::GetParentNode

戻り値

null を返します。

解説

	ノードの名前
	ノードの名前とは nodeName 属性値のことです。ノード タイプによって内容が異なります。 ( 例 ) Element ノードの場合は、タグの名前です。Text ノードの場合は、null です。

戻り値

UNKNOWN_NODE を返します。

解説

ノード タイプ

ノード タイプとは nodeType 属性値のことです。ノードの種類によって内容が異なります。 ノード タイプの値は、W3C DOM レベル 1 勧告 ( Document Object Model (DOM) Level 1 Specification ) の NodeType の一覧に記載されている数値と同じです。 整数値 ノード タイプ 1 ELEMENT_NODE 2 ATTRIBUTE_NODE 3 TEXT_NODE 4 CDATA_SECTION_NODE 5 ENTITY_REFERENCE_NODE 6 ENTITY_NODE 7 PROCESSING_INSTRUCTION_NODE 8 COMMENT_NODE 9 DOCUMENT_NODE 10 DOCUMENT_TYPE_NODE 11 DOCUMENT_FRAGMENT_NODE 12 NOTATION_NODE -1 UNKNOWN_NODE

参照

SFXXMLNode::NodeType

戻り値

null を返します。

解説

	ノードの値
	ノードの値とは nodeValue 属性値のことです。ノード タイプによって内容が異なります。 ( 例 ) Text ノードの場合は、ノードのテキストです。Element ノードの場合は、null です。

参照

SFXXMLNode::SetNodeValue

戻り値

null を返します。

解説

親ノードがない場合は、null を返します。( DOM ツリーに追加されていないノード、あるいは DOM ツリーから削除されたノード )

Attribute ノード、Document ノード、DocumentFragment ノード、Entity ノード、および Notation ノード以外のノードは、必ず親ノードを持ちます。

参照

SFXXMLNode::GetFirstChild | SFXXMLNode::GetLastChild | SFXXMLNode::GetChildNodes | SFXXMLNode::GetNextSibling | SFXXMLNode::GetPreviousSibling

戻り値

null を返します。

解説

前の兄弟ノードを取得します。前の兄弟ノードがないときは null を返します。

参照

SFXXMLNode::GetNextSibling | SFXXMLNode::GetFirstChild | SFXXMLNode::GetLastChild | SFXXMLNode::GetChildNodes | SFXXMLNode::GetParentNode

解説

戻り値のテキストは、ノードのタイプによって異なります。

	注意
	ノード テキストにはマークアップは含まれません。また、空白文字は正規化されません。

参照

SFXXMLNode::SetText

戻り値

SFERR_UNSUPPORTED を返します。

参照

SFXXMLNode::RemoveChild | SFXXMLNode::ReplaceChild | SFXXMLNode::CloneNode | SFXXMLNode::AppendChild

戻り値

解説

2 つのノードが同じノードを参照するかどうかを判定します。

参照

SFXXMLNode::EqualNode

戻り値

SFERR_UNSUPPORTED を返します。

使用例

// 最後の子ノードを取得する 
SFXXMLNodePtr publisher = book->GetLastChild();
// その子ノードを削除する     
book->RemoveChild(publisher);

参照

SFXXMLNode::AppendChild | SFXXMLNode::ReplaceChild | SFXXMLNode::CloneNode | SFXXMLNode::InsertBefore

戻り値

SFERR_UNSUPPORTED を返します。

参照

SFXXMLNode::AppendChild | SFXXMLNode::RemoveChild | SFXXMLNode::CloneNode | SFXXMLNode::InsertBefore

参照

SFXXMLNode::GetNodeValue

戻り値

解説

SFXXMLNode::SetText 関数の動作は、ノードのタイプによって異なります。

参照

SFXXMLNode::GetText

解説

複数の DOM ノードを管理するためのクラスです。名前(nodeName 属性値)でノードを取得できる機能を提供します。

SFXXMLNode::DOMNamedNodeMap クラスのインスタンスに格納されたノード間には順序関係はありませんが、インデックスを指定してノードにアクセスすることも可能です。

SFXXMLNode::DOMNamedNodeMap クラスは、以下のメンバ関数を持ちます。

	注意
	上の表で、名前は nodeName 属性値( SFXXMLNode::GetNodeName 関数で取得できるノードの名前 )を表します。

使用例

// 解析対象の XML 文書( apple.xml )
<fruit>
    <name made="japan" date="2007-06-20" size="XS">apple</name>
</fruit>

SFXXMLNode::DOMNamedNodeMap クラスを使ったサンプルコードです。

SFCError error;             // エラー値
SFXXMLDOMParser parser;     // DOM パーサー
SFXAnsiString resultString; // Attribute ノードの値を格納する変数

// XML 文書 "/apple.xml" を解析する
if ((error = parser.Parse("/apple.xml")) == SFERR_NO_ERROR) {

    // DOM ツリーのルート ノードを取得する
    SFXXMLDocumentPtr root = parser.GetDocument();    

    // XML 文書のルート要素(DOM ツリーのルート ノードの最初の子ノード。この場合、fruit 要素)を取得する
    SFXXMLNodePtr child = root->GetFirstChild(); 

    // fruit 要素の最初の子ノード ( name 要素 )を取得する
    child = child->GetFirstChild();  

    // name 要素のすべての Attribute ノードを取得する
    SFXXMLNode::DOMNamedNodeMapPtr nodeMap = SFXXMLElementPtr(child)->GetAttributes();

    // Attribute ノード数を表示する(マップのノード数を表示する)
    TRACE("%d",nodeMap->GetLength());   // "3" が表示される

    for (int i = 0; i < nodeMap->GetLength(); i++) {
        SFXXMLNodePtr node = nodeMap->Item(i); // マップの i 番目の項目(Attribute ノード)を取得する
        resultString = node->GetNodeValue();   // マップの i 番目の項目(Attribute ノード)の値を取得する

        // 取得した項目(Attribute ノード)の値を表示する
        TRACE("%s",resultString.GetCString());
    }
    // name 要素のすべての属性値 "XS", "2007-06-20", "japan" が表示される
    
    // "date " という名前のノードを取得する
    SFXXMLAttributePtr date = static_cast<SFXXMLAttributePtr>(nodeMap->GetNamedItem( "date "));
    //  "date " という名前のノードの値を取得する
    resultString = date->GetNodeValue();
	
    // 取得した項目(Attribute ノード)の値を表示する
    TRACE("%s",resultString.GetCString());      // "2007-06-20" が表示される
    
    // "made" という名前のノードをマップから削除する
    SFXXMLNodePtr remove = nodeMap->RemoveNamedItem("made");
    // "made" という名前のノードを削除する
    ::delete remove;
	
    // Attribute ノード数を表示する(マップのノード数を表示する)
    TRACE("%d",nodeMap->GetLength());   // "2" が表示される
    
    for (int i = 0; i < nodeMap->GetLength(); i++) {
        SFXXMLNodePtr node = nodeMap->Item(i); // マップの i 番目の項目(Attribute ノード)を取得する
        resultString = node->GetNodeValue();   // マップの i 番目の項目(Attribute ノード)の値を取得する

        // 取得した項目(Attribute ノード)の値を表示する
        TRACE("%s",resultString.GetCString());     
    }
    // name 要素のすべての属性値 "2007-06-20", "japan" が表示される
    
    // ノードをマップに追加する
    nodeMap->SetNamedItem(root->CreateAttribute("color", "red"));
    
    // Attribute ノード数を表示する(マップのノード数を表示する)
    TRACE("%d",nodeMap->GetLength());   // "3" が表示される
    
    for (int i = 0; i < nodeMap->GetLength(); i++) {
        SFXXMLNodePtr node = nodeMap->Item(i); // マップの i 番目の項目(Attribute ノード)を取得する
        resultString = node->GetNodeValue();   // マップの i 番目の項目(Attribute ノード)の値を取得する

        // 取得した項目(Attribute ノード)の値を表示する
        TRACE("%s",resultString.GetCString());  
    }
    // name 要素のすべての属性値 "XS" "2007-06-20" "red"が表示される
}

参照

SFXXMLNode::DOMNodeList

解説

SFXList<SFXXMLNodePtr> と同等です。リストに格納されたノード間には順序関係があります。

使用例

// 解析対象の XML 文書( apple.xml )
<fruit>
  <name>apple</name>
  <size>XS</size>
  <color>red</color>
</fruit>

SFCError error;             // エラー値
SFXXMLDOMParser parser;     // DOM パーサー
SFXAnsiString resultString; // 要素のテキストを格納する変数

// XML 文書 "apple.xml" を解析する
if ((error = parser.Parse("/apple.xml")) == SFERR_NO_ERROR) {

    // DOM ツリーのルート ノードを取得する
    SFXXMLDocumentPtr root = parser.GetDocument(); 

    // XML 文書のルート要素(DOM ツリーのルート ノードの最初の子ノード。この場合、fruit 要素)を取得する
    SFXXMLNodePtr child = root->GetFirstChild();   

    // fruit 要素のすべての子要素(子ノード)を取得する
    SFXXMLNode::DOMNodeListPtr nodeList = child->GetChildNodes();

    // イテレータを取得する
    SFXXMLNode::DOMNodeList::Iterator itor = nodeList->GetFirstIterator();   
    
    // fruit 要素のすべての子ノードのテキストを表示する
    while (itor.HasNext()) {
        // name 要素、size 要素、color 要素の順に取得する
        SFXXMLNodePtr node = itor.GetNext();

        // ノードの名前を取得する
        resultString = node->GetNodeName();

        // ノードのテキストを取得する
        resultString = node->GetText();
        // ノードのテキストを表示する (例: name 要素の場合は "apple")
        TRACE("%s",resultString.GetCString()); 
    }
}

参照

SFXXMLNode::DOMNamedNodeMap

解説

W3C DOM レベル 1 勧告 ( Document Object Model Level 1 Specification ) の NodeType の一覧に記載されている数値です。