/*

* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies).

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of "Eclipse Public License v1.0"

* which accompanies this distribution, and is available

* at the URL "http://www.eclipse.org/legal/epl-v10.html".

*

* Initial Contributors:

* Nokia Corporation - initial contribution.

*

* Contributors:

*

* Description:  Email Interface base implementation header file.

*

*/

#ifndef __BASEPLUGIN_H__

#define __BASEPLUGIN_H__

#include <e32std.h>

#include <e32base.h>

#include "CFSMailPlugin.h"

#include "mmrorganizer.h"

//<cmail>

#include "MsgStoreFolderUtils.h"

#include "MsgStoreMailBox.h"

#include "MsgStoreMailBoxObserver.h"

#include "MsgStoreMessage.h"

#include "MsgStoreObserver.h"

#include "DebugLogMacros.h"

//</cmail>

//<qmail> Entire CBasePlugin class is exported in 10.1

#include "baseplugindef.h"

//</qmail>

#include "basemrinfoobject.h"

#include "Map.h"

class CMsgStore;

class CBaseMrInfoProcessor;

class TDayOfWeekFtor;

class CFetchRequester;

class CMailboxInfo;

class CSearchHandler;

class HMailIterator;

class CDelayedOpsManager;

class MDelayedOpsManager;

//<qmail>

/**

* reply/forward message creation parameters

*/

struct TReplyForwardParams

    {

    HBufC* iHeader; // reply/forward header, ownership stays in UI

    HBufC* iSmartTag; // smart reply/forward tag, ownership stays in UI

    };

//</qmail>

/**

 * Notes for derived classes:

 * GetPluginId - you must override this to return the ECOM id of the plugin.

 */

class BASEPLUGIN_EXPORT CBasePlugin :

    public CFSMailPlugin,

    public MMsgStoreObserver,

    protected MMsgStoreMailBoxObserver

    {

    friend class HMailIterator;

    friend class CBaseMrInfoProcessor;

    friend class CMailboxInfo;

    friend class CSearchHandler;

    //there is a need for a better way to access internal plugin state by

    //private components.

    friend class CDelayedDeleteMessagesOp;

    friend class CDelayedSetContentOp;

    friend class CDelayedMessageStorerOp;

	protected:

    struct TOngoingFetchInfo;

    struct TCacheLine

        {

        CMsgStoreMessage* iMsg;

        CMsgStoreMessagePart* iBody;

        RPointerArray<CMsgStoreMessagePart> iMsgChildren;

        RPointerArray<CMsgStoreMessagePart> iBodyChildren;

        };

    public:

        static CBasePlugin* NewL();

        static CBasePlugin* NewLC();

        virtual ~CBasePlugin();

    protected:

         CBasePlugin();

         void ConstructL();

    // CFSMailPlugin //

    public:

         virtual void ListMailBoxesL(

            RArray<TFSMailMsgId>& aMailboxes );

         virtual CFSMailBox* GetMailBoxByUidL(

            const TFSMailMsgId& aMailBox);

	     virtual void DeleteMailBoxByUidL(

	        const TFSMailMsgId& aMailBoxId,

	        MFSMailRequestObserver& aOperationObserver,

			const TInt aRequestId );

         virtual TDesC& GetBrandingIdL(

            const TFSMailMsgId& aMailboxId );

         virtual void MoveMessagesL(

            const TFSMailMsgId& aMailBoxId,

            const RArray<TFSMailMsgId>& aMessageIds,

            const TFSMailMsgId& aSourceFolderId,

            const TFSMailMsgId& aDestinationFolderId );

         virtual void CopyMessagesL(

            const TFSMailMsgId& aMailBoxId,

            const RArray<TFSMailMsgId>& aMessageIds,

            RArray<TFSMailMsgId>& aNewMessages,

            const TFSMailMsgId& aSourceFolderId,

            const TFSMailMsgId& aDestinationFolderId );

         MDesCArray* GetMrusL(

            const TFSMailMsgId& aMailBoxId );

         void SetMrusL(

            const TFSMailMsgId& aMailBoxId,

            MDesCArray* aNewMruList );

         void GoOnlineL(

            const TFSMailMsgId& aMailBoxId );

         void GoOfflineL(

            const TFSMailMsgId& aMailBoxId );

         const TFSProgress GetLastSyncStatusL(

            const TFSMailMsgId& aMailBoxId );

         void RefreshNowL(

            const TFSMailMsgId& aMailBoxId,

         	MFSMailRequestObserver& aOperationObserver,

         	TInt aRequestId );

         virtual CFSMailFolder* GetFolderByUidL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aFolderId );

         virtual CFSMailFolder* CreateFolderL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aFolderId,

            const TDesC& aFolderName,

            const TBool aSync );

         virtual void DeleteFolderByUidL(

            const TFSMailMsgId& aMailBox,

            const TFSMailMsgId& aFolder );

         virtual void ListFoldersL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aFolderId,

            RPointerArray<CFSMailFolder>& aFolderList );

         virtual void ListFoldersL(

            const TFSMailMsgId& aMailBoxId,

            RPointerArray<CFSMailFolder>& aFolderList );

         virtual TFSMailMsgId GetStandardFolderIdL(

            const TFSMailMsgId& aMailBoxId,

            const TFSFolderType aFolderType );

         virtual MFSMailIterator* ListMessagesL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aFolderId,

            const TFSMailDetails aDetails,

            const RArray<TFSMailSortCriteria>& aSorting );

         virtual CFSMailMessage* GetMessageByUidL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aFolderId,

            const TFSMailMsgId& aMessageId,

            const TFSMailDetails aDetails );

        /**

         * The delete is executed asynchronously. The base plugin will queue

         * the request and return immediately.

         */

         virtual void DeleteMessagesByUidL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aFolderId,

            const RArray<TFSMailMsgId>& aMessages );

         virtual CFSMailMessage* CreateMessageToSendL(

            const TFSMailMsgId& aMailBox );

