File indexing completed on 2024-06-23 05:21:13

 /* Copyright (C) 2006 - 2014 Jan Kundrát <jkt@flaska.net>
 
    This file is part of the Trojita Qt IMAP e-mail client,
    http://trojita.flaska.net/
 
    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License as
    published by the Free Software Foundation; either version 2 of
    the License or (at your option) version 3 or any later version
    accepted by the membership of KDE e.V. (or its successor approved
    by the membership of KDE e.V.), which shall act as a proxy
    defined in Section 14 of version 3 of the license.
 
    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
 
    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
 
 #ifndef IMAP_TASK_IDLELAUNCHER_H
 #define IMAP_TASK_IDLELAUNCHER_H
 
 #include <QPointer>
 
 class QTimer;
 
 namespace Imap
 {
 
 namespace Mailbox
 {
 
 class KeepMailboxOpenTask;
 
 /** @short Automatically launch and maintain the IDLE command
 
 This class servers as a helper for the KeepMailboxOpenTask task. Its responsibility
 is to watch the parser for being "idle" (ie. no commands flowing from upper layers)
 and automatically launching the IDLE command, watching for its interruption (perhaps
 by other commands) and restarting it when the parser is idling again.
 */
 class IdleLauncher: public QObject
 {
     Q_OBJECT
 public:
     /** @short Create the IdleLauncher
 
     This function should only be called when the KeepMailboxOpenTask has selected the
     target mailbox and all member variables are set up.
     */
     explicit IdleLauncher(KeepMailboxOpenTask *parent);
 
     /** @short Register the interest in launching the IDLE command after a delay */
     void enterIdleLater();
 
     /** @short Prevent any further idling */
     void die();
 
     /** @short Break the IDLE command */
     void finishIdle();
 
     /** @short Are we in the middle of an IDLE now?
 
     This function returns true iff slotEnterIdleNow() has been called and finishIdle()
     hasn't been called yet.  It doesn't depend on command completion tracking on upper layers,
     though.
     */
     bool idling() const;
 
     /** @short Are we waiting for the "OK idle done"? */
     bool waitingForIdleTaggedTermination() const;
 
     /** @short Informs the IdleLauncher that the server OKed the end of the IDLE mode
 
     We will automatically resume IDLE later.
     */
     void idleCommandCompleted();
 
     /** @short Informs the IdleLauncher that the IDLE command failed */
     void idleCommandFailed();
 public slots:
     /** @short Immediately send the IDLE command to the parser */
     void slotEnterIdleNow();
     /** @short Abort the IDLE command because it's been running for too long */
     void slotTerminateLongIdle();
 private:
     KeepMailboxOpenTask *task;
     QTimer *delayedEnter;
     QTimer *renewal;
     /** @short Are we between queueing the IDLE and DONE statements? */
     bool m_idling;
     /** @short Are we between queueing the IDLE and receiving the <tag> OK? */
     bool m_idleCommandRunning;
 
     IdleLauncher(const Imap::Mailbox::IdleLauncher &); // don't implement
     IdleLauncher &operator=(const Imap::Mailbox::IdleLauncher &); // don't implement
 };
 
 }
 
 }
 
 #endif /* IMAP_TASK_IDLELAUNCHER_H */