<?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-D5AB2689-44B7-5E81-888A-48C622AAE21B" xml:lang="en"><title>Server_App_Minimal: A Minimal Server Application Example</title><prolog><metadata><keywords/></metadata></prolog><conbody>

<section id="GUID-D0826C33-5EBF-4268-8198-7ADCD4B0F04D"><title>Download</title> <p>Click on the following link to

download the example: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/zips/guid-4dedeed8-6e3c-4526-b563-d392c1a304b1.zip" scope="external"> ServerApp.zip</xref></p><p>Click: <xref href="guid-6013a680-57f9-415b-8851-c4fa63356636/guid-4dedeed8-6e3c-4526-b563-d392c1a304b1.html" scope="peer">browse</xref> to view the example code. </p> </section>

<section id="GUID-AFFE5651-EC7F-4A11-A1C0-2B9C5A395F40"><title>Description</title> <p>This example demonstrates a

minimal <xref href="GUID-F395C299-6C79-5A0E-8FCF-7931D8405E8A.dita">server

application</xref> making use of a minimal UI application. </p> <p>The example application consists of three sub-projects: </p> <ol id="GUID-CF779D0D-BC35-5FDF-BCC3-58679A2BD3DF">

<li id="GUID-27ABE9A8-A246-5126-BF41-ADEFB26E21F8"><p>A <b>harness</b> project which uses the Client API to generate a client request and

trigger the server application </p> </li>

<li id="GUID-4E5B08FF-D3C9-5C67-A407-CD7CAAD3F72F"><p>A <b>service_support</b> project consisting of Service Client Support and Service Implementation

Support. Both client-side and server application-side support are

built into a single DLL which encapsulates the IPC protocol between

client and server. </p> </li>

<li id="GUID-F34A779B-2FD0-546E-AE26-97B82762AD2C"><p>A <b>server_application</b> project that provides the entry point into the server application.

This sub-project consists of the Server class and of the actual Application. </p> </li>

</ol> </section>

<section id="GUID-761D68E4-86FD-4834-98C9-83EC4090F867"><title>Service support classes</title> <p> <b> Service Client

Support class (Client API)</b>  </p> <p>Client side service support

is provided through an <xref href="GUID-92F2DA99-0954-3399-9005-F3E817CB7E72.dita"><apiname>REikAppServiceBase</apiname></xref> derived

class, <codeph>RServAppService</codeph>. This class implements the

following required functions: </p> <ul>

<li id="GUID-4918FF70-90AF-5241-9822-89B5BB7A9461"><p> <xref href="GUID-2E824A1A-078A-3D43-8B49-DF6328330B51.dita#GUID-2E824A1A-078A-3D43-8B49-DF6328330B51/GUID-AC5BB41C-FA94-3459-9F1F-1887EFD62BD6"><apiname>RApaAppServiceBase::ServiceUid()

const</apiname></xref>, a pure virtual function </p> </li>

<li id="GUID-EFC0DB79-934C-59C6-8077-8C4A16D4C749"><p> <codeph>RServAppService::Send()</codeph> which sends a request to the server </p> </li>

</ul> <p> <b>Service Implementation Support class (Server Implementation

API)</b>  </p> <p>A <xref href="GUID-90450078-D05F-3EEB-8A5E-B7110943DD33.dita"><apiname>CApaAppServiceBase</apiname></xref> derived class, <codeph>CServAppSession</codeph>, provides Service

Implementation Support (support for the sessions connected to the

server). The main purpose of this class is to override the pure virtual

function <codeph>CSession2::ServiceL()</codeph>, such that a call

to the appropriate service support code is made. </p> <p>In this example, <codeph>CServAppSession</codeph> defines a pure virtual function, <codeph>Display()</codeph>, the functionality of which is implemented in

the server application. </p> </section>

<section id="GUID-0140D53A-D13D-4851-AF52-0011A54D6167"><title> Server application classes </title> <p> <b>Server

class</b>  </p> <p>The server class <codeph>CServAppServer</codeph> is derived from <xref href="GUID-F51AEC8F-2D7B-34AB-B2DE-E151D10263D1.dita"><apiname>CEikAppServer</apiname></xref> and implements

