<?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-F7CC81CE-E823-5196-944A-5F7524411A08" xml:lang="en"><title>Registration
and Discovery</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>Server applications need to advertise what services they provide and clients
of server application services need to know what implementations of the services
exist. This happens through Apparc's application registration file system. </p>
<p>Application registration files have a table in which applications can list
the service UIDs that they implement. For each service UID listed, there is
an associated opaque (i.e. not interpreted by the framework) data field which
indicates how the service is implemented by that application. The opaque data
field is accessed through an <codeph>LLINK</codeph> into a resource elsewhere
in the application registration file group. The meaning of this opaque data
field is not known to the framework, it will vary according to the service.
For some services the opaque data field may be a name intended for user display,
for others it may be structured data that the service's client-side code can
interpret. </p>
<fig id="GUID-84072240-5DC6-5900-B767-FD13666A6639">
<image href="GUID-7F7A449F-CC19-570C-A6C1-BC470256AA8C_d0e147711_href.png" placement="inline"/>
</fig>
<p>Clients of a service can discover which applications implement a particular
service by using <xref href="GUID-5EEE8745-F483-33C0-A5B1-AEB5544DE2BA.dita"><apiname>RApaLsSession</apiname></xref>. This has a number of APIs
for retrieving an application list, filtered to only include applications
that implement a particular service. <codeph>RApaLsSession</codeph> can also
return other information about server applications, including how the services
are implemented as described by the opaque data field. If a service uses the
opaque data field to store localised strings to describe implementations,
these can be shown to the user. If a service uses structured data, a resource
reader can be created over the opaque data field to extract the data. </p>
<p>Also see the 'Service list' section in <xref href="GUID-A6116E8B-9C4A-5B9E-AA8A-BE031408AA2F.dita">Defining
application icons, captions and properties</xref>. </p>
<section><title>See also</title><p><xref href="GUID-940F3F6E-BA9C-5E19-9AC5-D848B5E175FB.dita">Application
Architecture Overview</xref></p></section>
</conbody></concept>