// <qmail>

        virtual void CreateMessageToSendL(

            const TFSMailMsgId& aMailBoxId,

            MFSMailRequestObserver& aOperationObserver,

            const TInt aRequestId );

// </qmail>

         virtual CFSMailMessage* CreateForwardMessageL(

            const TFSMailMsgId& aMailBox,

            const TFSMailMsgId& aOriginal,

            const TDesC& aHeaderDescriptor );

         virtual CFSMailMessage* CreateReplyMessageL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aOriginalMessageId,

            const TBool aReplyToAll,

            const TDesC& aHeaderDescriptor );

         virtual void StoreMessageL(

            const TFSMailMsgId& aMailBoxId,

            CFSMailMessage& aMessage );

// <qmail>

         void StoreMessagesL(

                const TFSMailMsgId& aMailBoxId,

                RPointerArray<CFSMailMessage> &messages,

                MFSMailRequestObserver& aOperationObserver,

                const TInt aRequestId );

// </qmail>

// <qmail>

        virtual void StoreMessagePartsL(

               RPointerArray<CFSMailMessagePart>& aMessageParts,

               MFSMailRequestObserver& aOperationObserver,

               const TInt aRequestId);

// <//qmail>

         virtual void FetchMessagesL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aFolderId,

            const RArray<TFSMailMsgId>& aMessageIds,

            TFSMailDetails aDetails,

            MFSMailRequestObserver& aObserver,

            TInt aRequestId );

         virtual void FetchMessagePartsL(

            const TFSMailMsgId& aMailBoxId,

     		const TFSMailMsgId& aFolderId,

     		const TFSMailMsgId& aMessageId,

     		const RArray<TFSMailMsgId>& aMessagePartIds,

        	MFSMailRequestObserver& aOperationObserver,

			const TInt aRequestId,

        	const TUint aPreferredByteCount );

         virtual void GetMessagesL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

            const RArray<TFSMailMsgId>& aMessageIds,

            RPointerArray<CFSMailMessage>& aMessageList,

            TFSMailDetails aDetails );

         virtual void ChildPartsL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

			const TFSMailMsgId& aMessageId,

     		const TFSMailMsgId& aParentId,

     		RPointerArray<CFSMailMessagePart>& aParts );

         virtual CFSMailMessagePart* NewChildPartL(

            const TFSMailMsgId& aMailBoxId,

        	const TFSMailMsgId& aParentFolderId,

			const TFSMailMsgId& aMessageId,

     		const TFSMailMsgId& aParentPartId,

        	const TFSMailMsgId& aInsertBefore,

        	const TDesC& aContentType );

         virtual CFSMailMessagePart* CopyMessageAsChildPartL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

			const TFSMailMsgId& aMessageId,

        	const TFSMailMsgId& aParentPartId,

        	const TFSMailMsgId& aInsertBefore,

        	const CFSMailMessage& aMessage );

         virtual void RemoveChildPartL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

        	const TFSMailMsgId& aMessageId,

            const TFSMailMsgId& aParentPartId,

            const TFSMailMsgId& aPartId );

         virtual void SetPartContentFromFileL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

            const TFSMailMsgId& aMessageId,

            const TFSMailMsgId& aMessagePartId,

            const TDesC& aFilePath );

         virtual void StoreMessagePartL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

         	const TFSMailMsgId& aMessageId,

         	CFSMailMessagePart& aMessagePart );

         virtual CFSMailMessagePart* MessagePartL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

            const TFSMailMsgId& aMessageId,

            const TFSMailMsgId& aMessagePartId );

         virtual TInt GetMessagePartFileL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

            const TFSMailMsgId& aMessageId,

            const TFSMailMsgId& aMessagePartId,

            RFile& aFileHandle );

         virtual void CopyMessagePartFileL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

            const TFSMailMsgId& aMessageId,

            const TFSMailMsgId& aMessagePartId,

            const TDesC& aFilePath );

	     virtual void GetContentToBufferL(

	        const TFSMailMsgId& aMailBoxId,

	        const TFSMailMsgId& aParentFolderId,

	 		const TFSMailMsgId& aMessageId,

	 		const TFSMailMsgId& aMessagePartId,

	 		TDes& aBuffer,

	 		TUint aStartOffset );

	     virtual void SetContentL(

	        const TDesC& aBuffer,

	        const TFSMailMsgId& aMailBoxId,

	        const TFSMailMsgId& aParentFolderId,

            const TFSMailMsgId& aMessageId,

            const TFSMailMsgId& aMessagePartId);

         virtual void RemovePartContentL(

            const TFSMailMsgId& aMailBoxId,

            const TFSMailMsgId& aParentFolderId,

            const TFSMailMsgId& aMessageId,

            const RArray<TFSMailMsgId>& aPartIds );

	     virtual void SearchL(

	        const TFSMailMsgId& aMailBoxId,

			const RArray<TFSMailMsgId>& aFolderIds,

			const RPointerArray<TDesC>& aSearchStrings,

			const TFSMailSortCriteria& aSortCriteria,

			MFSMailBoxSearchObserver& aSearchObserver );

    	 virtual void CancelSearch(

    	    const TFSMailMsgId& aMailBoxId );

         virtual void ClearSearchResultCache(

            const TFSMailMsgId& aMailBoxId );

         virtual void AddObserverL(

            MFSMailEventObserver& aObserver );

         virtual void RemoveObserver(

            MFSMailEventObserver& aObserver );

         virtual void UnregisterRequestObserver(

            TInt aRequestId );

         virtual void SendMessageL(

            CFSMailMessage& aMessage );

         virtual TFSProgress StatusL(

            TInt aRequestId );

         virtual void CancelL(

            TInt aRequestId );

         virtual void SubscribeMailboxEventsL(

            const TFSMailMsgId& aMailboxId,

            MFSMailEventObserver& aObserver );

         virtual void UnsubscribeMailboxEvents(

            const TFSMailMsgId& aMailboxId,

            MFSMailEventObserver& aObserver );

