Symbian3/PDK/Source/GUID-E6B3E575-80E3-58E3-9950-E0A5F6798861.dita
author Graeme Price <GRAEME.PRICE@NOKIA.COM>
Fri, 15 Oct 2010 14:32:18 +0100
changeset 15 307f4279f433
parent 14 578be2adaf3e
permissions -rw-r--r--
Initial contribution of the Adaptation Documentation.

<?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 concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-E6B3E575-80E3-58E3-9950-E0A5F6798861" xml:lang="en"><title> Using
the Parser Plug-in Resource File</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>This section explains how to specify the field values for a parser plug-in
resource file. </p>
<section><title>Procedure</title> <p>The XML framework is designed to manage
numerous parser implementations and has functionality to choose the implementation
most suited to the current document. </p> <p>The criteria used to make the
selection are held in the <xref href="GUID-54A442BD-FCF1-31D3-BEF7-598C1820F473.dita#GUID-54A442BD-FCF1-31D3-BEF7-598C1820F473/GUID-AEFF2DB4-FBC2-36EE-A4CE-7EBBD4AF004E"><apiname>Xml::CMatchData</apiname></xref> class. When this
information does not force the selection of exactly one parser, the framework
defaults firstly to choose a Symbian-supplied parser if present, else it will
choose the one with the lowest UID. When a parser implementation is created,
a resource file which supplies the related information must also be created. </p> <p>The <codeph>implementation_uid</codeph> field
must contain the <codeph>UID</codeph> of the plug-in. The <codeph>default_data</codeph> field
must contain the document type it can parse. The <codeph>opaque_data </codeph> field
specifies the supplier (Symbian or other). The following is a sample resource
file: </p> <codeblock id="GUID-2661506B-5B2F-50CF-A908-EAAE9B6EF726" xml:space="preserve">
RESOURCE REGISTRY_INFO validatorInfo
       {
       dll_uid = 0x10273863;
       interfaces = 
              {
              INTERFACE_INFO
                     {
                     interface_uid = 0x101FAA0B;
                     implementations = 
                            {
                            IMPLEMENTATION_INFO
                                   {
                                   implementation_uid = 0x10273864;
                                   version_no = 2;
                                   display_name = "Example parser";
                                   default_data = "text/xml||text/wbxml";
                                   opaque_data = "LicenseeX";
                                   }
                            };
                     }
              };
       }
</codeblock> <p>For more details on how to write a sample registration resource
file, refer to <xref href="GUID-9A9103E4-27B0-5CF3-855A-DCD44795A5C0.dita">Creating
a Standard Registration Resource File</xref> </p> </section>
</conbody><related-links>
<link href="GUID-F79E4F18-19E2-577E-8409-8B82BD48AC66.dita"><linktext>XML Framework
Overview</linktext></link>
</related-links></concept>