qtmobility/src/messaging/win32wce/qmailmessage.h
changeset 1 2b40d63a9c3d
child 11 06b8e2af4411
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/qtmobility/src/messaging/win32wce/qmailmessage.h	Fri Apr 16 15:51:22 2010 +0300
@@ -0,0 +1,788 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the Qt Mobility Components.
+**
+** $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 QMAILMESSAGE_H
+#define QMAILMESSAGE_H
+
+#include "qmailmessagefwd.h"
+#include "qmailaddress.h"
+#include "qmailid.h"
+#include "qmailtimestamp.h"
+#include "qprivateimplementation.h"
+#include <QByteArray>
+#include <QFlags>
+#include <QList>
+#include <QPair>
+#include <QString>
+#include <QStringList>
+
+class QMailMessagePart;
+class QMailMessagePartContainerPrivate;
+class QDataStream;
+class QTextStream;
+class QFile;
+
+class QMailMessageHeaderFieldPrivate;
+
+class QTOPIAMAIL_EXPORT QMailMessageHeaderField : public QPrivatelyImplemented<QMailMessageHeaderFieldPrivate>, public QMailMessageHeaderFieldFwd
+{
+public:
+    typedef QMailMessageHeaderFieldPrivate ImplementationType;
+
+    typedef QPair<QByteArray, QByteArray> ParameterType;
+
+    QMailMessageHeaderField();
+    QMailMessageHeaderField(const QByteArray& text, FieldType fieldType = StructuredField);
+    QMailMessageHeaderField(const QByteArray& name, const QByteArray& text, FieldType fieldType = StructuredField);
+
+    bool isNull() const;
+
+    QByteArray id() const;
+    void setId(const QByteArray& text);
+
+    QByteArray content() const;
+    void setContent(const QByteArray& text);
+
+    QByteArray parameter(const QByteArray& name) const;
+    void setParameter(const QByteArray& name, const QByteArray& value);
+
+    bool isParameterEncoded(const QByteArray& name) const;
+    void setParameterEncoded(const QByteArray& name);
+
+    QList<ParameterType> parameters() const;
+
+    virtual QByteArray toString(bool includeName = true, bool presentable = true) const;
+
+    virtual QString decodedContent() const;
+
+    bool operator== (const QMailMessageHeaderField& other) const;
+
+    static QByteArray encodeWord(const QString& input, const QByteArray& charset = "");
+    static QString decodeWord(const QByteArray& input);
+
+    static QByteArray encodeParameter(const QString& input, const QByteArray& charset = "", const QByteArray& language = "");
+    static QString decodeParameter(const QByteArray& input);
+
+    static QByteArray encodeContent(const QString& input, const QByteArray& charset = "");
+    static QString decodeContent(const QByteArray& input);
+
+    static QByteArray removeComments(const QByteArray& input);
+    static QByteArray removeWhitespace(const QByteArray& input);
+
+    template <typename Stream> void serialize(Stream &stream) const;
+    template <typename Stream> void deserialize(Stream &stream);
+
+protected:
+    void parse(const QByteArray& text, FieldType fieldType);
+
+private:
+    friend class QMailMessageHeaderFieldPrivate;
+    friend class QMailMessageHeaderPrivate;
+
+    void output(QDataStream& out) const;
+};
+
+template <typename Stream>
+Stream& operator<<(Stream &stream, const QMailMessageHeaderField& field) { field.serialize(stream); return stream; }
+
+template <typename Stream>
+Stream& operator>>(Stream &stream, QMailMessageHeaderField& field) { field.deserialize(stream); return stream; }
+
+
+class QTOPIAMAIL_EXPORT QMailMessageContentType : public QMailMessageHeaderField
+{
+public:
+    QMailMessageContentType();
+    QMailMessageContentType(const QByteArray& type);
+    QMailMessageContentType(const QMailMessageHeaderField& field);
+
+    QByteArray type() const;
+    void setType(const QByteArray& type);
+
+    QByteArray subType() const;
+    void setSubType(const QByteArray& subType);
+
+    QByteArray name() const;
+    void setName(const QByteArray& name);
+
+    QByteArray boundary() const;
+    void setBoundary(const QByteArray& boundary);
+
+    QByteArray charset() const;
+    void setCharset(const QByteArray& charset);
+
+private:
+    // Don't allow the Id to be changed
+    void setId(const QByteArray& text);
+};
+
+
+class QTOPIAMAIL_EXPORT QMailMessageContentDisposition : public QMailMessageHeaderField, public QMailMessageContentDispositionFwd
+{
+public:
+    QMailMessageContentDisposition();
+    QMailMessageContentDisposition(const QByteArray& type);
+    QMailMessageContentDisposition(DispositionType disposition);
+    QMailMessageContentDisposition(const QMailMessageHeaderField& field);
+
+    DispositionType type() const;
+    void setType(DispositionType disposition);
+
+    QByteArray filename() const;
+    void setFilename(const QByteArray& filename);
+
+    QMailTimeStamp creationDate() const;
+    void setCreationDate(const QMailTimeStamp& timeStamp);
+
+    QMailTimeStamp modificationDate() const;
+    void setModificationDate(const QMailTimeStamp& timeStamp);
+
+    QMailTimeStamp readDate() const;
+    void setReadDate(const QMailTimeStamp& timeStamp);
+
+    int size() const;
+    void setSize(int size);
+
+private:
+    // Don't allow the Id to be changed
+    void setId(const QByteArray& text);
+};
+
+
+class QMailMessageHeaderPrivate;
+
+// This class is not exposed to clients:
+class QMailMessageHeader : public QPrivatelyImplemented<QMailMessageHeaderPrivate>
+{
+public:
+    typedef QMailMessageHeaderPrivate ImplementationType;
+
+    QMailMessageHeader();
+    QMailMessageHeader(const QByteArray& input);
+
+    void update(const QByteArray& id, const QByteArray& content);
+    void append(const QByteArray& id, const QByteArray& content);
+    void remove(const QByteArray& id);
+
+    QMailMessageHeaderField field(const QByteArray& id) const;
+    QList<QMailMessageHeaderField> fields(const QByteArray& id) const;
+
+    QList<const QByteArray*> fieldList() const;
+
+    template <typename Stream> void serialize(Stream &stream) const;
+    template <typename Stream> void deserialize(Stream &stream);
+
+private:
+    friend class QMailMessageHeaderPrivate;
+    friend class QMailMessagePartContainerPrivate;
+    friend class QMailMessagePartPrivate;
+    friend class QMailMessagePrivate;
+
+    void output(QDataStream& out, const QList<QByteArray>& exclusions, bool stripInternal) const;
+};
+
+template <typename Stream> 
+Stream& operator<<(Stream &stream, const QMailMessageHeader& header) { header.serialize(stream); return stream; }
+
+template <typename Stream> 
+Stream& operator>>(Stream &stream, QMailMessageHeader& header) { header.deserialize(stream); return stream; }
+
+
+class QMailMessageBodyPrivate;
+class LongString;
+
+class QTOPIAMAIL_EXPORT QMailMessageBody : public QPrivatelyImplemented<QMailMessageBodyPrivate>, public QMailMessageBodyFwd
+{
+public:
+    typedef QMailMessageBodyPrivate ImplementationType;
+
+    // Construction functions
+    static QMailMessageBody fromFile(const QString& filename, const QMailMessageContentType& type, TransferEncoding encoding, EncodingStatus status);
+
+    static QMailMessageBody fromStream(QDataStream& in, const QMailMessageContentType& type, TransferEncoding encoding, EncodingStatus status);
+    static QMailMessageBody fromData(const QByteArray& input, const QMailMessageContentType& type, TransferEncoding encoding, EncodingStatus status);
+
+    static QMailMessageBody fromStream(QTextStream& in, const QMailMessageContentType& type, TransferEncoding encoding);
+    static QMailMessageBody fromData(const QString& input, const QMailMessageContentType& type, TransferEncoding encoding);
+
+    // Output functions
+    bool toFile(const QString& filename, EncodingFormat format) const;
+
+    QByteArray data(EncodingFormat format) const;
+    bool toStream(QDataStream& out, EncodingFormat format) const;
+
+    QString data() const;
+    bool toStream(QTextStream& out) const;
+
+    // Property accessors
+    TransferEncoding transferEncoding() const;
+    QMailMessageContentType contentType() const;
+
+    bool isEmpty() const;
+    int length() const;
+
+    template <typename Stream> void serialize(Stream &stream) const;
+    template <typename Stream> void deserialize(Stream &stream);
+
+private:
+    friend class QMailMessagePartContainerPrivate;
+
+    QMailMessageBody();
+
+    uint indicativeSize() const;
+
+    void output(QDataStream& out, bool includeAttachments) const;
+    static QMailMessageBody fromLongString(LongString& ls, const QMailMessageContentType& type, TransferEncoding encoding, EncodingStatus status);
+};
+
+template <typename Stream> 
+Stream& operator<<(Stream &stream, const QMailMessageBody& body) { body.serialize(stream); return stream; }
+
+template <typename Stream> 
+Stream& operator>>(Stream &stream, QMailMessageBody& body) { body.deserialize(stream); return stream; }
+
+class QTOPIAMAIL_EXPORT QMailMessagePartContainer : public QPrivatelyImplemented<QMailMessagePartContainerPrivate>, public QMailMessagePartContainerFwd
+{
+public:
+    typedef QMailMessagePartContainerPrivate ImplementationType;
+
+    // Parts management interface:
+    MultipartType multipartType() const;
+    void setMultipartType(MultipartType type);
+
+    uint partCount() const;
+
+    void appendPart(const QMailMessagePart &part);
+    void prependPart(const QMailMessagePart &part);
+
+    void removePartAt(uint pos);
+
+    const QMailMessagePart& partAt(uint pos) const;
+    QMailMessagePart& partAt(uint pos);
+
+    void clearParts();
+
+    QByteArray boundary() const;
+    void setBoundary(const QByteArray& text);
+
+    // Body management interface:
+    void setBody(const QMailMessageBody& body);
+    QMailMessageBody body() const;
+
+    bool hasBody() const;
+
+    // Property accessors
+    QMailMessageBody::TransferEncoding transferEncoding() const;
+    QMailMessageContentType contentType() const;
+
+    // Header fields describing this part container
+    QString headerFieldText( const QString &id ) const;
+    QMailMessageHeaderField headerField( const QString &id, QMailMessageHeaderField::FieldType fieldType = QMailMessageHeaderField::StructuredField ) const;
+
+    QStringList headerFieldsText( const QString &id ) const;
+    QList<QMailMessageHeaderField> headerFields( const QString &id, QMailMessageHeaderField::FieldType fieldType = QMailMessageHeaderField::StructuredField ) const;
+
+    QList<QMailMessageHeaderField> headerFields() const;
+
+    virtual void setHeaderField( const QString &id, const QString& content );
+    virtual void setHeaderField( const QMailMessageHeaderField &field );
+
+    virtual void appendHeaderField( const QString &id, const QString& content );
+    virtual void appendHeaderField( const QMailMessageHeaderField &field );
+
+    virtual void removeHeaderField( const QString &id );
+
+    virtual bool contentAvailable() const = 0;
+    virtual bool partialContentAvailable() const = 0;
+
+    template <typename F>
+    bool foreachPart(F func);
+
+    template <typename F>
+    bool foreachPart(F func) const;
+
+    static MultipartType multipartTypeForName(const QByteArray &name);
+    static QByteArray nameForMultipartType(MultipartType type);
+
+protected:
+    template<typename Subclass>
+    QMailMessagePartContainer(Subclass* p);
+
+    virtual void setHeader(const QMailMessageHeader& header, const QMailMessagePartContainerPrivate* parent = 0);
+
+private:
+    friend class QMailMessagePartContainerPrivate;
+
+    uint indicativeSize() const;
+
+    void outputParts(QDataStream& out, bool includePreamble, bool includeAttachments, bool stripInternal) const;
+    void outputBody(QDataStream& out, bool includeAttachments) const;
+};
+
+class QMailMessagePartPrivate;
+
+class QTOPIAMAIL_EXPORT QMailMessagePart : public QMailMessagePartContainer, public QMailMessagePartFwd
+{
+public:
+    typedef QMailMessagePartPrivate ImplementationType;
+
+    class LocationPrivate;
+
+    class QTOPIAMAIL_EXPORT Location
+    {
+    public:
+        Location();
+        Location(const QString& description);
+        Location(const Location& other);
+
+        ~Location();
+
+        const QMailMessagePart::Location &operator=(const QMailMessagePart::Location &other);
+
+        bool isValid(bool extended = true) const;
+
+        QMailMessageId containingMessageId() const;
+        void setContainingMessageId(const QMailMessageId &id);
+
+        QString toString(bool extended) const;
+
+        template <typename Stream> void serialize(Stream &stream) const;
+        template <typename Stream> void deserialize(Stream &stream);
+
+    private:
+        friend class QMailMessagePartContainerPrivate;
+        friend class QMailMessagePart;
+
+        Location(const QMailMessagePart& part);
+
+        LocationPrivate *d;
+    };
+
+    QMailMessagePart();
+
+    // Construction functions
+    static QMailMessagePart fromFile(const QString& filename, const QMailMessageContentDisposition& disposition, 
+                                     const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding, 
+                                     QMailMessageBody::EncodingStatus status = QMailMessageBody::RequiresEncoding);
+
+    static QMailMessagePart fromStream(QDataStream& in, const QMailMessageContentDisposition& disposition, 
+                                       const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding, 
+                                       QMailMessageBody::EncodingStatus status = QMailMessageBody::RequiresEncoding);
+    static QMailMessagePart fromData(const QByteArray& input, const QMailMessageContentDisposition& disposition, 
+                                     const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding, 
+                                     QMailMessageBody::EncodingStatus status = QMailMessageBody::RequiresEncoding);
+
+    static QMailMessagePart fromStream(QTextStream& in, const QMailMessageContentDisposition& disposition, 
+                                       const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding);
+    static QMailMessagePart fromData(const QString& input, const QMailMessageContentDisposition& disposition, 
+                                     const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding);
+
+    static QMailMessagePart fromMessageReference(const QMailMessageId &id, const QMailMessageContentDisposition& disposition, 
+                                                 const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding);
+    static QMailMessagePart fromPartReference(const QMailMessagePart::Location &partLocation, const QMailMessageContentDisposition& disposition, 
+                                              const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding);
+
+    void setReference(const QMailMessageId &id, const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding);
+    void setReference(const QMailMessagePart::Location &location, const QMailMessageContentType& type, QMailMessageBody::TransferEncoding encoding);
+
+    QString contentID() const;
+    void setContentID(const QString &s);
+
+    QString contentLocation() const;
+    void setContentLocation(const QString &s);
+
+    QString contentDescription() const;
+    void setContentDescription(const QString &s);
+
+    QMailMessageContentDisposition contentDisposition() const;
+    void setContentDisposition(const QMailMessageContentDisposition& disposition);
+
+    QString contentLanguage() const;
+    void setContentLanguage(const QString &s);
+
+    int partNumber() const;
+
+    Location location() const;
+
+    QString displayName() const;
+    QString identifier() const;
+
+    ReferenceType referenceType() const;
+
+    QMailMessageId messageReference() const;
+    QMailMessagePart::Location partReference() const;
+
+    QString referenceResolution() const;
+    void setReferenceResolution(const QString &uri);
+
+    virtual uint indicativeSize() const;
+
+    virtual bool contentAvailable() const;
+    virtual bool partialContentAvailable() const;
+
+    QString writeBodyTo(const QString &path) const;
+
+    virtual bool contentModified() const;
+
+    template <typename Stream> void serialize(Stream &stream) const;
+    template <typename Stream> void deserialize(Stream &stream);
+
+private:
+    friend class QMailMessagePrivate;
+    friend class QMailMessagePartContainerPrivate;
+
+    virtual void setUnmodified();
+
+    void output(QDataStream& out, bool includeAttachments, bool stripInternal) const;
+};
+
+template <typename Stream> 
+Stream& operator<<(Stream &stream, const QMailMessagePart& part) { part.serialize(stream); return stream; }
+
+template <typename Stream> 
+Stream& operator>>(Stream &stream, QMailMessagePart& part) { part.deserialize(stream); return stream; }
+
+template <typename F>
+bool QMailMessagePartContainer::foreachPart(F func)
+{
+    for (uint i = 0; i < partCount(); ++i) {
+        QMailMessagePart &part(partAt(i));
+        
+        if (!func(part)) {
+            return false;
+        } else if (part.multipartType() != QMailMessagePartContainer::MultipartNone) {
+            if (!part.foreachPart(func)) {
+                return false;
+            }
+        }
+    }
+
+    return true;
+}
+
+template <typename F>
+bool QMailMessagePartContainer::foreachPart(F func) const
+{
+    for (uint i = 0; i < partCount(); ++i) {
+        const QMailMessagePart &part(partAt(i));
+        
+        if (!func(part)) {
+            return false;
+        } else if (part.multipartType() != QMailMessagePartContainer::MultipartNone) {
+            if (!part.foreachPart(func)) {
+                return false;
+            }
+        }
+    }
+
+    return true;
+}
+
+class QMailMessageMetaDataPrivate;
+
+class QTOPIAMAIL_EXPORT QMailMessageMetaData : public QPrivatelyImplemented<QMailMessageMetaDataPrivate>, public QMailMessageMetaDataFwd
+{
+public:
+    typedef QMailMessageMetaDataPrivate ImplementationType;
+
+    static const quint64 &Incoming;
+    static const quint64 &Outgoing;
+    static const quint64 &Sent;
+    static const quint64 &Replied;
+    static const quint64 &RepliedAll;
+    static const quint64 &Forwarded;
+    static const quint64 &ContentAvailable;
+    static const quint64 &Read;
+    static const quint64 &Removed;
+    static const quint64 &ReadElsewhere;
+    static const quint64 &UnloadedData;
+    static const quint64 &New;
+    static const quint64 &ReadReplyRequested;
+    static const quint64 &Trash;
+    static const quint64 &PartialContentAvailable;
+    static const quint64 &HasAttachments;
+    static const quint64 &HasReferences;
+    static const quint64 &HasUnresolvedReferences;
+    static const quint64 &Draft;
+    static const quint64 &Outbox;
+    static const quint64 &Junk;
+    static const quint64 &TransmitFromExternal;
+    static const quint64 &LocalOnly;
+
+    QMailMessageMetaData();
+#ifndef QTOPIAMAIL_PARSING_ONLY
+    QMailMessageMetaData(const QMailMessageId& id);
+    QMailMessageMetaData(const QString& uid, const QMailAccountId& accountId);
+#endif
+
+    virtual QMailMessageId id() const;
+    virtual void setId(const QMailMessageId &id);
+
+#ifndef QTOPIAMAIL_PARSING_ONLY
+    virtual QMailFolderId parentFolderId() const;
+    virtual void setParentFolderId(const QMailFolderId &id);
+#endif
+
+    virtual MessageType messageType() const;
+    virtual void setMessageType(MessageType t);
+
+    virtual QMailAddress from() const;
+    virtual void setFrom(const QMailAddress &s);
+
+    virtual QString subject() const;
+    virtual void setSubject(const QString &s);
+
+    virtual QMailTimeStamp date() const;
+    virtual void setDate(const QMailTimeStamp &s);
+
+    virtual QMailTimeStamp receivedDate() const;
+    virtual void setReceivedDate(const QMailTimeStamp &s);
+
+    virtual QList<QMailAddress> to() const;
+    virtual void setTo(const QList<QMailAddress>& s);
+    virtual void setTo(const QMailAddress& s);
+
+    virtual quint64 status() const;
+    virtual void setStatus(quint64 newStatus);
+    virtual void setStatus(quint64 mask, bool set);
+
+#ifndef QTOPIAMAIL_PARSING_ONLY
+    virtual QMailAccountId parentAccountId() const;
+    virtual void setParentAccountId(const QMailAccountId& id);
+#endif
+
+    virtual QString serverUid() const;
+    virtual void setServerUid(const QString &s);
+
+    virtual uint size() const;
+    virtual void setSize(uint i);
+
+    virtual uint indicativeSize() const;
+
+    virtual ContentType content() const;
+    virtual void setContent(ContentType type);
+
+#ifndef QTOPIAMAIL_PARSING_ONLY
+    virtual QMailFolderId previousParentFolderId() const;
+    virtual void setPreviousParentFolderId(const QMailFolderId &id);
+#endif
+
+    virtual QString contentScheme() const;
+    virtual bool setContentScheme(const QString &s);
+
+    virtual QString contentIdentifier() const;
+    virtual bool setContentIdentifier(const QString &i);
+
+    virtual QMailMessageId inResponseTo() const;
+    virtual void setInResponseTo(const QMailMessageId &id);
+
+    virtual ResponseType responseType() const;
+    virtual void setResponseType(ResponseType type);
+
+    virtual bool contentAvailable() const;
+    virtual bool partialContentAvailable() const;
+
+#ifndef QTOPIAMAIL_PARSING_ONLY
+    static quint64 statusMask(const QString &flagName);
+#endif
+
+    QString customField(const QString &name) const;
+    void setCustomField(const QString &name, const QString &value);
+    void setCustomFields(const QMap<QString, QString> &fields);
+
+    void removeCustomField(const QString &name);
+
+    const QMap<QString, QString> &customFields() const;
+
+    virtual bool dataModified() const;
+
+    template <typename Stream> void serialize(Stream &stream) const;
+    template <typename Stream> void deserialize(Stream &stream);
+
+private:
+    friend class QMailMessage;
+    friend class QMailMessagePrivate;
+    friend class QMailStore;
+    friend class QMailStorePrivate;
+
+    virtual void setUnmodified();
+
+    bool customFieldsModified() const;
+    void setCustomFieldsModified(bool set);
+
+#ifndef QTOPIAMAIL_PARSING_ONLY
+    static void initStore();
+#endif
+};
+
+class QMailMessagePrivate;
+
+class QTOPIAMAIL_EXPORT QMailMessage : public QMailMessageMetaData, public QMailMessagePartContainer, public QMailMessageFwd
+{
+public:
+    using QMailMessageMetaData::MessageType;
+    using QMailMessageMetaData::ContentType;
+    using QMailMessageMetaData::ResponseType;
+
+    // Mail content needs to use CRLF explicitly
+    static const char CarriageReturn;
+    static const char LineFeed;
+    static const char* CRLF;
+
+    static QMailMessage fromRfc2822(const QByteArray &ba);
+    static QMailMessage fromRfc2822File(const QString& fileName);
+
+    QMailMessage();
+#ifndef QTOPIAMAIL_PARSING_ONLY
+    QMailMessage(const QMailMessageId& id);
+    QMailMessage(const QString& uid, const QMailAccountId& accountId);
+#endif
+
+    QByteArray toRfc2822(EncodingFormat format = TransmissionFormat) const;
+    void toRfc2822(QDataStream& out, EncodingFormat format = TransmissionFormat) const;
+
+    QList<QMailMessage::MessageChunk> toRfc2822Chunks(EncodingFormat format = TransmissionFormat) const;
+
+    using QMailMessagePartContainer::partAt;
+
+    bool contains(const QMailMessagePart::Location& location) const;
+    const QMailMessagePart& partAt(const QMailMessagePart::Location& location) const;
+    QMailMessagePart& partAt(const QMailMessagePart::Location& location);
+
+    // Overrides of QMMPC functions where the data needs to be stored to the meta data also:
+
+    virtual void setHeaderField( const QString &id, const QString& content );
+    virtual void setHeaderField( const QMailMessageHeaderField &field );
+
+    virtual void appendHeaderField( const QString &id, const QString& content );
+    virtual void appendHeaderField( const QMailMessageHeaderField &field );
+
+    virtual void removeHeaderField( const QString &id );
+
+    // Overrides of QMMMD functions where the data needs to be stored to the part container also:
+
+    virtual void setId(const QMailMessageId &id);
+
+    virtual void setFrom(const QMailAddress &s);
+
+    virtual void setSubject(const QString &s);
+    
+    virtual void setDate(const QMailTimeStamp &s);
+
+    virtual void setTo(const QList<QMailAddress>& s);
+    virtual void setTo(const QMailAddress& s);
+
+    virtual uint indicativeSize() const;
+
+    // Convenience functions:
+
+    virtual QList<QMailAddress> cc() const;
+    virtual void setCc(const QList<QMailAddress>& s);
+    virtual QList<QMailAddress> bcc() const;
+    virtual void setBcc(const QList<QMailAddress>& s);
+
+    virtual QList<QMailAddress> recipients() const;
+    virtual bool hasRecipients() const;
+
+    virtual QMailAddress replyTo() const;
+    virtual void setReplyTo(const QMailAddress &s);
+
+    virtual QString inReplyTo() const;
+    virtual void setInReplyTo(const QString &s);
+
+    virtual uint contentSize() const;
+    virtual void setContentSize(uint size);
+
+    virtual QString externalLocationReference() const;
+    virtual void setExternalLocationReference(const QString &s);
+
+    virtual bool contentAvailable() const;
+    virtual bool partialContentAvailable() const;
+
+    virtual bool contentModified() const;
+
+    template <typename Stream> void serialize(Stream &stream) const;
+    template <typename Stream> void deserialize(Stream &stream);
+
+protected:
+    virtual void setHeader(const QMailMessageHeader& header, const QMailMessagePartContainerPrivate* parent = 0);
+
+private:
+    friend class QMailStore;
+    friend class QMailStorePrivate;
+
+    QMailMessageMetaDataPrivate* metaDataImpl();
+    const QMailMessageMetaDataPrivate* metaDataImpl() const;
+
+    QMailMessagePrivate* partContainerImpl();
+    const QMailMessagePrivate* partContainerImpl() const;
+    
+    virtual void setUnmodified();
+
+    QByteArray duplicatedData(const QString&) const;
+    void updateMetaData(const QByteArray& id, const QString& value);
+
+    static QMailMessage fromRfc2822(LongString& ls);
+};
+
+typedef QList<QMailMessage> QMailMessageList;
+typedef QList<QMailMessageMetaData> QMailMessageMetaDataList;
+typedef QList<QMailMessage::MessageType> QMailMessageTypeList;
+
+Q_DECLARE_USER_METATYPE_ENUM(QMailMessageBody::TransferEncoding)
+Q_DECLARE_USER_METATYPE_ENUM(QMailMessagePartContainer::MultipartType)
+Q_DECLARE_USER_METATYPE_ENUM(QMailMessage::MessageType)
+Q_DECLARE_USER_METATYPE_ENUM(QMailMessage::ContentType)
+Q_DECLARE_USER_METATYPE_ENUM(QMailMessage::ResponseType)
+Q_DECLARE_USER_METATYPE_ENUM(QMailMessage::AttachmentsAction)
+
+Q_DECLARE_USER_METATYPE(QMailMessage)
+Q_DECLARE_USER_METATYPE(QMailMessageMetaData)
+Q_DECLARE_USER_METATYPE(QMailMessagePart::Location)
+
+Q_DECLARE_METATYPE(QMailMessageList)
+Q_DECLARE_METATYPE(QMailMessageMetaDataList)
+Q_DECLARE_METATYPE(QMailMessageTypeList)
+
+Q_DECLARE_USER_METATYPE_TYPEDEF(QMailMessageList, QMailMessageList)
+Q_DECLARE_USER_METATYPE_TYPEDEF(QMailMessageMetaDataList, QMailMessageMetaDataList)
+Q_DECLARE_USER_METATYPE_TYPEDEF(QMailMessageTypeList, QMailMessageTypeList)
+
+#endif