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