You Are Here:

Community: Blogs

Paul Todd's Forum Nokia Blog

Use the XML Parser in OS 9.x

Paul.Todd | 09 April, 2007 15:24

I have noticed a couple of people seem to be having problems with using the XML parser in Symbian and there are no examples outside of the devkit. The parser I will be talking about is the xml one, not the one SOAP engine as the SOAP one is Nokia specific.

The key to parsing XML is to understand how SAX based parsing works.
The key to using the Symbian XML API is to understand how SAX works and how its been implemented in Symbian.

SAX is at its core an event driven model that supports data being streamed, making it ideal for devices.

The foundation of the parser is the MContentHandler class which provides the callback interface you need to implement. In fact the first thing you need to do is to create a class deriving from MContentHandler that implements all of the pure virtual methods of MContentHandler

You can then create a CParser class and use your implementation of MContentHandler to provide the call backs required. You will normally only use "text/xml" for the mime type. You can then pass your XML over to the Parse functions for parsing. by calling ParseBegin, ParseL and ParseEnd. For the most part you can just use the Xml::ParseL functions to parse files and text.

What happens when you call ParseL is that as the document is parsed and an "event" is identified, be it an element, comment, document processing instruction or plain data is encountered, the relevant callback is called and your code is executed, it is up to you to handle the data.

Normally for simple XML you will just worry about the OnBeginElementL,  OnEndElementL and OnContentL. It is up to you to handle nested elements.

Note that the OnContentL method can be called multiple times and is only considered complete when OnEndElementL is called so its up to you to store intermediate content passed in each time ContentL is called.
Also can be a bit strange that the data is all in ASCII (UTF8 IIRC) and so you need to convert it to unicode or handle it as ASCII. Most of the parameters are RStrings, which mean that from the RString class you need to call DesC() which returns the TDesC8& representing the token text.

For example in the OnStartElementL function, you will have a parameter of type RTagInfo which contains the Local name, prefix and uri RStrings. So if the parameter is called aElement, then to get the name of the element you will need to do this:
const TDesC8& elementName = aElement.LocalName().DesC();

This returns the TDesC8 which holds the name of the element which you can use.

RSSComments

play flash game

hankjmatt | 07/01/2009, 08:37

online games, online game, flash games, free online game, free online games, flash game

xml parsing

yebcha2050 | 25/01/2009, 01:04

Hi Paul,

I new to symbian and I was making an application to
browse an .xml file from a romote host like,
www.yahoo.com~hhh/name.xml I had already wrote the application but the emulator doesn't load, I am using antony's xmlparser example in the application will it be possible to send you my application just to check it?
Regards,
Fisher

You must login to post comments. Login
 

Rate This

 
 
Bookmark this page: DeliciousDiggFacebookGoogleYahooStumbleUponRedditFurlTechnocratiMagnoliaTwitter  Share this page Share this page Print this Page Print this page Invite a friend Invite a friend
Email Newsletters Press Terms & Conditions Privacy Policy Sitemap Contact Us © 2009 Nokia