<?xml version="1.0" encoding="utf-8"?>

<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

<!-- This component and the accompanying materials are made available under the terms of the License 

"Eclipse Public License v1.0" which accompanies this distribution, 

and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE task

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-C5C30218-311C-58D9-A990-3F95642F7517" xml:lang="en"><title>Parsing

XML DOM</title><shortdesc>This topic explains how to build a DOM tree by parsing an XML file. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<prereq><p>Before you start, you must: </p> <ul>

<li id="GUID-B39FCCC0-8791-5234-977A-868616FF4A46"><p>understand the concept

of <xref href="http://www.w3.org/DOM/" scope="external">Document Object Model

(DOM)</xref>  </p> </li>

<li id="GUID-5FEE15C3-9808-5B50-B19B-52C62CC10E46"><p>understand the architecture

and classes of the <xref href="GUID-5ACFA8E4-3C4B-5851-A43E-9FA72D0B8403.dita">XML

DOM Engine</xref> component </p> </li>

<li id="GUID-462DFB7D-1E1D-54C1-A63B-8CE73A8775B5"><p>prepare an XML file

containing valid XML data </p> </li>

</ul> </prereq>

<steps id="GUID-3D797BCC-4D06-5275-9B4F-CAB51649E6D1">

<step id="GUID-3DF73431-C215-59FD-9AE7-B4C8FDB98A1C"><cmd/>

<info>Call the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>XmlEnginePushL()</apiname></xref> method to

put parser resources on the clean-up stack. </info>

<stepxmp><codeblock id="GUID-975C0070-DD3D-58CE-908F-687659F45F76" xml:space="preserve">

XmlEnginePushL();

</codeblock> </stepxmp>

</step>

<step id="GUID-63B2D6CC-5B11-5466-BD05-837F18D0A810"><cmd>Initialise your

instance of the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>RXmlEngDOMImplementation</apiname></xref> class

by calling its <codeph>OpenL()</codeph> method. </cmd>

<stepxmp><codeblock id="GUID-F750DC25-5702-5424-AF2F-5C5D229AB296" xml:space="preserve">

RXMlEngDOMImplementation impl;

impl.OpenL();

</codeblock> </stepxmp>

<info>The <codeph>RXMlEngDOMImplementation</codeph> instance is the DOM Engine. </info>

</step>

<step id="GUID-5C57654A-7B78-5E5D-90E1-94CA025B024B"><cmd/>

<info>Initialise the DOM parser by calling the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>RXmlEngDOMParser::Open()</apiname></xref> method

on its instance. </info>

<stepxmp><codeblock id="GUID-F29FAB78-BAE3-553C-858A-6E80A76F754D" xml:space="preserve">

RXmlEngDOMParser parser;

parser.Open( impl );

</codeblock> </stepxmp>

<info>You can also have several parsers registered on a DOM Engine instance. </info>

</step>

<step id="GUID-70BA1E03-92D4-5A3A-9079-A00236D30923"><cmd/>

<info>Parse the specified XML file by calling the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>RXmlEngDOMParser::ParseFileL()</apiname></xref> method. </info>

<stepxmp><codeblock id="GUID-3E26315C-F901-5350-9936-11A6045E7FE7" xml:space="preserve">

RXmlDocument myDoc = parser.ParseFileL( "tutorial.xml" );

</codeblock> </stepxmp>

<info>The <codeph>myDoc</codeph> object is a DOM tree containing the data

from the XML file. </info>

</step>

<step id="GUID-97FC75A5-A4EA-55DC-841B-745E391E2C90"><cmd/>

<info>Use the created DOM tree. </info>

<info>For example, refer to the <xref href="GUID-92C2317A-57B8-558E-984B-B10FD0404981.dita">Searching

a DOM Tree using XPath</xref> to search for specific elements or attributes

in the DOM tree. </info>

</step>

<step id="GUID-9935393A-1359-5708-A9F3-B779F2E2B418"><cmd/>

<info>Free your resources as necessary. </info>

<substeps id="GUID-CB3D86A2-561D-5281-9DA4-AA8C70A0F498">

<substep id="GUID-6D1DC97D-5068-5FCD-AD69-510778348899"><cmd>Close the parser

and the engine by calling their <codeph>Close()</codeph> functions. </cmd>

<stepxmp><codeblock id="GUID-53680EE0-8291-5C9A-9A7A-04437B1A0836" xml:space="preserve">

parser.Close();

impl.Close();

</codeblock> </stepxmp>

</substep>

<substep id="GUID-1C28D8BE-D03B-5D9B-BCC7-355FB2A6A93C"><cmd/>

<info>Close the XML library by calling the <xref href="GUID-5748D958-9480-3358-A399-6B92293B86D9.dita"><apiname>XmlPopAndClose()</apiname></xref> method.

This method also removes the serialisation resources from the clean-up stack. </info>

</substep>

<substep id="GUID-BCD8662A-7C1E-5239-87C9-E3917D79C326"><cmd/>

<info>Perform any other clean-up operations. </info>

</substep>

</substeps>

</step>

</steps>

</taskbody><related-links>

<link href="GUID-92C2317A-57B8-558E-984B-B10FD0404981.dita"><linktext>Searching

a DOM Tree using XPath</linktext></link>

<link href="GUID-E20C2C98-A294-551B-99CF-BE1DAA6F597E.dita"><linktext>Serialising

XML DOM</linktext></link>