Try to use IMAP connection with minimum queue size among connections that already selected into needed folder (#1404)

1 files changed, 10 insertions, 0 deletions

diff --git a/src/async/imap/MCIMAPAsyncSession.h b/src/async/imap/MCIMAPAsyncSession.h
index 78ebd9b9..0230deda 100755
--- a/src/async/imap/MCIMAPAsyncSession.h
+++ b/src/async/imap/MCIMAPAsyncSession.h
@@ -212,8 +212,18 @@ namespace mailcore {
         String * mGmailUserDisplayName;
         bool mIdleEnabled;
 
+        /*! Create new IMAP session */
         virtual IMAPAsyncConnection * session();
+        /*! Returns a new or an existing session, it is best suited to run the IMAP command
+         in the specified folder. */
         virtual IMAPAsyncConnection * matchingSessionForFolder(String * folder);
+        /*! Returns a session with minimum operation queue among already created ones.
+         If @param filterByFolder is true, then function filters sessions with
+         predicate (lastFolder() EQUALS TO @param folder). In case of @param folder is NULL
+         the function would search a session among non-selected ones. */
+        virtual IMAPAsyncConnection * sessionWithMinQueue(bool filterByFolder, String * folder);
+        /*! Returns existant or new session with empty operation queue, if it can.
+         Otherwise, returns the session with the minimum size of the operation queue. */
         virtual IMAPAsyncConnection * availableSession();
         virtual IMAPMessageRenderingOperation * renderingOperation(IMAPMessage * message,
                                                                    String * folder,