KIMAP2::IdleJob

Search for usage in LXR

#include <idlejob.h>

Inherits KIMAP2::Job.

Signals

void mailBoxMessageFlagsChanged (KIMAP2::IdleJob *job, qint64 uid)
 
void mailBoxStats (KIMAP2::IdleJob *job, const QString &mailBox, int messageCount, int recentCount)
 

Public Slots

void stop ()
 

Public Member Functions

 IdleJob (Session *session)
 
QString lastMailBox () const
 
int lastMessageCount () const
 
int lastRecentCount () const
 

Protected Member Functions

void doStart () override
 
void handleResponse (const Message &response) override
 

Detailed Description

Idles the connection to the IMAP server.

This job can be run while the client has no other use for the connection, and the server will send updates about the selected mailbox.

Note that although the server may send a variety of responses while the job is running (including EXPUNGE, for example), only RECENT and EXISTS responses are actually reported by this job.

The job also processes updates in pairs - if the server sends an EXISTS update but not a RECENT one (because another client is changing the mailbox contents), this job will not report the update.

It only makes sense to run this job when the session is in the selected state.

This job requires that the server supports the IDLE capability, defined in RFC 2177.

Definition at line 62 of file idlejob.h.

Constructor & Destructor Documentation

◆ IdleJob()

IdleJob::IdleJob ( Session * session)
explicit

Definition at line 75 of file idlejob.cpp.

◆ ~IdleJob()

IdleJob::~IdleJob ( )
virtual

Definition at line 86 of file idlejob.cpp.

Member Function Documentation

◆ doStart()

void IdleJob::doStart ( )
overrideprotected

Definition at line 97 of file idlejob.cpp.

◆ handleResponse()

void IdleJob::handleResponse ( const Message & response)
overrideprotected

Definition at line 105 of file idlejob.cpp.

◆ lastMailBox()

QString KIMAP2::IdleJob::lastMailBox ( ) const

The last mailbox status that was reported.

This is just the session's selected mailbox.

Definition at line 151 of file idlejob.cpp.

◆ lastMessageCount()

int KIMAP2::IdleJob::lastMessageCount ( ) const

The last message count that was reported.

The server will send updates about the number of messages in the mailbox when that number changes. This is the last number it reported.

Returns
the last message count the server reported, or -1 if it has not reported a message count since the job started.

Definition at line 157 of file idlejob.cpp.

◆ lastRecentCount()

int KIMAP2::IdleJob::lastRecentCount ( ) const

The last recent message count that was reported.

The server will send updates about the number of messages in the mailbox that are tagged with \Recent when that number changes. This is the last number it reported.

Returns
the last recent message count the server reported, or -1 if it has not reported a recent message count since the job started.

Definition at line 163 of file idlejob.cpp.

◆ mailBoxMessageFlagsChanged

void KIMAP2::IdleJob::mailBoxMessageFlagsChanged ( KIMAP2::IdleJob * job,
qint64 uid )
signal

Signals that the server has notified that the some messages flags have changed.

Parameters
jobthis object
uidUID of message that has changed
Since
4.12

◆ mailBoxStats

void KIMAP2::IdleJob::mailBoxStats ( KIMAP2::IdleJob * job,
const QString & mailBox,
int messageCount,
int recentCount )
signal

Signals that the server has notified that the total and recent message counts have changed.

Parameters
jobthis object
mailBoxthe selected mailbox
messageCountthe new total message count reported by the server
recentCountthe new "recent message" count reported by the server

◆ stop

void KIMAP2::IdleJob::stop ( )
slot

Stops the idle job.

Definition at line 90 of file idlejob.cpp.


The documentation for this class was generated from the following files:
This file is part of the KDE documentation.
Documentation copyright © 1996-2024 The KDE developers.
Generated on Tue Mar 26 2024 11:21:18 by doxygen 1.10.0 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.