File indexing completed on 2024-05-26 05:28:06

 /* Copyright (C) 2006 - 2014 Jan Kundrát <jkt@flaska.net>
 
    This file is part of the Trojita Qt IMAP e-mail client,
    http://trojita.flaska.net/
 
    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 2 of
    the License or (at your option) version 3 or any later version
    accepted by the membership of KDE e.V. (or its successor approved
    by the membership of KDE e.V.), which shall act as a proxy
    defined in Section 14 of version 3 of the license.
 
    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, see <http://www.gnu.org/licenses/>.
 */
 
 #ifndef COMPOSER_COMPOSERATTACHMENTS_H
 #define COMPOSER_COMPOSERATTACHMENTS_H
 
 #include <QIODevice>
 #include <QPersistentModelIndex>
 #include <QPointer>
 #include <QSharedPointer>
 #include "Composer/ContentDisposition.h"
 
 namespace Imap {
 namespace Mailbox {
 
 class Model;
 class FullMessageCombiner;
 class TreeItemMessage;
 class TreeItemPart;
 
 }
 }
 
 namespace Composer {
 
 /** @short A generic item to be used as an attachment */
 class AttachmentItem {
 public:
     AttachmentItem();
     virtual ~AttachmentItem();
 
     virtual QString caption() const = 0;
     virtual QString tooltip() const = 0;
     virtual QByteArray mimeType() const = 0;
     virtual QByteArray contentDispositionHeader() const;
     virtual ContentDisposition contentDispositionMode() const;
     virtual bool setContentDispositionMode(const ContentDisposition contentDisposition);
     virtual QString contentDispositionFilename() const = 0;
     virtual bool setPreferredFileName(const QString &name) = 0;
 
     /** @short Return shared pointer to QIODevice which is ready to return data for this part
 
     The underlying QIODevice MUST NOT be stored for future use.  It is no longer valid after the source
     AttachmentItem is destroyed.
 
     The QIODevice MAY support only a single reading pass.  If the caller wants to read data multiple times, they should
     obtain another copy through calling rawData again.
 
     This function MAY return a null pointer if the data is not ready yet. Always use isAvailable() to make sure that
     the function will return correct data AND check the return value due to a possible TOCTOU issue.
 
     When the event loop is renetered, the QIODevice MAY become invalid and MUST NOT be used anymore.
 
     (I really, really like the RFC way of expression constraints :). )
     */
     virtual QSharedPointer<QIODevice> rawData() const = 0;
 
     /** @short Return true if the data are already available from a local cache */
     virtual bool isAvailableLocally() const = 0;
 
     enum class ContentTransferEncoding {
         SevenBit,
         EightBit,
         Binary,
         Base64,
         QuotedPrintable,
     };
     virtual ContentTransferEncoding suggestedCTE() const = 0;
 
     /** @short Returns a valid IMAP URL or an empty QByteArray if the data are not available from an IMAP server */
     virtual QByteArray imapUrl() const = 0;
 
     /** @short Express interest in having the attachment data available locally */
     virtual void preload() const = 0;
 
     /** @short Different sorts of possible attachments */
     typedef enum {
         ATTACHMENT_IMAP_MESSAGE,
         ATTACHMENT_IMAP_PART,
         ATTACHMENT_FILE
     } AttachmentKind;
 
     /** @short Describe the data for use in a drag-and-drop operation */
     virtual void asDroppableMimeData(QDataStream &stream) const = 0;
 
 protected:
     ContentDisposition m_contentDisposition;
 };
 
 /** @short Part of a message stored in an IMAP server */
 class ImapMessageAttachmentItem: public AttachmentItem {
 public:
     ImapMessageAttachmentItem(Imap::Mailbox::Model *model, const QString &mailbox, const uint uidValidity, const uint uid);
     ~ImapMessageAttachmentItem();
 
     QString caption() const override;
     QString tooltip() const override;
     QByteArray mimeType() const override;
     QString contentDispositionFilename() const override;
     bool setPreferredFileName(const QString &name) override;
     QSharedPointer<QIODevice> rawData() const override;
     bool isAvailableLocally() const override;
     ContentTransferEncoding suggestedCTE() const override;
     QByteArray imapUrl() const override;
     void preload() const override;
     void asDroppableMimeData(QDataStream &stream) const override;
 private:
     Imap::Mailbox::FullMessageCombiner *fullMessageCombiner;
     QPersistentModelIndex index;
     QString preferredName;
 };
 
 /** @short Part of a message stored in an IMAP server */
 class ImapPartAttachmentItem: public AttachmentItem {
 public:
     ImapPartAttachmentItem(Imap::Mailbox::Model *model, const QString &mailbox, const uint uidValidity, const uint uid, const QByteArray &trojitaPath);
     ~ImapPartAttachmentItem();
 
     QString caption() const override;
     QString tooltip() const override;
     QByteArray mimeType() const override;
     QString contentDispositionFilename() const override;
     bool setPreferredFileName(const QString &name) override;
     QSharedPointer<QIODevice> rawData() const override;
     bool isAvailableLocally() const override;
     ContentTransferEncoding suggestedCTE() const override;
     QByteArray imapUrl() const override;
     void preload() const override;
     void asDroppableMimeData(QDataStream &stream) const override;
 private:
     QPersistentModelIndex index;
     QString preferredName;
 };
 
 /** @short On-disk file */
 class FileAttachmentItem: public AttachmentItem {
 public:
     explicit FileAttachmentItem(const QString &fileName);
     ~FileAttachmentItem();
 
     QString caption() const override;
     QString tooltip() const override;
     QByteArray mimeType() const override;
     QString contentDispositionFilename() const override;
     bool setPreferredFileName(const QString &name) override;
     QSharedPointer<QIODevice> rawData() const override;
     bool isAvailableLocally() const override;
     ContentTransferEncoding suggestedCTE() const override;
     QByteArray imapUrl() const override;
     void preload() const override;
     void asDroppableMimeData(QDataStream &stream) const override;
 private:
     QString fileName;
     QString preferredName;
     mutable QByteArray m_cachedMime;
 };
 
 }
 
 #endif // COMPOSER_COMPOSERATTACHMENTS_H