KIMAP2

getquotajob.h
1 /*
2  Copyright (c) 2009 Andras Mantia <[email protected]>
3 
4  This library is free software; you can redistribute it and/or modify it
5  under the terms of the GNU Library General Public License as published by
6  the Free Software Foundation; either version 2 of the License, or (at your
7  option) any later version.
8 
9  This library is distributed in the hope that it will be useful, but WITHOUT
10  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
11  FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public
12  License for more details.
13 
14  You should have received a copy of the GNU Library General Public License
15  along with this library; see the file COPYING.LIB. If not, write to the
16  Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17  02110-1301, USA.
18 */
19 
20 #ifndef KIMAP2_GETQUOTAJOB_H
21 #define KIMAP2_GETQUOTAJOB_H
22 
23 #include "quotajobbase.h"
24 
25 namespace KIMAP2
26 {
27 
28 class Session;
29 struct Message;
30 class GetQuotaJobPrivate;
31 
32 /**
33  * Gets resource limits for a quota root.
34  *
35  * Quotas are defined with respect to "resources" and "quota roots".
36  * A resource is a numerical property that can be limited, such
37  * as the octet size of all the messages in a mailbox, or the
38  * number of messages in a mailbox. Each mailbox has one or more
39  * quota roots, which are where the resource limits are defined.
40  * A quota root may or may not be a mailbox name, and an empty
41  * string is a valid quota root. All mailboxes with the same quota
42  * root share the resource limits of the quota root.
43  *
44  * This job can only be run when the session is in the
45  * authenticated (or selected) state.
46  *
47  * This job requires that the server supports the QUOTA
48  * capability, defined in
49  * <a href="http://www.apps.ietf.org/rfc/rfc2087.html">RFC 2087</a>.
50  */
51 class KIMAP2_EXPORT GetQuotaJob : public QuotaJobBase
52 {
53  Q_OBJECT
54  Q_DECLARE_PRIVATE(GetQuotaJob)
55 
56  friend class SessionPrivate;
57 
58 public:
59  explicit GetQuotaJob(Session *session);
60  virtual ~GetQuotaJob();
61 
62  /**
63  * Set the quota root to get the resource limits for.
64  * @param root the quota root to set
65  * @see GetQuotaRootJob
66  */
67  void setRoot(const QByteArray &root);
68  /**
69  * The quota root that resource limit information will be fetched for.
70  */
71  QByteArray root() const;
72 
73 protected:
74  void doStart() Q_DECL_OVERRIDE;
75  void handleResponse(const Message &response) Q_DECL_OVERRIDE;
76 
77 };
78 
79 }
80 
81 #endif
Gets resource limits for a quota root.
Definition: getquotajob.h:51
Base class for jobs that operate on mailbox quotas.
Definition: quotajobbase.h:43
This file is part of the KDE documentation.
Documentation copyright © 1996-2023 The KDE developers.
Generated on Sun Jun 4 2023 04:03:45 by doxygen 1.8.17 written by Dimitri van Heesch, © 1997-2006

KDE's Doxygen guidelines are available online.