19.2. Structure of XML Classes

19.2.1. Classes for Creating Nodes for the DOM Tree

SophiaFramework provides you with the following 12 types of node classes defined by W3C. These classes inherit from the SFXXMLNode class.

Table 19.1. XML Node Class

Class name	Description	Node Type ( SFXXMLNode::NodeType )
`SFXXMLNode`	Base class for 12 types of node classes.	-
`SFXXMLElement`	Class which represents an Element node.	ELEMENT_NODE
`SFXXMLAttribute`	Class which represents an Attribute node.	ATTRIBUTE_NODE
`SFXXMLText`	Class which represents a Text node.	TEXT_NODE
`SFXXMLCDATASection`	Class which represents a CDATASection node.	CDATA_SECTION_NODE
`SFXXMLEntityReference`	Class which represents an Entity Reference node.	ENTITY_REFERENCE_NODE
`SFXXMLEntity`	Class which represents an Entity node.	ENTITY_NODE
`SFXXMLProcessingInstruction`	Class which represents a Processing Instruction node.	PROCESSING_INSTRUCTION_NODE
`SFXXMLComment`	Class which represents a Comment node.	COMMENT_NODE
`SFXXMLDocument`	Class which represents a Document node.	DOCUMENT_NODE
`SFXXMLDocumentType`	Class which represents a DocumentType node.	DOCUMENT_TYPE_NODE
`SFXXMLDocumentFragment`	Class which represents a DocumentFragment node.	DOCUMENT_FRAGMENT_NODE
`SFXXMLNotation`	Class which represents a Notation node.	NOTATION_NODE

Figure 19.1. DOM Tree of the SFXXMLNode nodes

19.2.2. Basic Function of SFXXMLNode

The following are provided as basic functions of the SFXXMLNode class.

Table 19.2. Function to get a node from the DOM tree

Function Name	Description
GetFirstChild	Get the first child node.
GetLastChild	Get the last child node.
GetNextSibling	Get the next node amongst brothers.
GetPreviousSibling	Get the previous node amongst brothers.
GetParentNode	Get the parent node.

Table 19.3. Function to create or update the DOM tree

Function Name	Description
AppendChild	Append the specified child node.
RemoveChild	Remove the specified child node.
ReplaceChild	Replace the specified child node.
InsertBefore	Insert the specified node.
CloneNode	Clone the specified node(It is possible to copy the specified node including child node trees).

Table 19.4. Function to get or set the node attribute

Function Name	Description
HasChildNodes	Check whether or not the node has any child nodes.
GetChildNodes	Get all child nodes.
GetNodeType	Get the node type.
GetNodeName	Get the node name.
SetNodeValue	Set the node value.
GetText	Get the text from the node value.
SetText	Set the specified text into the node value.

Table 19.5. Function to compare nodes

Function Name	Description
IsSameNode	Check whether or not the node is the same with the specified node.
EqualNode	Check whether or not the node equals the specified node.

19.2.3. Structure of the DOM Tree

An XML parser receives XML documents grammatically checked by DTD or XML Schema, expands the documents onto memory as tree-structured objects ( DOM tree ), and sends them to an application.

Figure 19.2. Process Flow on XML parser

In SophiaFramework, a DOM parser (SFXXMLDOMParser) is created to analyze XML document, and return an DOM tree of SFXXMLDocument.

Figure 19.3. Sequence Diagram

	SFXXMLScanner
	SFXXMLScanner is the class used by SophiaFramework.

Figure 19.4. SFXXMLDocument

The most important object in parsing XML document is the root node of SFXXMLDocument in the DOM tree.

Basic Functions of "SFXXMLDocument"

Create, update, compare, and get nodes.
Construct the DOM tree with nodes.
Save the DOM tree as the XML document.
Get any node in the DOM tree with the Helper function.