the function <codeph>CApaAppServer::CreateServiceL()</codeph>. This

function instantiates a session to handle the client request (by implementing

an appropriate service). </p> <p> <b>Session class</b>  </p> <p> <codeph>CMinimalSession</codeph> is a <xref href="GUID-90450078-D05F-3EEB-8A5E-B7110943DD33.dita"><apiname>CApaAppServiceBase</apiname></xref> derived class that represents the session connected to the server.

In order to handle the client request, this session class overrides

the pure virtual function <codeph>CServAppSession::Display()</codeph>. Thus, the client request is implemented. </p> <p> <b>UI classes</b>  </p> <p>Application class </p> <p>Document class </p> <p>Application

UI class </p> <p>View class </p> <p>These four classes are almost

the same as those in the minimal UI application example. A couple

of slight modifications have been made: </p> <ul>

<li id="GUID-C1B60851-0901-5DF1-9C56-8A03E37C14FF"><p> <codeph>CEikApplication::NewAppServerL()</codeph> has been overridden in the Application class <codeph>CExampleApplication</codeph> to launch a new server application instance. </p> </li>

<li id="GUID-6146169E-6C6D-513A-9ED6-AC33538ABAFD"><p> <codeph>CExampleAppView::Draw()</codeph> has been altered so that it produces an empty view. </p> </li>

</ul> </section>

<section id="GUID-BE71538C-3228-4419-A4C4-E9127DC2873D"><title> Summary of class hierarchy of the classes used </title> <fig id="GUID-AE7AA305-82B4-5BD3-87BF-A3E3D61F2DD1">

<title>              Key Classes            </title>

<image href="GUID-6C2A9928-5E5D-5F41-89C1-49C0EF14F900_d0e174946_href.png" placement="inline"/>

</fig> <p> <b>Service Support</b>  </p> <p> <xref href="GUID-2E824A1A-078A-3D43-8B49-DF6328330B51.dita"><apiname>RApaAppServiceBase</apiname></xref> -&gt; <xref href="GUID-92F2DA99-0954-3399-9005-F3E817CB7E72.dita"><apiname>REikAppServiceBase</apiname></xref> -&gt; <codeph>RServAppService</codeph>  </p> <p> <xref href="GUID-90450078-D05F-3EEB-8A5E-B7110943DD33.dita"><apiname>CApaAppServiceBase</apiname></xref> -&gt; <codeph>CServAppSession</codeph>  </p> <p> </p> <p> <b>Server Application</b>  </p> <p> <xref href="GUID-A056179D-64B3-3674-92F5-DE9B7749D450.dita"><apiname>CApaAppServer</apiname></xref> -&gt; <xref href="GUID-F51AEC8F-2D7B-34AB-B2DE-E151D10263D1.dita"><apiname>CEikAppServer</apiname></xref> -&gt; <codeph>CServAppServer</codeph>  </p> <p> <codeph>CServAppSession</codeph> -&gt; <codeph>CMinimalSession</codeph>  </p> <p> <xref href="GUID-C0297A58-2E39-3211-A2B4-C334192CE2A7.dita"><apiname>CApaApplication</apiname></xref> -&gt; <xref href="GUID-E36E2F07-09E7-32BC-BB83-14DF9232E7D9.dita"><apiname>CEikApplication</apiname></xref> -&gt; <codeph>CExampleApplication</codeph>  </p> <p> <xref href="GUID-B33A8A56-D1BE-3E3D-B5AC-F644A5C764DB.dita"><apiname>CEikDocument</apiname></xref> -&gt; <codeph>CExampleDocument</codeph>  </p> <p> <xref href="GUID-1185F595-0488-3E93-8D60-6B3A1A3AC32E.dita"><apiname>CEikAppUi</apiname></xref> -&gt; <codeph>CExampleAppUi</codeph>  </p> <p> <xref href="GUID-B06F99BD-F032-3B87-AB26-5DD6EBE8C160.dita"><apiname>CCoeControl</apiname></xref> -&gt; <codeph>CExampleAppView</codeph>  </p> </section>

</conbody></concept>