--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/browserui/browser/Launcher2/inc/LauncherClientService.h Mon Mar 30 12:49:49 2009 +0300
@@ -0,0 +1,156 @@
+/*
+* Copyright (c) 2002 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:
+*
+* Description: Header file for RLauncherClientService
+*
+*
+*/
+
+
+#ifndef __LAUNCHERCLIENTSERVICE_H
+#define __LAUNCHERCLIENTSERVICE_H
+
+// INCLUDE FILES
+#include <e32std.h>
+#include <e32base.h>
+#include <AknServerApp.h>
+#include "LauncherServerCommands.hrh"
+
+// FORWARD DECLARATIONS
+class CLauncherReceiveHandler;
+
+// CLASS DECLARATION
+// Observer class, observes server application events.
+class MLaunchedServerObserver: public MAknServerAppExitObserver
+ {
+public:
+
+ /**
+ * Notifies the client, that implements this class, about
+ * the server sent data.
+ * @param aStatus The status of the result of the completion.
+ */
+ virtual void HandleReceivedDataL( TRequestStatus aStatus ) = 0;
+
+ };
+
+// CLASS DECLARATION
+class RLauncherClientService : public RAknAppServiceBase
+ {
+public:
+ /**
+ * Returns the ID of this service.
+ * @return The UID of the service.
+ */
+ TUid ServiceUid() const;
+
+ /**
+ * Initializes this object. Call this before using this object.
+ * @param aServerAppUid The UID of the server application.
+ * @param aServerObserver Observes the server application.
+ */
+ void InitializeL( TUid aServerAppUid, MLaunchedServerObserver& aServerObserver );
+
+ /**
+ * Starts listening to the server application, so the observer
+ * will be notified about server application events.
+ */
+ void ListenL();
+
+ /**
+ * Stops listening to the server application, so the observer
+ * will not be notified about server application events.
+ */
+ void StopListening();
+
+ /**
+ * Destroy the object and release all memory objects
+ */
+ void Close();
+
+ /**
+ * Send data to process by the server application syncronously.
+ * @param aBufferToSend The data to send.
+ * @return The completion code of the processed data.
+ */
+ TInt SendSync( TDesC8& aBufferToSend );
+
+ /**
+ * Send data to process by the server application asyncronously.
+ * @param aBufferToSend Data to send.
+ * @param aBufferSize The size of the buffer which the client should
+ * allocate, to receive the data from server,
+ * before calling SendSyncBuffer() with the
+ * allocated descriptor. aBufferSize is defined
+ * by the server.
+ */
+ void SendAsync( TDesC8& aBufferToSend,TDes8& aBufferSize );
+
+ /**
+ * Send data to process by the server application asyncronously.
+ * @param aBufferToSend Data to send.
+ * @param aBufferSize The size of the buffer which the client should
+ * allocate, to receive the data from server,
+ * before calling SendSyncBuffer() with the
+ * allocated descriptor. aBufferSize is defined
+ * by the server.
+ */
+ void SendAsync();
+
+ void SendAsync(TDes8& aBufferSize );
+ /**
+ * Send data to process by the server application syncronously.
+ * @param aReceiveBuffer Buffer, which will be filled by the
+ * server application.
+ */
+ TInt SendSyncBuffer( TDes8 &aReceiveBuffer );
+
+ TInt SendSyncBools( TBool aClientWantsToContinue, TBool aWasContentHandled );
+
+ /**
+ * Send a command to execute by the server application. Server
+ * commands can be found in ServerCommands.hrh.
+ * Possibile commands: EOpenDownloadedContent, EServerExit.
+ * @param aCommand Command to send.
+ * @return The result of the processed command data.
+ */
+ TInt SendCommand( TInt aCommand );
+
+private:
+
+ /**
+ * Cancel receiving data.
+ */
+ void CancelReceive();
+
+public:
+
+ /*
+ * Observes server application exit. Owned!
+ */
+ CApaServerAppExitMonitor* iServerExitMonitor;
+
+ friend class CLauncherReceiveHandler;
+
+private:
+
+ /*
+ * Active object that is notified when receiving data ayncronously from
+ * server application. Internal use only. Owned!
+ */
+ CLauncherReceiveHandler* iActiveHandler;
+};
+
+#endif // __LAUNCHER_H
+
+// End of File
\ No newline at end of file