継承図

解説

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

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

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

	DocumentFragment
	DocumentFragment とは、 DOM ツリーを操作する際の一時的な作業用サブツリーを作成するための「軽量 （最小限度）」 の Document オブジェクトです。 文書ツリーのあるノードに DocumentFragment ノードを挿入するとき、 実際に挿入されるのは DocumentFragment ノードではなく、DocumentFragment ノードの子が挿入されることに注意してください。

	DOM（Document Object Model）の仕様
	W3C DOM レベル 2 コア仕様 : Document Object Model (DOM) Level 2 Core Specification

参照

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

メンバ

解説

このコンストラクタは、このノードを所有する Document ノード（SFXXMLDocument） を引数に指定して設定することが可能です。 これ以外は、何も行いません。

参照

SFXXMLDocument

解説

このデストラクタは、何も行いません。

戻り値

SFERR_UNSUPPORTED

解説

この関数は、SFERR_UNSUPPORTED を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている AppendChild 関数を呼び出してください。

参照

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

戻り値

SFERR_UNSUPPORTED

解説

この関数は、SFERR_UNSUPPORTED を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている CloneNode 関数を呼び出してください。

参照

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

戻り値

解説

この関数は、指定されたノードと同等かどうか（ノードの内容が同じであるかどうか）を判定します。

2 つのノードが同等であるための条件

2 つのノードが同等であるための条件は、以下のように再帰的に定義されます。 2 つのノードが同じであること（SFXXMLNode::IsSameNode 関数の戻り値が true であるとき） 2 つのノードが同じでない（異なる）場合は、以下の条件をすべて満足すること ノードタイプ（nodeType 属性値）が同じであること ノードの名前（nodeName 属性値）が同じであること ノードの値（nodeValue 属性値）が同じであること （子ノードが存在するなら）子ノードの数が同じであり、かつ同じ位置にある子ノード同士が同等であること Attribute ノードの場合は、設定されているローカル名、名前空間 URI、名前空間接頭辞も同じであること DocumentType ノードの場合は、 設定されている外部サブセットの公開識別子とシステム識別子、 内部サブセット、記法、エンティティも同じであること Element ノードの場合は、 設定されているローカル名、名前空間 URI、名前空間接頭辞、属性も同じであること

	2 つのノードの同一性の判定
	2 つのノードが同一であるかどうか（2 つのノードが同じオブジェクトを参照しているかどうか）の判定には、 SFXXMLNode::IsSameNode 関数を使用します。

参照

SFXXMLAttribute::EqualNode | SFXXMLDocumentType::EqualNode | SFXXMLElement::EqualNode | SFXXMLNode::IsSameNode

戻り値

null

解説

この関数は、null を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている GetChildNodes 関数を呼び出してください。

参照

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

戻り値

null

解説

この関数は、null を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている GetFirstChild 関数を呼び出してください。

参照

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

戻り値

null

解説

この関数は、null を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている GetLastChild 関数を呼び出してください。

参照

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

戻り値

null

解説

この関数は、null を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている GetNextSibling 関数を呼び出してください。

参照

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

戻り値

null

解説

この関数は、null を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている GetNodeName 関数を呼び出してください。

参照

SFXXMLNode::DOMNamedNodeMap

戻り値

SFXXMLNode::UNKNOWN_NODE

解説

この関数は、SFXXMLNode::UNKNOWN_NODE を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている GetNodeType 関数を呼び出してください。

ノードタイプ

ノードタイプとは、ノードの種類によって内容が異なる 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

解説

この関数は、null を返します。

参照

SFXXMLNode::SetNodeValue

戻り値

null

解説

この関数は、null を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている GetParentNode 関数を呼び出してください。

参照

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

戻り値

null

解説

この関数は、null を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている GetPreviousSibling 関数を呼び出してください。

参照

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

戻り値

このノードのノードテキスト

解説

この関数は、このノードのノードテキストを返します。

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

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

参照

SFXXMLNode::SetText

戻り値

false

解説

この関数は、false を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている HasChildNodes 関数を呼び出してください。

戻り値

SFERR_UNSUPPORTED

解説

この関数は、SFERR_UNSUPPORTED を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている InsertBefore 関数を呼び出してください。

参照

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

戻り値

解説

この関数は、このノードが指定されたノードと同一であるか判定します。

参照

SFXXMLNode::EqualNode

戻り値

SFERR_UNSUPPORTED

解説

この関数は、SFERR_UNSUPPORTED を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている RemoveChild 関数を呼び出してください。

参照

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

戻り値

SFERR_UNSUPPORTED

解説

この関数は、SFERR_UNSUPPORTED を返します。

	注意
	この関数は無効です。 SFXXMLNode クラスを継承するクラスで実装されている ReplaceChild 関数を呼び出してください。

参照

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

解説

この関数は、何も行いません。

参照

SFXXMLNode::GetNodeValue

戻り値

解説

この関数は、このノードに指定されたノードテキストを設定します。

この関数の動作は、以下のようにノードのタイプによって異なります。

参照

SFXXMLNode::GetText

解説

このクラスは、 複数の DOM ノードを管理するためのクラスです。

このクラスでは、名前（nodeName 属性値）を指定してノードを操作することが可能です。 また、インデックスを指定してノードにアクセスすることも可能です（ノード間に順序関係はありません）。

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

	注意
	上の表で、名前は nodeName 属性値（SFXXMLNode::GetNodeName 関数で取得できるノードの名前）を表します。 GetNamedItem / RemoveNamedItem / SetNamedItem 関数を使用して名前でノードにアクセスする場合、 名前空間が設定されていれば修飾名でアクセスする場合もあります。 ローカル名と名前空間 URI でノードにアクセスする場合は、 GetNamedItemNS / RemoveNamedItemNS / SetNamedItemNS 関数を使用します。

使用例

// 解析対象の 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 | SFXXMLNode::GetNodeName

解説

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()); 
    }
}

参照

SFXList | SFXXMLNode::DOMNamedNodeMap

解説

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