activityfw/activitydatabase/hsactivitydbserver/inc/hsactivitystorage_p.h
author hgs
Fri, 16 Apr 2010 14:45:49 +0300
changeset 92 782e3408c2ab
parent 90 0e41c72311af
permissions -rw-r--r--
201015
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
92
hgs
parents: 90
diff changeset
    24
 * database subsystem
89
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();
92
hgs
parents: 90
diff changeset
    33
89
hgs
parents:
diff changeset
    34
    /**
hgs
parents:
diff changeset
    35
     * Destructor
hgs
parents:
diff changeset
    36
     */
hgs
parents:
diff changeset
    37
    ~HsActivityStoragePrivate();
92
hgs
parents: 90
diff changeset
    38
89
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 &);
92
hgs
parents: 90
diff changeset
    44
89
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 &);
92
hgs
parents: 90
diff changeset
    50
89
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
92
hgs
parents: 90
diff changeset
    57
    /**
hgs
parents: 90
diff changeset
    58
     * Interface implementation.
hgs
parents: 90
diff changeset
    59
     * @see int HsActivityDbClientInterface::removeApplicationActivities(const QVariantHash &)
hgs
parents: 90
diff changeset
    60
     */
89
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
     */
92
hgs
parents: 90
diff changeset
    67
    int requestedActivityName(QString &result,
89
hgs
parents:
diff changeset
    68
                              const QVariantHash &activity);
92
hgs
parents: 90
diff changeset
    69
89
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> &);
92
hgs
parents: 90
diff changeset
    75
89
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 &);
92
hgs
parents: 90
diff changeset
    81
89
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);
92
hgs
parents: 90
diff changeset
    87
89
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();
92
hgs
parents: 90
diff changeset
    99
89
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();
92
hgs
parents: 90
diff changeset
   104
89
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
92
hgs
parents: 90
diff changeset
   108
     * @return SQL query error code
89
hgs
parents:
diff changeset
   109
     */
92
hgs
parents: 90
diff changeset
   110
    int getSqlErrorCode(const QSqlQuery &query);
hgs
parents: 90
diff changeset
   111
89
hgs
parents:
diff changeset
   112
    /**
hgs
parents:
diff changeset
   113
     * Function exeute SQL query
92
hgs
parents: 90
diff changeset
   114
     * @param query - SQL
89
hgs
parents:
diff changeset
   115
     * @return true on succees, false otherwise
hgs
parents:
diff changeset
   116
     */
92
hgs
parents: 90
diff changeset
   117
    bool exec(QSqlQuery &query);
hgs
parents: 90
diff changeset
   118
89
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
     */
92
hgs
parents: 90
diff changeset
   124
    bool exec(const QString &query, const QVariantHash &params);
hgs
parents: 90
diff changeset
   125
89
hgs
parents:
diff changeset
   126
    /**
hgs
parents:
diff changeset
   127
     * Funciton bind provided filtering rules with prepared SQL query
92
hgs
parents: 90
diff changeset
   128
     * @param query - SQL query
89
hgs
parents:
diff changeset
   129
     * @param activity - filtering rules
hgs
parents:
diff changeset
   130
     * @param additionalData - additional filetering rules
hgs
parents:
diff changeset
   131
     */
92
hgs
parents: 90
diff changeset
   132
    void bind(QSqlQuery &query,
hgs
parents: 90
diff changeset
   133
              const QVariantHash &activity,
hgs
parents: 90
diff changeset
   134
              const QVariantHash &additionalData = QVariantHash());
hgs
parents: 90
diff changeset
   135
89
hgs
parents:
diff changeset
   136
    /**
hgs
parents:
diff changeset
   137
     * Funciton get records that match conditions
92
hgs
parents: 90
diff changeset
   138
     * @param result - output destination
89
hgs
parents:
diff changeset
   139
     * @param query - SQL query sting
hgs
parents:
diff changeset
   140
     * @param conditions - query conditions
hgs
parents:
diff changeset
   141
     */
92
hgs
parents: 90
diff changeset
   142
    int activities(QList<QVariantHash> &results,
89
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