File indexing completed on 2024-06-23 05:21:16
0001 /* Copyright (C) 2006 - 2014 Jan Kundrát <jkt@flaska.net> 0002 0003 This file is part of the Trojita Qt IMAP e-mail client, 0004 http://trojita.flaska.net/ 0005 0006 This program is free software; you can redistribute it and/or 0007 modify it under the terms of the GNU General Public License as 0008 published by the Free Software Foundation; either version 2 of 0009 the License or (at your option) version 3 or any later version 0010 accepted by the membership of KDE e.V. (or its successor approved 0011 by the membership of KDE e.V.), which shall act as a proxy 0012 defined in Section 14 of version 3 of the license. 0013 0014 This program is distributed in the hope that it will be useful, 0015 but WITHOUT ANY WARRANTY; without even the implied warranty of 0016 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 0017 GNU General Public License for more details. 0018 0019 You should have received a copy of the GNU General Public License 0020 along with this program. If not, see <http://www.gnu.org/licenses/>. 0021 */ 0022 0023 #ifndef IMAP_SORT_TASK_H 0024 #define IMAP_SORT_TASK_H 0025 0026 #include <QPersistentModelIndex> 0027 #include "ImapTask.h" 0028 0029 namespace Imap 0030 { 0031 namespace Mailbox 0032 { 0033 0034 /** @short Send a SORT command and take care of its processing */ 0035 class SortTask : public ImapTask 0036 { 0037 Q_OBJECT 0038 public: 0039 SortTask(Model *model, const QModelIndex &mailbox, const QStringList &searchConditions, const QStringList &sortCriteria); 0040 void perform() override; 0041 void abort() override; 0042 0043 bool handleStateHelper(const Imap::Responses::State *const resp) override; 0044 bool handleSort(const Imap::Responses::Sort *const resp) override; 0045 bool handleSearch(const Imap::Responses::Search *const resp) override; 0046 bool handleESearch(const Responses::ESearch *const resp) override; 0047 QVariant taskData(const int role) const override; 0048 bool needsMailbox() const override {return true;} 0049 0050 bool isPersistent() const; 0051 bool isJustUpdatingNow() const; 0052 0053 void cancelSortingUpdates(); 0054 0055 signals: 0056 /** @short Sort result has arrived */ 0057 void sortingAvailable(const Imap::Uids &uids); 0058 0059 /** @short Sort operation has failed */ 0060 void sortingFailed(); 0061 0062 /** @short An incremental update to the sorting criteria according to CONTEXT=SORT */ 0063 void incrementalSortUpdate(const Imap::Responses::ESearch::IncrementalContextData_t &updates); 0064 0065 protected: 0066 void _failed(const QString &errorMessage) override; 0067 private: 0068 CommandHandle sortTag; 0069 CommandHandle cancelUpdateTag; 0070 ImapTask *conn; 0071 QPersistentModelIndex mailboxIndex; 0072 QStringList searchConditions; 0073 QStringList sortCriteria; 0074 Imap::Uids sortResult; 0075 0076 /** @short Are we supposed to run in a "persistent mode", ie. keep listening for updates? */ 0077 bool m_persistentSearch; 0078 0079 /** @short Have we received a full (non-incremental) response at first? */ 0080 bool m_firstUntaggedReceived; 0081 0082 /** @short Did the first command (the ESEARCH/ESORT) finish properly, including its tagged response? */ 0083 bool m_firstCommandCompleted; 0084 }; 0085 0086 } 0087 } 0088 0089 #endif // IMAP_SORT_TASK_H