itemcontext.h

/*
 * SPDX-FileCopyrightText: 1996-1998 Stefan Taferner <[email protected]>
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 *
 */
 
#pragma once
 
#include "mailcommon/searchpattern.h"
#include "mailcommon_export.h"
 
#include <Akonadi/Collection>
#include <Akonadi/Item>
 
namespace MailCommon
{
/**
 * @short A helper class for the filtering process
 *
 * The item context is used to pass the item together with meta data
 * through the filter chain.
 * This allows to 'record' all actions that shall be taken and execute them
 * at the end of the filter chain.
 */
class MAILCOMMON_EXPORT ItemContext
{
public:
    /**
     * Creates an item context for the given @p item.
     * @p requestedPart the part requested for the item (Envelope, Header or CompleteMessage)
     */
    ItemContext(const Akonadi::Item &item, bool needsFullPayload);
 
    /**
     * Returns the item of the context.
     */
    Akonadi::Item &item();
 
    /**
     * Sets the target collection the item should be moved to.
     */
    void setMoveTargetCollection(const Akonadi::Collection &collection);
 
    /**
     * Returns the target collection the item should be moved to, or an invalid
     * collection if the item should not be moved at all.
     */
    Q_REQUIRED_RESULT Akonadi::Collection moveTargetCollection() const;
 
    /**
     * Marks that the item's payload has been changed and needs to be written back.
     */
    void setNeedsPayloadStore();
 
    /**
     * Returns whether the item's payload needs to be written back.
     */
    Q_REQUIRED_RESULT bool needsPayloadStore() const;
 
    /**
     * Marks that the item's flags has been changed and needs to be written back.
     */
    void setNeedsFlagStore();
 
    /**
     * Returns whether the item's flags needs to be written back.
     */
    Q_REQUIRED_RESULT bool needsFlagStore() const;
 
    /** Returns true if the full payload was requested for the item or not.
     * Full payload is needed to change the headers or the body */
    Q_REQUIRED_RESULT bool needsFullPayload() const;
 
    void setDeleteItem();
    Q_REQUIRED_RESULT bool deleteItem() const;
 
private:
    enum ItemContextAction { None = 0, PlayloadStore = 1, FlagStore = 2, DeleteItem = 4, FullPayload = 8 };
    Q_DECLARE_FLAGS(ItemContextActions, ItemContextAction)
 
    Akonadi::Item mItem;
    Akonadi::Collection mMoveTargetCollection;
    ItemContextActions mItemContextAction;
};
}