emailservices/nmclientapi/src/nmapimessagesearch_p.cpp
author hgs
Thu, 14 Oct 2010 17:33:43 +0300
changeset 76 38bf5461e270
parent 74 6c59112cfd31
permissions -rw-r--r--
201041
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
68
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2010 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
*       Email messages search private implementation.
hgs
parents:
diff changeset
    16
*/ 
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#include "nmapiheaders.h"
hgs
parents:
diff changeset
    19
76
hgs
parents: 74
diff changeset
    20
namespace EmailClientApi
hgs
parents: 74
diff changeset
    21
{
hgs
parents: 74
diff changeset
    22
68
hgs
parents:
diff changeset
    23
/*!
hgs
parents:
diff changeset
    24
    \class NmApiMessageSearchPrivate
hgs
parents:
diff changeset
    25
    \brief A Qt wrapper class for MFSMailBoxSearchObserver.
hgs
parents:
diff changeset
    26
*/
hgs
parents:
diff changeset
    27
hgs
parents:
diff changeset
    28
/*!
hgs
parents:
diff changeset
    29
    Class constructor.
hgs
parents:
diff changeset
    30
*/
hgs
parents:
diff changeset
    31
NmApiMessageSearchPrivate::NmApiMessageSearchPrivate(const quint64 mailboxId, QObject *parent) 
hgs
parents:
diff changeset
    32
: QObject(parent), 
hgs
parents:
diff changeset
    33
  mMailBox(NULL),
hgs
parents:
diff changeset
    34
  mIsRunning(false),
hgs
parents:
diff changeset
    35
  mEngine(NULL)
hgs
parents:
diff changeset
    36
{
hgs
parents:
diff changeset
    37
    NM_FUNCTION;
hgs
parents:
diff changeset
    38
    NmId mailBoxId(mailboxId);
hgs
parents:
diff changeset
    39
    mMailBoxId = TFSMailMsgId(mailBoxId);
hgs
parents:
diff changeset
    40
    mEngine = NmApiEngine::instance();
hgs
parents:
diff changeset
    41
}
hgs
parents:
diff changeset
    42
hgs
parents:
diff changeset
    43
/*!
hgs
parents:
diff changeset
    44
    Class destructor.
hgs
parents:
diff changeset
    45
*/
hgs
parents:
diff changeset
    46
NmApiMessageSearchPrivate::~NmApiMessageSearchPrivate()
hgs
parents:
diff changeset
    47
{
hgs
parents:
diff changeset
    48
    NM_FUNCTION;
hgs
parents:
diff changeset
    49
    
hgs
parents:
diff changeset
    50
    mSearchStrings.ResetAndDestroy();
hgs
parents:
diff changeset
    51
hgs
parents:
diff changeset
    52
    if (isRunning()) {
hgs
parents:
diff changeset
    53
        cancel();
hgs
parents:
diff changeset
    54
    }
hgs
parents:
diff changeset
    55
hgs
parents:
diff changeset
    56
    if (mMailBox){
hgs
parents:
diff changeset
    57
        delete mMailBox;
hgs
parents:
diff changeset
    58
        mMailBox = NULL;
hgs
parents:
diff changeset
    59
    }
hgs
parents:
diff changeset
    60
    
hgs
parents:
diff changeset
    61
    NmApiEngine::releaseInstance(mEngine);
hgs
parents:
diff changeset
    62
}
hgs
parents:
diff changeset
    63
hgs
parents:
diff changeset
    64
/*!
hgs
parents:
diff changeset
    65
 \fn isRunning 
hgs
parents:
diff changeset
    66
 \return true if search operation is running otherwise returns false.
hgs
parents:
diff changeset
    67
 
hgs
parents:
diff changeset
    68
 Returns information about search operation running.
hgs
parents:
diff changeset
    69
 */
hgs
parents:
diff changeset
    70
bool NmApiMessageSearchPrivate::isRunning() const
hgs
parents:
diff changeset
    71
{
hgs
parents:
diff changeset
    72
    return mIsRunning;
hgs
parents:
diff changeset
    73
}
hgs
parents:
diff changeset
    74
hgs
parents:
diff changeset
    75
/*!
hgs
parents:
diff changeset
    76
 \fn start 
hgs
parents:
diff changeset
    77
 \return true if operation was started otherwise returns false.
hgs
parents:
diff changeset
    78
 
hgs
parents:
diff changeset
    79
 Starts search operation for given criterias if operation is not running. Only one search can be performed at a time. 
hgs
parents:
diff changeset
    80
 Each found message signaled with messageFound(NmApiMessage &message).
hgs
parents:
diff changeset
    81
 Search completed signaled with searchComplete(int result).
hgs
parents:
diff changeset
    82
 Cancellation signalled with canceled().
hgs
parents:
diff changeset
    83
 */
hgs
parents:
diff changeset
    84
bool NmApiMessageSearchPrivate::start()
hgs
parents:
diff changeset
    85
{
hgs
parents:
diff changeset
    86
    NM_FUNCTION;
hgs
parents:
diff changeset
    87
    
hgs
parents:
diff changeset
    88
    bool ret = false;
hgs
parents:
diff changeset
    89
hgs
parents:
diff changeset
    90
    if (!isRunning() && mSearchStrings.Count() > 0) {
hgs
parents:
diff changeset
    91
        if (!mMailBox) {
hgs
parents:
diff changeset
    92
            initialiseMailbox();
hgs
parents:
diff changeset
    93
        }
hgs
parents:
diff changeset
    94
        
hgs
parents:
diff changeset
    95
        if (mMailBox) {
hgs
parents:
diff changeset
    96
            TRAPD(err, mMailBox->SearchL(mSearchStrings, mSortCriteria, *this));
hgs
parents:
diff changeset
    97
            if (err == KErrNone) {
hgs
parents:
diff changeset
    98
                mIsRunning = true;
hgs
parents:
diff changeset
    99
                ret = true;
hgs
parents:
diff changeset
   100
            }
hgs
parents:
diff changeset
   101
        }
hgs
parents:
diff changeset
   102
    }
hgs
parents:
diff changeset
   103
 
hgs
parents:
diff changeset
   104
    return ret;
hgs
parents:
diff changeset
   105
}
hgs
parents:
diff changeset
   106
hgs
parents:
diff changeset
   107
/*!
hgs
parents:
diff changeset
   108
    From MFSMailBoxSearchObserver.
hgs
parents:
diff changeset
   109
    Converts the ID of the received message into NmId and emits it with the
hgs
parents:
diff changeset
   110
    signal notifying that a match was found.
hgs
parents:
diff changeset
   111
hgs
parents:
diff changeset
   112
    \param aMatchMessage A message that matches the search criteria. This class
hgs
parents:
diff changeset
   113
                         takes the ownership of the given instance.
hgs
parents:
diff changeset
   114
*/
hgs
parents:
diff changeset
   115
void NmApiMessageSearchPrivate::MatchFoundL(CFSMailMessage *aMatchMessage)
hgs
parents:
diff changeset
   116
{
hgs
parents:
diff changeset
   117
    NM_FUNCTION;
hgs
parents:
diff changeset
   118
    
hgs
parents:
diff changeset
   119
    if (aMatchMessage) {
hgs
parents:
diff changeset
   120
        NmMessage *nmmessage = aMatchMessage->GetNmMessage();
76
hgs
parents: 74
diff changeset
   121
        NmApiMessage message = NmToApiConverter::NmMessage2NmApiMessage(*nmmessage);
68
hgs
parents:
diff changeset
   122
        emit messageFound(message);
74
hgs
parents: 68
diff changeset
   123
        
hgs
parents: 68
diff changeset
   124
        delete nmmessage;
hgs
parents: 68
diff changeset
   125
        nmmessage = NULL;
hgs
parents: 68
diff changeset
   126
        
68
hgs
parents:
diff changeset
   127
        delete aMatchMessage;
hgs
parents:
diff changeset
   128
        aMatchMessage = NULL;
hgs
parents:
diff changeset
   129
     }
hgs
parents:
diff changeset
   130
}
hgs
parents:
diff changeset
   131
hgs
parents:
diff changeset
   132
hgs
parents:
diff changeset
   133
/*!
hgs
parents:
diff changeset
   134
    From MFSMailBoxSearchObserver.
hgs
parents:
diff changeset
   135
    Emits a signal to notify that the search is complete.
hgs
parents:
diff changeset
   136
*/
hgs
parents:
diff changeset
   137
void NmApiMessageSearchPrivate::SearchCompletedL()
hgs
parents:
diff changeset
   138
{
hgs
parents:
diff changeset
   139
    NM_FUNCTION;
hgs
parents:
diff changeset
   140
    mIsRunning = false;
76
hgs
parents: 74
diff changeset
   141
    emit searchComplete(NmApiNoError); 
68
hgs
parents:
diff changeset
   142
}
hgs
parents:
diff changeset
   143
hgs
parents:
diff changeset
   144
hgs
parents:
diff changeset
   145
/*!
hgs
parents:
diff changeset
   146
    From MFSMailBoxSearchObserver.
hgs
parents:
diff changeset
   147
*/
hgs
parents:
diff changeset
   148
void NmApiMessageSearchPrivate::ClientRequiredSearchPriority(
hgs
parents:
diff changeset
   149
    TInt *apRequiredSearchPriority)
hgs
parents:
diff changeset
   150
{
hgs
parents:
diff changeset
   151
    Q_UNUSED(apRequiredSearchPriority);
hgs
parents:
diff changeset
   152
}
hgs
parents:
diff changeset
   153
hgs
parents:
diff changeset
   154
/*!
hgs
parents:
diff changeset
   155
 \fn cancel 
hgs
parents:
diff changeset
   156
 
hgs
parents:
diff changeset
   157
 Cancels current search operation. If operation is not running, nothing happens.  
hgs
parents:
diff changeset
   158
 Cancellation signalled with canceled().
hgs
parents:
diff changeset
   159
 */
hgs
parents:
diff changeset
   160
void NmApiMessageSearchPrivate::cancel()
hgs
parents:
diff changeset
   161
{
hgs
parents:
diff changeset
   162
    NM_FUNCTION;
hgs
parents:
diff changeset
   163
    
hgs
parents:
diff changeset
   164
    if (isRunning()){
hgs
parents:
diff changeset
   165
        if (mMailBox) {
hgs
parents:
diff changeset
   166
            mMailBox->CancelSearch();
hgs
parents:
diff changeset
   167
            mMailBox->ClearSearchResultCache();
hgs
parents:
diff changeset
   168
hgs
parents:
diff changeset
   169
            mSearchStrings.ResetAndDestroy();
hgs
parents:
diff changeset
   170
            mSortCriteria.iField = EFSMailDontCare;
hgs
parents:
diff changeset
   171
            mSortCriteria.iOrder = EFSMailAscending;
hgs
parents:
diff changeset
   172
            mIsRunning = false;
hgs
parents:
diff changeset
   173
            emit canceled();
hgs
parents:
diff changeset
   174
        }
hgs
parents:
diff changeset
   175
    }
hgs
parents:
diff changeset
   176
}
hgs
parents:
diff changeset
   177
hgs
parents:
diff changeset
   178
/*!
hgs
parents:
diff changeset
   179
 \fn initialise 
hgs
parents:
diff changeset
   180
 \param searchStrings List of search criteria strings.
hgs
parents:
diff changeset
   181
 \param sortCriteria Sort criteria for search.
hgs
parents:
diff changeset
   182
 \return true if initializing is successfully completed otherwise returns false.
hgs
parents:
diff changeset
   183
 
hgs
parents:
diff changeset
   184
 Initialize search criterias.  
hgs
parents:
diff changeset
   185
 */
76
hgs
parents: 74
diff changeset
   186
bool NmApiMessageSearchPrivate::initialise(const QList<QString> &searchStrings, NmApiMailSortCriteria sortCriteria)
68
hgs
parents:
diff changeset
   187
{
hgs
parents:
diff changeset
   188
    NM_FUNCTION;
hgs
parents:
diff changeset
   189
    bool ret = false;
hgs
parents:
diff changeset
   190
hgs
parents:
diff changeset
   191
    if (!isRunning() && searchStrings.count() > 0) {
hgs
parents:
diff changeset
   192
        bool appendError = false;
hgs
parents:
diff changeset
   193
        mSortCriteria.iField = TFSMailSortField(sortCriteria.iField);
hgs
parents:
diff changeset
   194
        mSortCriteria.iOrder = TFSMailSortOrder(sortCriteria.iOrder);
hgs
parents:
diff changeset
   195
       
hgs
parents:
diff changeset
   196
        mSearchStrings.ResetAndDestroy();
hgs
parents:
diff changeset
   197
        
hgs
parents:
diff changeset
   198
        for (int i = 0; i < searchStrings.count() && !appendError; ++i) {
hgs
parents:
diff changeset
   199
            HBufC *buffer = XQConversions::qStringToS60Desc(searchStrings.at(i));
hgs
parents:
diff changeset
   200
            TRAPD(err, mSearchStrings.AppendL(buffer));
hgs
parents:
diff changeset
   201
            if (err != KErrNone) {
hgs
parents:
diff changeset
   202
                appendError = true;
hgs
parents:
diff changeset
   203
            }
hgs
parents:
diff changeset
   204
        }
hgs
parents:
diff changeset
   205
        
hgs
parents:
diff changeset
   206
        if (!appendError) {
hgs
parents:
diff changeset
   207
            ret = true;
hgs
parents:
diff changeset
   208
        }
hgs
parents:
diff changeset
   209
        else {
hgs
parents:
diff changeset
   210
            mSearchStrings.ResetAndDestroy();
hgs
parents:
diff changeset
   211
        }
hgs
parents:
diff changeset
   212
    }
hgs
parents:
diff changeset
   213
    
hgs
parents:
diff changeset
   214
    return ret;
hgs
parents:
diff changeset
   215
}
hgs
parents:
diff changeset
   216
hgs
parents:
diff changeset
   217
/*!
hgs
parents:
diff changeset
   218
 \fn initialiseMailbox 
hgs
parents:
diff changeset
   219
 
hgs
parents:
diff changeset
   220
 Initializes mailbox.  
hgs
parents:
diff changeset
   221
 */
hgs
parents:
diff changeset
   222
void NmApiMessageSearchPrivate::initialiseMailbox()
hgs
parents:
diff changeset
   223
{
hgs
parents:
diff changeset
   224
    NM_FUNCTION;
hgs
parents:
diff changeset
   225
    RPointerArray<CFSMailPlugin> mailPlugins;
hgs
parents:
diff changeset
   226
    if (mEngine) {
hgs
parents:
diff changeset
   227
        mEngine->listMailPlugins(mailPlugins);
74
hgs
parents: 68
diff changeset
   228
hgs
parents: 68
diff changeset
   229
        for (int i = 0; i < mailPlugins.Count() && !mMailBox; i++){
hgs
parents: 68
diff changeset
   230
            if (mailPlugins[i]->Id() == mMailBoxId.PluginId()) {
hgs
parents: 68
diff changeset
   231
                TRAPD(err, mMailBox = mailPlugins[i]->GetMailBoxByUidL(mMailBoxId));
hgs
parents: 68
diff changeset
   232
                Q_UNUSED(err);
68
hgs
parents:
diff changeset
   233
            }
hgs
parents:
diff changeset
   234
        }
hgs
parents:
diff changeset
   235
    }
hgs
parents:
diff changeset
   236
}
76
hgs
parents: 74
diff changeset
   237
}
68
hgs
parents:
diff changeset
   238
// End of file.