activityfw/activitydatabase/hsactivitydbclient/s60/inc/hsactivitydbclient_p.h
changeset 61 8e5041d13c84
child 66 32469d7d46ff
equal deleted inserted replaced
60:f62f87b200ec 61:8e5041d13c84
       
     1 /*
       
     2 * Copyright (c) 2009 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 "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:
       
    15 *
       
    16 */
       
    17 
       
    18 #ifndef HSACTIVITYDBCLIENTPRIVATE_H
       
    19 #define HSACTIVITYDBCLIENTPRIVATE_H
       
    20 #include "hsactivitydbclientinterface.h"
       
    21 #include <e32base.h>
       
    22 #include <hsactivitydbasyncrequestobserver.h>
       
    23 
       
    24 class HsActivityDbAsyncRequestPrivate;
       
    25 /**
       
    26  * Class implemets HsActivityDbClientInterface and is responsible for 
       
    27  * activity data management on S60 enviroment.
       
    28  */
       
    29 class HsActivityDbClientPrivate : protected RSessionBase,
       
    30                                   public HsActivityDbClientInterface
       
    31 {
       
    32 public:
       
    33     /**
       
    34      * Constructor
       
    35      */
       
    36     HsActivityDbClientPrivate(HsActivityDbAsyncRequestObserver&);
       
    37     
       
    38     /**
       
    39      * Destructor
       
    40      */
       
    41     ~HsActivityDbClientPrivate();
       
    42     
       
    43     /**
       
    44      * Function establish connection to activity server
       
    45      * @return 0 on succees, error code otherwise
       
    46      */
       
    47     int connect();
       
    48     
       
    49     /**
       
    50      * Interface implementation.
       
    51      * @see int HsActivityDbClientInterface::addActivity(const QVariantHash &)
       
    52      */
       
    53     int addActivity(const QVariantHash &);
       
    54     
       
    55     /**
       
    56      * Interface implementation.
       
    57      * @see int HsActivityDbClientInterface::updateActivity(const QVariantHash &)
       
    58      */
       
    59     int updateActivity(const QVariantHash &);
       
    60     
       
    61     /**
       
    62      * Interface implementation.
       
    63      * @see int HsActivityDbClientInterface::removeActivity(const QVariantHash &)
       
    64      */
       
    65     int removeActivity(const QVariantHash &activity);
       
    66     
       
    67     /**
       
    68      * Interface implementation.
       
    69      * @see int HsActivityDbClientInterface::removeApplicationActivities(const QVariantHash &)
       
    70     */
       
    71     int removeApplicationActivities(const QVariantHash &activity);
       
    72     
       
    73     /**
       
    74      * Interface implementation.
       
    75      * @see int HsActivityDbClientInterface::requestedActivityName(QString &, const QVariantHash &);
       
    76      */
       
    77     int requestedActivityName(QString &, const QVariantHash &);
       
    78     
       
    79     /**
       
    80      * Interface implementation.
       
    81      * @see int HsActivityDbClientInterface::activities(QList<QVariantHash> &);
       
    82      */
       
    83     int activities(QList<QVariantHash> &);
       
    84     
       
    85     /**
       
    86      * Interface implementation.
       
    87      * @see int HsActivityDbClientInterface::applicationActivities(QList<QVariantHash> &, const QVariantHash &)
       
    88      */
       
    89     int applicationActivities(QList<QVariantHash>&, const QVariantHash &);
       
    90     
       
    91     /**
       
    92      * Interface implementation.
       
    93      * @see int HsActivityDbClientInterface::waitActivity(const QVariantHash &)
       
    94      */
       
    95     int waitActivity(const QVariantHash &activity);
       
    96     
       
    97     /**
       
    98      * Interface implementation.
       
    99      * @see int HsActivityDbClientInterface::launchActivity(const QVariantHash &)
       
   100      */
       
   101     int launchActivity(const QVariantHash &);
       
   102 
       
   103     /**
       
   104      * Interface implementation.
       
   105      * @see int HsActivityDbClientInterface::cancelWaitActivity()
       
   106      */
       
   107     int cancelWaitActivity();
       
   108     
       
   109 public:
       
   110     /**
       
   111      * Function get cached data from server
       
   112      * @param dst - destination, preallocated buffer
       
   113      */
       
   114     void getData(RBuf8 & dst);
       
   115     
       
   116     /**
       
   117      * Function initialize aync request
       
   118      * @param func - requested function
       
   119      * @param data - request data
       
   120      * @param status - request status
       
   121      */
       
   122     void sendDataAsync(int func,const TIpcArgs & data, TRequestStatus& status);
       
   123     
       
   124 private:
       
   125     /**
       
   126      * Function start activity server process.
       
   127      * Function can leave on failure.
       
   128      */
       
   129     void startServerL();
       
   130     
       
   131     /**
       
   132      * Function establish connection to activity server.
       
   133      * Function can leave on failure
       
   134      */
       
   135     void connectL();
       
   136     
       
   137     /**
       
   138      * Function execute remote call request.
       
   139      * @param function - remote function identyfier
       
   140      * @param activity - remote function parameters  
       
   141      */
       
   142     void execSimpleRequestL( int function, const QVariantHash &activity);
       
   143     
       
   144     /**
       
   145      * Function retrieve current activity name for application.
       
   146      * Function can leave on failure
       
   147      * @param  result - activity name
       
   148      * @param activity - request filtering rules 
       
   149      */
       
   150     void requestedActivityNameL(QString& result, 
       
   151                                 const QVariantHash &activity);
       
   152     
       
   153     /**
       
   154      * Function retrieve all stored activity
       
   155      * Function can leave on failure
       
   156      * @param result - list of activity 
       
   157      */
       
   158     void activitiesL(QList<QVariantHash>& result);
       
   159     
       
   160     /**
       
   161      * Function retrieve all stored activity
       
   162      * Function can leave on failure
       
   163      * @param result - list of activity
       
   164      * @param cond - request conditions  
       
   165      */
       
   166     void applicationActivitiesL(QList<QVariantHash>& result, 
       
   167                                 const QVariantHash & cond);
       
   168     
       
   169     void waitActivityL(const QVariantHash &activity);
       
   170 private:
       
   171     /**
       
   172      * Async request handler
       
   173      * Own
       
   174      */
       
   175     HsActivityDbAsyncRequestPrivate* mAsyncDataHandler; 
       
   176 
       
   177 };
       
   178 #endif // HSACTIVITYDBCLIENTPRIVATE_H