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
|
//
// VMime library (http://www.vmime.org)
// Copyright (C) 2002 Vincent Richard <vincent@vmime.org>
//
// 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 3 of
// the License, or (at your option) any later version.
//
// 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, write to the Free Software Foundation, Inc.,
// 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
//
// Linking this library statically or dynamically with other modules is making
// a combined work based on this library. Thus, the terms and conditions of
// the GNU General Public License cover the whole combination.
//
#ifndef VMIME_NET_IMAP_IMAPMESSAGE_HPP_INCLUDED
#define VMIME_NET_IMAP_IMAPMESSAGE_HPP_INCLUDED
#include "vmime/config.hpp"
#if VMIME_HAVE_MESSAGING_FEATURES && VMIME_HAVE_MESSAGING_PROTO_IMAP
#include "vmime/net/message.hpp"
#include "vmime/net/folder.hpp"
#include "vmime/net/imap/IMAPParser.hpp"
namespace vmime {
namespace net {
namespace imap {
class IMAPFolder;
/** IMAP message implementation.
*/
class VMIME_EXPORT IMAPMessage : public message {
private:
friend class IMAPFolder;
friend class IMAPMessagePartContentHandler;
IMAPMessage(const IMAPMessage&) : message() { }
public:
IMAPMessage(const shared_ptr <IMAPFolder>& folder, const size_t num);
IMAPMessage(const shared_ptr <IMAPFolder>& folder, const size_t num, const uid& uid);
~IMAPMessage();
size_t getNumber() const;
const uid getUID() const;
/** Returns the modification sequence for this message.
*
* Every time metadata for this message changes, the modification
* sequence is updated, and is greater than the previous one. The
* server must support the CONDSTORE extension for this to be
* available.
*
* @return modification sequence, or zero if not supported by
* the underlying protocol
*/
vmime_uint64 getModSequence() const;
size_t getSize() const;
bool isExpunged() const;
shared_ptr <const messageStructure> getStructure() const;
shared_ptr <messageStructure> getStructure();
shared_ptr <const header> getHeader() const;
int getFlags() const;
void setFlags(const int flags, const int mode = FLAG_MODE_SET);
void extract(
utility::outputStream& os,
utility::progressListener* progress = NULL,
const size_t start = 0,
const size_t length = -1,
const bool peek = false
) const;
void extractPart(
const shared_ptr <const messagePart>& p,
utility::outputStream& os,
utility::progressListener* progress = NULL,
const size_t start = 0,
const size_t length = -1,
const bool peek = false
) const;
void fetchPartHeader(const shared_ptr <messagePart>& p);
shared_ptr <vmime::message> getParsedMessage();
private:
/** Renumbers the message.
*
* @param number new sequence number
*/
void renumber(const size_t number);
/** Marks the message as expunged.
*/
void setExpunged();
/** Processes the parsed response to fill in the attributes
* and metadata of this message.
*
* @param options one or more fetch options (see folder::fetchAttributes)
* @param msgData pointer to message_data component of the parsed response
* @return a combination of flags that specify what changed exactly on
* this message (see events::messageChangedEvent::Types)
*/
int processFetchResponse(const fetchAttributes& options, const IMAPParser::message_data& msgData);
/** Recursively fetch part header for all parts in the structure.
*
* @param str structure for which to fetch parts headers
*/
void fetchPartHeaderForStructure(const shared_ptr <messageStructure>& str);
/** Recursively contruct parsed message from structure.
* Called by getParsedMessage().
*
* @param parentPart root body part (the message)
* @param str structure for which to construct part
* @param level current nesting level (0 is root)
*/
void constructParsedMessage(
const shared_ptr <bodyPart>& parentPart,
const shared_ptr <messageStructure>& str,
int level = 0
);
enum ExtractFlags
{
EXTRACT_HEADER = 0x1,
EXTRACT_BODY = 0x2,
EXTRACT_PEEK = 0x10
};
size_t extractImpl(
const shared_ptr <const messagePart>& p,
utility::outputStream& os,
utility::progressListener* progress,
const size_t start,
const size_t length,
const int extractFlags
) const;
shared_ptr <header> getOrCreateHeader();
void onFolderClosed();
weak_ptr <IMAPFolder> m_folder;
size_t m_num;
size_t m_size;
int m_flags;
bool m_expunged;
uid m_uid;
vmime_uint64 m_modseq;
shared_ptr <header> m_header;
shared_ptr <messageStructure> m_structure;
};
} // imap
} // net
} // vmime
#endif // VMIME_HAVE_MESSAGING_FEATURES && VMIME_HAVE_MESSAGING_PROTO_IMAP
#endif // VMIME_NET_IMAP_IMAPMESSAGE_HPP_INCLUDED
|
