1 /*

     2 * Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the License "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Header file for CLauncherServerBase

    15 *

    16 *

    17 */

    18 

    19 

    20 #ifndef __LAUNCHERSERVERBASE_H__

    21 #define __LAUNCHERSERVERBASE_H__

    22 

    23 // INCLUDE FILES

    24 #include <e32base.h>

    25 #include <AknServerApp.h>

    26 

    27 // FORWARD DECLARATION

    28 class TBrowserOverriddenSettings;

    29 class CBrowserAppDocument;

    30 class CBrowserAppUi;

    31 

    32 // CLASS DECLARATION

    33 class CLauncherServerBase : public CAknAppServiceBase

    34 {

    35 public:

    36 

    37     /**

    38     * Default constructor

    39     */

    40     IMPORT_C CLauncherServerBase();

    41 

    42     /**

    43     * Handle incoming IPC messages.

    44     * @param aMessage Object which encapsulates a client request.

    45     */

    46     IMPORT_C void ServiceL( const RMessage2& aMessage );

    47     

    48     /**

    49     * Pointer to the Browser`s Ui.

    50     */    

    51     CBrowserAppUi* iBrowserAppUi; // not owned     

    52 

    53 private:

    54 

    55     /**

    56     * Handle syncronous messages. Parse the recieved message, 

    57     * and call ProcessMessageSyncL

    58     * @param aMessage Object which encapsulates a client request.

    59     */

    60     void HandleMessageSyncL( /*const RMessage2& aMessage*/ );

    61 

    62     /**

    63     * Handle asyncronous messages. Parse the recieved message, 

    64     * and call ProcessMessageASyncL.

    65     * @param aMessage Object which encapsulates a client request.

    66     */    

    67     void HandleMessageASyncL( /*const RMessage2& aMessage*/ );

    68 

    69     /**

    70     *

    71     * @param aMessage Object which encapsulates a client request.

    72     */    

    73     void HandleMessageSyncBufferL( /*const RMessage2& aMessage*/ );

    74 

    75     /**

    76     *

    77     * @param aMessage Object which encapsulates a client request.

    78     */    	

    79     void HandleMessageSyncBoolsL( /*const RMessage2& aMessage*/ );

    80 

    81     /**

    82     *

    83     * @param aMessage Object which encapsulates a client request.

    84     */    	

    85     void HandleBrowserExit( /*const RMessage2& aMessage*/ );

    86     

    87 

    88     /**

    89     * Process incoming messages syncronously.

    90     * @param aEmbeddingApplicationUid Embedding application`s UID	

    91     * @param aSettings Overridden user preferences.

    92     * @param aFolderUid Uid of the folder that the Browser should open.

    93     * @param aSeamlessParam 

    94     * @param aIsContentHandlerRegistered True if a content handler is registered

    95     * @return The result of processing. ( same as SendRecieve() )

    96     */ 

    97     virtual TInt ProcessMessageSyncL( TUid aEmbeddingApplicationUid, 

    98     								  TBrowserOverriddenSettings aSettings, 

    99     								  TInt aFolderUid, TPtrC aSeamlessParam, 

   100     								  TBool aIsContentHandlerRegistered ) = 0;

   101 

   102     /**

   103     * Process incoming messages asyncronously.

   104     * @param aEmbeddingApplicationUid Embedding application`s UID

   105     * @param aSettings Overridden user preferences.

   106     * @param aFolderUid Uid of the folder that the Browser should open.

   107     * @param aSeamlessParam

   108     * @param aIsContentHandlerRegistered True if a content handler is registered    

   109     * @param isOverridenSettings True if the client sended an overidden setting

   110     */

   111     virtual void ProcessMessageASyncL( TUid aEmbeddingApplicationUid, 

   112     								   TBrowserOverriddenSettings aSettings, 

   113     								   TInt aFolderUid, 

   114     								   TPtrC aSeamlessParam, 

   115     								   TBool aIsContentHandlerRegistered, 

   116     								   TBool aIsOverridenSettings ) = 0;

   117 

   118     /**

   119     * Process incoming messages asyncronously.

   120     * @param aMessage Object which encapsulates a client request.

   121     * @param aSettings Overridden user preferences.

   122     * @param aFolderUid Uid of the folder that the Browser should open.

   123     * @param aSeamlessParam  

   124     * @param aParam The index of the parameter, in SendRecieve() function`s

   125     * 		 parameters, which is the buffer on client side.

   126     */

   127     virtual TInt ProcessMessageSyncBufferL( ) = 0;

   128 

   129     /**

   130     * Process TBool parameters.

   131     */

   132     virtual void ProcessBoolsL( TBool aClientWantsToContinue, TBool aWasContentHandled ) = 0;

   133 

   134     /**

   135     * Process BrowserExit.

   136     */

   137     virtual void DoBrowserExit( ) = 0;       

   138 

   139 protected:

   140 

   141     /**

   142     * Buffer which will be copied to the client`s address

   143     * space on completing asyncronous requests.

   144     */

   145     HBufC8* iClientBuffer;

   146 

   147     /**

   148     * Pointer to the Browser`s document.

   149     */    

   150     CBrowserAppDocument* iBrowserDocument; // not owned

   151 

   152     /**

   153     * Object which encapsulates a copy of a client request.

   154     */	

   155     RMessage2 iMySyncMessage; // One slot for synchronous requests.

   156     RMessage2 iMyAsyncMessage; // One slot for asynchronous requests.

   157 

   158 /* Capability check will come later...

   159 public:

   160 	CLauncherServerBase( TCapability aClientReqs );

   161 

   162 private:

   163 	CPolicyServer::TCustomResult SecurityCheckL ( const RMessage2& aMsg, 

   164 												  TInt& aAction, 

   165 												  TSecurityInfo& aMissing );

   166 	TCapability iClientReqs;

   167 */

   168 };

   169 

   170 #endif // __LAUNCHERSERVERBASE_H__

   171 

   172 // End of File