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