//<qmail>

         virtual TSSMailSyncState CurrentSyncState(

            const TFSMailMsgId& aMailboxId );

//</qmail>

         virtual TFSMailBoxStatus GetMailBoxStatus(

            const TFSMailMsgId& aMailboxId );

         virtual TBool MailboxHasCapabilityL(

            TFSMailBoxCapabilities aCapability,

	 		TFSMailMsgId aMailBoxId );

	    /**

	     * Create a new ChildPart using a file path

	     */

	     virtual CFSMailMessagePart* NewChildPartFromFileL(

		    const TFSMailMsgId& aMailBoxId,

		    const TFSMailMsgId& aParentFolderId,

		    const TFSMailMsgId& aMessageId,

		    const TFSMailMsgId& aParentPartId,

			const TDesC& aContentType,

		    const TDesC& aFilePath );

	    /**

	     * Create a new ChildPart using a file handle

         *  NOTE 1: RFs.ShareProtected() must have been called already before calling this method.

         *  NOTE 2: The ownersip of the RFile handle (aFile) is transferred to this method.

	     */

	     virtual CFSMailMessagePart* NewChildPartFromFileL(

		    const TFSMailMsgId& aMailBoxId,

		    const TFSMailMsgId& aParentFolderId,

		    const TFSMailMsgId& aMessageId,

		    const TFSMailMsgId& aParentPartId,

			const TDesC& aContentType,

		    RFile& aFile );

         virtual TInt WizardDataAvailableL();

         virtual void AuthenticateL(

            MFSMailRequestObserver& aOperationObserver,

            TInt aRequestId );

         virtual void SetCredentialsL(

            const TFSMailMsgId& aMailBoxId,

            const TDesC& aUsername,

            const TDesC& aPassword );

         virtual TInt CancelSyncL(

        	const TFSMailMsgId& aMailBoxId );

         virtual void SetMailboxName(

            const TFSMailMsgId& /*aMailboxId*/,

            const TDesC& /*aMailboxName*/ );

    // MMsgStoreObserver //

    public:

         virtual void SystemEventNotify(

            TMsgStoreSystemEvent aEvent );

         virtual void AccountEventNotify(

            TMsgStoreAccountEvent aEvent,

    		TInt32 aOwnerId,

            const TDesC& aName,

    		const TDesC& aNewName,

    		TMsgStoreId aMailboxId );

         virtual void ModificationNotify(

            TMsgStoreId aMailBoxId,

            TMsgStoreOperation aOperation,

            TMsgStoreContainerType aType,

            TUint32 aFlags,

            TMsgStoreId aId,

            TMsgStoreId aParentId,

            TMsgStoreId aOtherId );

    protected:

         CFSMailAddress* FetchEmailAddressL(

            CMsgStorePropertyContainer& aMessage,

            TUint aIdx );

         CMailboxInfo& GetMailboxInfoL(

            TMsgStoreId aId );

        void GetMailboxDisplayNameL(

            TMsgStoreId aId,

            RBuf& aDisplayName );

         virtual TUint GetPluginId();

        /**

         * Get signature string from protocol specific subclass.

         * Caller is responsible for memory of returned string.

         */

        virtual HBufC* GetSignatureL( TFSMailMsgId /* aMailBox */ )

        	{

        	return NULL;

        	}