activityfw/activitydatabase/hsactivitydbserver/inc/hsactivitystorage_p.h
author hgs
Fri, 26 Mar 2010 13:00:55 +0200
changeset 91 a6d55a2e75be
parent 90 0e41c72311af
child 92 782e3408c2ab
permissions -rw-r--r--
201011_03
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
89
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
#ifndef HSACTIVITYSTORAGEPRIVATE_H
hgs
parents:
diff changeset
    18
#define HSACTIVITYSTORAGEPRIVATE_H
hgs
parents:
diff changeset
    19
#include "hsactivitydbclientinterface.h"
hgs
parents:
diff changeset
    20
#include <QSqlDatabase>
hgs
parents:
diff changeset
    21
hgs
parents:
diff changeset
    22
/**
hgs
parents:
diff changeset
    23
 * Class implements HsActivityDbClientInterface and storage functionality using
hgs
parents:
diff changeset
    24
 * database subsystem 
hgs
parents:
diff changeset
    25
 */
hgs
parents:
diff changeset
    26
class HsActivityStoragePrivate: public HsActivityDbClientInterface
hgs
parents:
diff changeset
    27
{
hgs
parents:
diff changeset
    28
public:
hgs
parents:
diff changeset
    29
    /**
hgs
parents:
diff changeset
    30
     * Constructor
hgs
parents:
diff changeset
    31
     */
hgs
parents:
diff changeset
    32
    HsActivityStoragePrivate();
hgs
parents:
diff changeset
    33
    
hgs
parents:
diff changeset
    34
    /**
hgs
parents:
diff changeset
    35
     * Destructor
hgs
parents:
diff changeset
    36
     */
hgs
parents:
diff changeset
    37
    ~HsActivityStoragePrivate();
hgs
parents:
diff changeset
    38
    
hgs
parents:
diff changeset
    39
    /**
hgs
parents:
diff changeset
    40
     * Interface implementation.
hgs
parents:
diff changeset
    41
     * @see int HsActivityDbClientInterface::addActivity(const QVariantHash&)
hgs
parents:
diff changeset
    42
     */
hgs
parents:
diff changeset
    43
    int addActivity(const QVariantHash &);
hgs
parents:
diff changeset
    44
    
hgs
parents:
diff changeset
    45
    /**
hgs
parents:
diff changeset
    46
     * Interface implementation.
hgs
parents:
diff changeset
    47
     * @see int HsActivityDbClientInterface::updateActivity(const QVariantHash&)
hgs
parents:
diff changeset
    48
     */
hgs
parents:
diff changeset
    49
    int updateActivity(const QVariantHash &);
hgs
parents:
diff changeset
    50
    
hgs
parents:
diff changeset
    51
    /**
hgs
parents:
diff changeset
    52
     * Interface implementation.
hgs
parents:
diff changeset
    53
     * @see int HsActivityDbClientInterface::removeActivity(const QVariantHash &)
hgs
parents:
diff changeset
    54
     */
hgs
parents:
diff changeset
    55
    int removeActivity(const QVariantHash &activity);
hgs
parents:
diff changeset
    56
hgs
parents:
diff changeset
    57
   /**
hgs
parents:
diff changeset
    58
    * Interface implementation.
hgs
parents:
diff changeset
    59
    * @see int HsActivityDbClientInterface::removeApplicationActivities(const QVariantHash &)
hgs
parents:
diff changeset
    60
    */
hgs
parents:
diff changeset
    61
    int removeApplicationActivities(const QVariantHash &activity);
hgs
parents:
diff changeset
    62
hgs
parents:
diff changeset
    63
    /**
hgs
parents:
diff changeset
    64
     * Interface implementation.
hgs
parents:
diff changeset
    65
     * @see int HsActivityDbClientInterface::requestedActivityName( QString &, const QVariantHash &)
hgs
parents:
diff changeset
    66
     */
hgs
parents:
diff changeset
    67
    int requestedActivityName(QString& result, 
hgs
parents:
diff changeset
    68
                              const QVariantHash &activity);
hgs
parents:
diff changeset
    69
    
hgs
parents:
diff changeset
    70
    /**
hgs
parents:
diff changeset
    71
     * Interface implementation.
hgs
parents:
diff changeset
    72
     * @see int HsActivityDbClientInterface::activities(QList<QVariantHash> &)
hgs
parents:
diff changeset
    73
     */
hgs
parents:
diff changeset
    74
    int activities(QList<QVariantHash> &);
hgs
parents:
diff changeset
    75
    
hgs
parents:
diff changeset
    76
    /**
hgs
parents:
diff changeset
    77
     * Interface implementation.
hgs
parents:
diff changeset
    78
     * @see int HsActivityDbClientInterface::applicationActivities(QList<QVariantHash> &, const QVariantHash &)
hgs
parents:
diff changeset
    79
     */
hgs
parents:
diff changeset
    80
    int applicationActivities(QList<QVariantHash> &, const QVariantHash &);
hgs
parents:
diff changeset
    81
    
hgs
parents:
diff changeset
    82
    /**
hgs
parents:
diff changeset
    83
     * Interface implementation.
hgs
parents:
diff changeset
    84
     * @see int HsActivityDbClientInterface::waitActivity(const QVariantHash &)
hgs
parents:
diff changeset
    85
     */
hgs
parents:
diff changeset
    86
    int waitActivity(const QVariantHash &activity);
hgs
parents:
diff changeset
    87
    
hgs
parents:
diff changeset
    88
    /**
hgs
parents:
diff changeset
    89
     * Interface implementation.
hgs
parents:
diff changeset
    90
     * @see int HsActivityDbClientInterface::launchActivity(const QVariantHash &)
hgs
parents:
diff changeset
    91
     */
hgs
parents:
diff changeset
    92
    int launchActivity(const QVariantHash &activity);
hgs
parents:
diff changeset
    93
private:
hgs
parents:
diff changeset
    94
    /**
hgs
parents:
diff changeset
    95
     * Function check database structure
hgs
parents:
diff changeset
    96
     * @return true if structure is valid, false otherwise
hgs
parents:
diff changeset
    97
     */
hgs
parents:
diff changeset
    98
    bool checkTables();
hgs
parents:
diff changeset
    99
    
hgs
parents:
diff changeset
   100
    /**
hgs
parents:
diff changeset
   101
     * Function create database structure
hgs
parents:
diff changeset
   102
     */
hgs
parents:
diff changeset
   103
    void recreateTables();
hgs
parents:
diff changeset
   104
    
hgs
parents:
diff changeset
   105
    /**
hgs
parents:
diff changeset
   106
     * Function return last SQL query error code
hgs
parents:
diff changeset
   107
     * @param querty - executed sql query
hgs
parents:
diff changeset
   108
     * @return SQL query error code  
hgs
parents:
diff changeset
   109
     */
hgs
parents:
diff changeset
   110
    int getSqlErrorCode(const QSqlQuery& query);
hgs
parents:
diff changeset
   111
    
hgs
parents:
diff changeset
   112
    /**
hgs
parents:
diff changeset
   113
     * Function exeute SQL query
hgs
parents:
diff changeset
   114
     * @param query - SQL 
hgs
parents:
diff changeset
   115
     * @return true on succees, false otherwise
hgs
parents:
diff changeset
   116
     */
hgs
parents:
diff changeset
   117
    bool exec(QSqlQuery& query);
hgs
parents:
diff changeset
   118
    
hgs
parents:
diff changeset
   119
    /**
hgs
parents:
diff changeset
   120
     * Function exeute SQL query
hgs
parents:
diff changeset
   121
     * @param query - SQL query that has to be executed
hgs
parents:
diff changeset
   122
     * @return true on succees, false otherwise
hgs
parents:
diff changeset
   123
     */
hgs
parents:
diff changeset
   124
    bool exec(const QString &query, const QVariantHash& params);
hgs
parents:
diff changeset
   125
    
hgs
parents:
diff changeset
   126
    /**
hgs
parents:
diff changeset
   127
     * Funciton bind provided filtering rules with prepared SQL query
hgs
parents:
diff changeset
   128
     * @param query - SQL query 
hgs
parents:
diff changeset
   129
     * @param activity - filtering rules
hgs
parents:
diff changeset
   130
     * @param additionalData - additional filetering rules
hgs
parents:
diff changeset
   131
     */
hgs
parents:
diff changeset
   132
    void bind( QSqlQuery& query, 
hgs
parents:
diff changeset
   133
               const QVariantHash &activity, 
hgs
parents:
diff changeset
   134
               const QVariantHash &additionalData = QVariantHash());
hgs
parents:
diff changeset
   135
    
hgs
parents:
diff changeset
   136
    /**
hgs
parents:
diff changeset
   137
     * Funciton get records that match conditions
hgs
parents:
diff changeset
   138
     * @param result - output destination 
hgs
parents:
diff changeset
   139
     * @param query - SQL query sting
hgs
parents:
diff changeset
   140
     * @param conditions - query conditions
hgs
parents:
diff changeset
   141
     */
hgs
parents:
diff changeset
   142
    int activities(QList<QVariantHash> &results, 
hgs
parents:
diff changeset
   143
                   const QString &query,
hgs
parents:
diff changeset
   144
                   const QVariantHash &conditions);
hgs
parents:
diff changeset
   145
hgs
parents:
diff changeset
   146
private:
hgs
parents:
diff changeset
   147
    /**
hgs
parents:
diff changeset
   148
     * Connectioin to SQL engine
hgs
parents:
diff changeset
   149
     */
hgs
parents:
diff changeset
   150
    QSqlDatabase mConn;
hgs
parents:
diff changeset
   151
};
hgs
parents:
diff changeset
   152
#endif //HSACTIVITYSTORAGEPRIVATE_H