1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
|
/****************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the Qt Messaging Framework.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef SERVICEHANDLER_H
#define SERVICEHANDLER_H
#include <QByteArray>
#include <QFile>
#include <QLinkedList>
#include <QList>
#include <qmailmessageserver.h>
#include <qmailmessageservice.h>
#include <QMap>
#include <QObject>
#include <QSet>
#include <QString>
#include <QStringList>
#include <QPointer>
class QMailServiceConfiguration;
class ServiceHandler : public QObject
{
Q_OBJECT
public:
ServiceHandler(QObject* parent);
~ServiceHandler();
public slots:
void transmitMessages(quint64 action, const QMailAccountId &accountId);
void retrieveFolderList(quint64, const QMailAccountId &accountId, const QMailFolderId &folderId, bool descending);
void retrieveMessageList(quint64, const QMailAccountId &accountId, const QMailFolderId &folderId, uint minimum, const QMailMessageSortKey &sort);
void retrieveMessages(quint64, const QMailMessageIdList &messageIds, QMailRetrievalAction::RetrievalSpecification spec);
void retrieveMessagePart(quint64, const QMailMessagePart::Location &partLocation);
void retrieveMessageRange(quint64, const QMailMessageId &messageId, uint minimum);
void retrieveMessagePartRange(quint64, const QMailMessagePart::Location &partLocation, uint minimum);
void retrieveAll(quint64, const QMailAccountId &accountId);
void exportUpdates(quint64, const QMailAccountId &accountId);
void synchronize(quint64, const QMailAccountId &accountId);
void deleteMessages(quint64 action, const QMailMessageIdList& mailList, QMailStore::MessageRemovalOption);
void copyMessages(quint64 action, const QMailMessageIdList& mailList, const QMailFolderId &destination);
void moveMessages(quint64 action, const QMailMessageIdList& mailList, const QMailFolderId &destination);
void flagMessages(quint64 action, const QMailMessageIdList& mailList, quint64 setMask, quint64 unsetMask);
void addMessages(quint64 action, const QString &filename);
void addMessages(quint64 action, const QMailMessageMetaDataList &messages);
void updateMessages(quint64 action, const QString &filename);
void updateMessages(quint64 action, const QMailMessageMetaDataList &messages);
void createFolder(quint64 action, const QString &name, const QMailAccountId &accountId, const QMailFolderId &parentId);
void renameFolder(quint64 action, const QMailFolderId &folderId, const QString &name);
void deleteFolder(quint64 action, const QMailFolderId &folderId);
void cancelTransfer(quint64 action);
void searchMessages(quint64 action, const QMailMessageKey &filter, const QString &bodyText, QMailSearchAction::SearchSpecification spec, const QMailMessageSortKey &sort);
void cancelLocalSearch(quint64 action);
void shutdown();
void listActions();
void protocolRequest(quint64 action, const QMailAccountId &accountId, const QString &request, const QVariant &data);
signals:
void actionStarted(QMailActionData action);
void statusChanged(quint64 action, const QMailServiceAction::Status status);
void availabilityChanged(quint64 action, bool available);
void connectivityChanged(quint64 action, QMailServiceAction::Connectivity connectivity);
void activityChanged(quint64 action, QMailServiceAction::Activity activity);
void progressChanged(quint64 action, uint progress, uint total);
void retrievalCompleted(quint64 action);
void messagesTransmitted(quint64 action, const QMailMessageIdList&);
void messagesFailedTransmission(quint64 action, const QMailMessageIdList&, QMailServiceAction::Status::ErrorCode);
void transmissionCompleted(quint64 action);
void messagesDeleted(quint64 action, const QMailMessageIdList&);
void messagesCopied(quint64 action, const QMailMessageIdList&);
void messagesMoved(quint64 action, const QMailMessageIdList&);
void messagesFlagged(quint64 action, const QMailMessageIdList&);
void messagesAdded(quint64 action, const QMailMessageIdList&);
void messagesUpdated(quint64 action, const QMailMessageIdList&);
void folderCreated(quint64 action, const QMailFolderId&);
void folderRenamed(quint64 action, const QMailFolderId&);
void folderDeleted(quint64 action, const QMailFolderId&);
void storageActionCompleted(quint64 action);
void matchingMessageIds(quint64 action, const QMailMessageIdList&);
void remoteSearchCompleted(quint64 action);
void searchCompleted(quint64 action);
void actionsListed(const QMailActionDataList &actions);
void protocolResponse(quint64 action, const QString &response, const QVariant &data);
void protocolRequestCompleted(quint64 action);
void newMessagesAvailable();
private slots:
void statusChanged(const QMailServiceAction::Status);
void statusChanged(const QMailServiceAction::Status, quint64);
void availabilityChanged(bool);
void availabilityChanged(bool, quint64);
void connectivityChanged(QMailServiceAction::Connectivity);
void connectivityChanged(QMailServiceAction::Connectivity, quint64);
void activityChanged(QMailServiceAction::Activity);
void activityChanged(QMailServiceAction::Activity, quint64);
void progressChanged(uint, uint );
void progressChanged(uint, uint, quint64);
void actionCompleted(bool);
void actionCompleted(bool, quint64);
void actionCompleted(bool, QMailMessageService *, quint64);
void messagesTransmitted(const QMailMessageIdList&);
void messagesTransmitted(const QMailMessageIdList&, quint64);
void messagesFailedTransmission(const QMailMessageIdList&, QMailServiceAction::Status::ErrorCode);
void messagesFailedTransmission(const QMailMessageIdList&, QMailServiceAction::Status::ErrorCode, quint64);
void messagesDeleted(const QMailMessageIdList&);
void messagesDeleted(const QMailMessageIdList& , quint64);
void messagesCopied(const QMailMessageIdList&);
void messagesCopied(const QMailMessageIdList&, quint64);
void messagesMoved(const QMailMessageIdList&);
void messagesMoved(const QMailMessageIdList&, quint64);
void messagesFlagged(const QMailMessageIdList&);
void messagesFlagged(const QMailMessageIdList&, quint64);
void messagesPrepared(const QMailMessageIdList&);
void messagesPrepared(const QMailMessageIdList&, quint64);
void matchingMessageIds(const QMailMessageIdList&);
void matchingMessageIds(const QMailMessageIdList&, quint64);
void protocolResponse(const QString &response, const QVariant &data);
void protocolResponse(const QString &response, const QVariant &data, quint64);
void accountsAdded(const QMailAccountIdList &);
void accountsUpdated(const QMailAccountIdList &);
void accountsRemoved(const QMailAccountIdList &);
void continueSearch();
void dispatchRequest();
void expireAction();
void reportFailures();
private:
QMailAccountId transmissionAccountId(const QMailAccountId &accountId) const;
void registerAccountServices(const QMailAccountIdList &ids);
void deregisterAccountServices(const QMailAccountIdList &ids, QMailServiceAction::Status::ErrorCode code, const QString &text);
void deregisterAccountService(const QMailAccountId &id, const QString &serviceName, QMailServiceAction::Status::ErrorCode code, const QString &text);
void removeServiceFromActions(QMailMessageService *removeService);
void reregisterAccountServices(QMailAccountIdList ids, QMailServiceAction::Status::ErrorCode code, const QString &text);
void registerAccountSource(const QMailAccountId &accountId, QMailMessageSource *source, QMailMessageService *service);
QMailMessageSource *accountSource(const QMailAccountId &accountId) const;
void registerAccountSink(const QMailAccountId &accountId, QMailMessageSink *sink, QMailMessageService *service);
QMailMessageSink *accountSink(const QMailAccountId &accountId) const;
void registerAccountService(const QMailAccountId &accountId, const QMailServiceConfiguration &svcCfg);
QMailMessageService *createService(const QString &service, const QMailAccountId &accountId);
struct Request;
bool servicesAvailable(const Request &services) const;
bool serviceAvailable(QPointer<QMailMessageService> service) const;
QSet<QMailMessageService*> sourceServiceSet(const QMailAccountId &id) const;
QSet<QMailMessageService*> sourceServiceSet(const QSet<QMailAccountId> &ids) const;
QSet<QMailMessageService*> sinkServiceSet(const QMailAccountId &id) const;
QSet<QMailMessageService*> sinkServiceSet(const QSet<QMailAccountId> &ids) const;
quint64 sourceAction(QMailMessageSource *source) const;
quint64 sinkAction(QMailMessageSink *sink) const;
quint64 serviceAction(QMailMessageService *service) const;
typedef bool (ServiceHandler::*RequestServicer)(quint64, const QByteArray &);
typedef void (ServiceHandler::*CompletionSignal)(quint64);
void enqueueRequest(quint64 action, const QByteArray &data, const QSet<QMailMessageService*> &services, RequestServicer servicer, CompletionSignal completion, QMailServerRequestType description, const QSet<QMailMessageService*> &preconditions = QSet<QMailMessageService*>());
bool dispatchPrepareMessages(quint64 action, const QByteArray& data);
bool dispatchTransmitMessages(quint64 action, const QByteArray& data);
bool dispatchRetrieveFolderListAccount(quint64, const QByteArray &data);
bool dispatchRetrieveFolderList(quint64, const QByteArray &data);
bool dispatchRetrieveMessageList(quint64, const QByteArray &data);
bool dispatchRetrieveMessages(quint64, const QByteArray &data);
bool dispatchRetrieveMessagePart(quint64, const QByteArray &data);
bool dispatchRetrieveMessageRange(quint64, const QByteArray &data);
bool dispatchRetrieveMessagePartRange(quint64, const QByteArray &data);
bool dispatchRetrieveAll(quint64, const QByteArray &data);
bool dispatchExportUpdates(quint64, const QByteArray &data);
bool dispatchSynchronize(quint64, const QByteArray &data);
bool dispatchDiscardMessages(quint64 action, const QByteArray &data);
bool dispatchDeleteMessages(quint64 action, const QByteArray &data);
bool dispatchCopyMessages(quint64 action, const QByteArray &data);
bool dispatchCopyToLocal(quint64 action, const QByteArray &data);
bool dispatchMoveMessages(quint64 action, const QByteArray &data);
bool dispatchFlagMessages(quint64 action, const QByteArray &data);
bool dispatchCreateFolder(quint64 action, const QByteArray &data);
bool dispatchDeleteFolder(quint64 action, const QByteArray &data);
bool dispatchRenameFolder(quint64 action, const QByteArray &data);
bool dispatchSearchMessages(quint64 action, const QByteArray &data);
bool dispatchProtocolRequest(quint64 action, const QByteArray &data);
void reportFailure(quint64, QMailServiceAction::Status::ErrorCode, const QString& = QString(), const QMailAccountId& = QMailAccountId(), const QMailFolderId& = QMailFolderId(), const QMailMessageId& = QMailMessageId());
void reportFailure(quint64, const QMailServiceAction::Status);
void updateAction(quint64);
void setRetrievalInProgress(const QMailAccountId &id, bool inProgress);
void setTransmissionInProgress(const QMailAccountId &id, bool inProgress);
void addOrUpdateMessages(quint64 action, const QString &filename, bool add);
QMap<QPair<QMailAccountId, QString>, QPointer<QMailMessageService> > serviceMap;
QMap<QMailAccountId, QMailMessageSource*> sourceMap;
QMap<QMailAccountId, QMailMessageSink*> sinkMap;
QMap<QMailMessageSource*, QPointer<QMailMessageService> > sourceService;
QMap<QMailMessageSink*, QPointer<QMailMessageService> > sinkService;
QMap<QMailAccountId, QMailAccountId> masterAccount;
QSet<QMailMessageService*> mUnavailableServices;
class ActionData
{
public:
QMailServerRequestType description;
QSet<QPointer<QMailMessageService> > services;
CompletionSignal completion;
uint unixTimeExpiry;
bool reported;
};
QMap<quint64, ActionData> mActiveActions;
QLinkedList<quint64> mActionExpiry;
QMap<QPointer<QMailMessageService>, quint64> mServiceAction;
static const int ExpirySeconds = 120;
struct Request
{
quint64 action;
QByteArray data;
QSet<QPointer<QMailMessageService> > services;
QSet<QPointer<QMailMessageService> > preconditions;
RequestServicer servicer;
CompletionSignal completion;
QMailServerRequestType description;
};
QList<Request> mRequests;
class MessageSearch
{
public:
MessageSearch(quint64 action, const QMailMessageIdList &ids, const QString &text);
quint64 action() const;
const QString &bodyText() const;
bool pending() const;
void inProgress();
bool isEmpty() const;
uint total() const;
uint progress() const;
QMailMessageIdList takeBatch();
private:
quint64 _action;
QMailMessageIdList _ids;
QString _text;
bool _active;
uint _total;
uint _progress;
};
QList<MessageSearch> mSearches;
QMailMessageIdList mMatchingIds;
QMailMessageIdList mSentIds;
QFile _requestsFile;
QSet<quint64> _outstandingRequests;
QList<quint64> _failedRequests;
QSet<QMailAccountId> _retrievalAccountIds;
QSet<QMailAccountId> _transmissionAccountIds;
};
#endif
|
