emailservices/nmclientapi/src/nmapimessagesearch_p.cpp
author hgs
Wed, 15 Sep 2010 12:09:55 +0300
changeset 68 83cc6bae1de8
child 74 6c59112cfd31
permissions -rw-r--r--
201037
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);
hgs
parents:
diff changeset
   120
        delete aMatchMessage;
hgs
parents:
diff changeset
   121
        aMatchMessage = NULL;
hgs
parents:
diff changeset
   122
     }
hgs
parents:
diff changeset
   123
}
hgs
parents:
diff changeset
   124
hgs
parents:
diff changeset
   125
hgs
parents:
diff changeset
   126
/*!
hgs
parents:
diff changeset
   127
    From MFSMailBoxSearchObserver.
hgs
parents:
diff changeset
   128
    Emits a signal to notify that the search is complete.
hgs
parents:
diff changeset
   129
*/
hgs
parents:
diff changeset
   130
void NmApiMessageSearchPrivate::SearchCompletedL()
hgs
parents:
diff changeset
   131
{
hgs
parents:
diff changeset
   132
    NM_FUNCTION;
hgs
parents:
diff changeset
   133
    mIsRunning = false;
hgs
parents:
diff changeset
   134
    emit searchComplete(EmailClientApi::NmApiNoError); 
hgs
parents:
diff changeset
   135
}
hgs
parents:
diff changeset
   136
hgs
parents:
diff changeset
   137
hgs
parents:
diff changeset
   138
/*!
hgs
parents:
diff changeset
   139
    From MFSMailBoxSearchObserver.
hgs
parents:
diff changeset
   140
*/
hgs
parents:
diff changeset
   141
void NmApiMessageSearchPrivate::ClientRequiredSearchPriority(
hgs
parents:
diff changeset
   142
    TInt *apRequiredSearchPriority)
hgs
parents:
diff changeset
   143
{
hgs
parents:
diff changeset
   144
    Q_UNUSED(apRequiredSearchPriority);
hgs
parents:
diff changeset
   145
}
hgs
parents:
diff changeset
   146
hgs
parents:
diff changeset
   147
/*!
hgs
parents:
diff changeset
   148
 \fn cancel 
hgs
parents:
diff changeset
   149
 
hgs
parents:
diff changeset
   150
 Cancels current search operation. If operation is not running, nothing happens.  
hgs
parents:
diff changeset
   151
 Cancellation signalled with canceled().
hgs
parents:
diff changeset
   152
 */
hgs
parents:
diff changeset
   153
void NmApiMessageSearchPrivate::cancel()
hgs
parents:
diff changeset
   154
{
hgs
parents:
diff changeset
   155
    NM_FUNCTION;
hgs
parents:
diff changeset
   156
    
hgs
parents:
diff changeset
   157
    if (isRunning()){
hgs
parents:
diff changeset
   158
        if (mMailBox) {
hgs
parents:
diff changeset
   159
            mMailBox->CancelSearch();
hgs
parents:
diff changeset
   160
            mMailBox->ClearSearchResultCache();
hgs
parents:
diff changeset
   161
hgs
parents:
diff changeset
   162
            mSearchStrings.ResetAndDestroy();
hgs
parents:
diff changeset
   163
            mSortCriteria.iField = EFSMailDontCare;
hgs
parents:
diff changeset
   164
            mSortCriteria.iOrder = EFSMailAscending;
hgs
parents:
diff changeset
   165
            mIsRunning = false;
hgs
parents:
diff changeset
   166
            emit canceled();
hgs
parents:
diff changeset
   167
        }
hgs
parents:
diff changeset
   168
    }
hgs
parents:
diff changeset
   169
}
hgs
parents:
diff changeset
   170
hgs
parents:
diff changeset
   171
/*!
hgs
parents:
diff changeset
   172
 \fn initialise 
hgs
parents:
diff changeset
   173
 \param searchStrings List of search criteria strings.
hgs
parents:
diff changeset
   174
 \param sortCriteria Sort criteria for search.
hgs
parents:
diff changeset
   175
 \return true if initializing is successfully completed otherwise returns false.
hgs
parents:
diff changeset
   176
 
hgs
parents:
diff changeset
   177
 Initialize search criterias.  
hgs
parents:
diff changeset
   178
 */
hgs
parents:
diff changeset
   179
bool NmApiMessageSearchPrivate::initialise(const QList<QString> &searchStrings, EmailClientApi::NmApiMailSortCriteria sortCriteria)
hgs
parents:
diff changeset
   180
{
hgs
parents:
diff changeset
   181
    NM_FUNCTION;
hgs
parents:
diff changeset
   182
    bool ret = false;
hgs
parents:
diff changeset
   183
hgs
parents:
diff changeset
   184
    if (!isRunning() && searchStrings.count() > 0) {
hgs
parents:
diff changeset
   185
        bool appendError = false;
hgs
parents:
diff changeset
   186
        mSortCriteria.iField = TFSMailSortField(sortCriteria.iField);
hgs
parents:
diff changeset
   187
        mSortCriteria.iOrder = TFSMailSortOrder(sortCriteria.iOrder);
hgs
parents:
diff changeset
   188
       
hgs
parents:
diff changeset
   189
        mSearchStrings.ResetAndDestroy();
hgs
parents:
diff changeset
   190
        
hgs
parents:
diff changeset
   191
        for (int i = 0; i < searchStrings.count() && !appendError; ++i) {
hgs
parents:
diff changeset
   192
            HBufC *buffer = XQConversions::qStringToS60Desc(searchStrings.at(i));
hgs
parents:
diff changeset
   193
            TRAPD(err, mSearchStrings.AppendL(buffer));
hgs
parents:
diff changeset
   194
            if (err != KErrNone) {
hgs
parents:
diff changeset
   195
                appendError = true;
hgs
parents:
diff changeset
   196
            }
hgs
parents:
diff changeset
   197
        }
hgs
parents:
diff changeset
   198
        
hgs
parents:
diff changeset
   199
        if (!appendError) {
hgs
parents:
diff changeset
   200
            ret = true;
hgs
parents:
diff changeset
   201
        }
hgs
parents:
diff changeset
   202
        else {
hgs
parents:
diff changeset
   203
            mSearchStrings.ResetAndDestroy();
hgs
parents:
diff changeset
   204
        }
hgs
parents:
diff changeset
   205
    }
hgs
parents:
diff changeset
   206
    
hgs
parents:
diff changeset
   207
    return ret;
hgs
parents:
diff changeset
   208
}
hgs
parents:
diff changeset
   209
hgs
parents:
diff changeset
   210
/*!
hgs
parents:
diff changeset
   211
 \fn initialiseMailbox 
hgs
parents:
diff changeset
   212
 
hgs
parents:
diff changeset
   213
 Initializes mailbox.  
hgs
parents:
diff changeset
   214
 */
hgs
parents:
diff changeset
   215
void NmApiMessageSearchPrivate::initialiseMailbox()
hgs
parents:
diff changeset
   216
{
hgs
parents:
diff changeset
   217
    NM_FUNCTION;
hgs
parents:
diff changeset
   218
    RPointerArray<CFSMailPlugin> mailPlugins;
hgs
parents:
diff changeset
   219
    if (mEngine) {
hgs
parents:
diff changeset
   220
        mEngine->listMailPlugins(mailPlugins);
hgs
parents:
diff changeset
   221
    }
hgs
parents:
diff changeset
   222
    CFSMailPlugin *plugin = NULL;
hgs
parents:
diff changeset
   223
    for (int i = 0; i < mailPlugins.Count() && !mMailBox; i++){
hgs
parents:
diff changeset
   224
        plugin = mailPlugins[i];
hgs
parents:
diff changeset
   225
        if (plugin) {
hgs
parents:
diff changeset
   226
            QT_TRY {
hgs
parents:
diff changeset
   227
                mMailBox = plugin->GetMailBoxByUidL(mMailBoxId);
hgs
parents:
diff changeset
   228
            }
hgs
parents:
diff changeset
   229
            QT_CATCH(...){}            
hgs
parents:
diff changeset
   230
        }
hgs
parents:
diff changeset
   231
    }
hgs
parents:
diff changeset
   232
}
hgs
parents:
diff changeset
   233
// End of file.