/*
* Copyright (c) 2007-2009 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:  ESMR mr entry processor
*
*/

#ifndef CESMRENTRYPROCESSOR_H
#define CESMRENTRYPROCESSOR_H

#include <e32base.h>
#include <MAgnEntryUi.h>
//<cmail>
#include "esmrcommands.h"
#include "tesmrscenariodata.h"
//</cmail>

class MESMRCalDbMgr;
class CMRMailboxUtils;
class CCalInstance;
class MESMRMeetingRequestEntry;
class CESMRMeetingRequestEntry;
class CESMRFsMailboxUtils;

/**
* CESMREntryProcessor's main responsibility is to
* perform entry processing and evaluation in initialization phase.
*
* @lib esmrentry.lib
*/
NONSHARABLE_CLASS(CESMREntryProcessor) :
        public CBase
    {
public: // Construction and destruction
    /**
     * Creates new CESMREntryProcessor object. Ownership
     * is transferred to caller.
     * @param aMRMailboxUtils Refernce to MR Mailbox Utilities API.
     * @param aDbMgr Reference to calendar DB manager.
     * @return Pointer to created CESMREntryProcessor object,
     */
     IMPORT_C static CESMREntryProcessor* NewL(
        CMRMailboxUtils& aMRMailboxUtils,
        MESMRCalDbMgr& aDbMgr );

    /**
     * C++ destructor
     */
    IMPORT_C ~CESMREntryProcessor();

public: // Interface
    /**
     * Fetches scenario data.
     *
     * @return scenario data.
     */
    inline const TESMRScenarioData& ScenarioData() const;

    /**
     * Tests, whether processor contains entry, which it has processed
     * or not.
     *
     * @return ETrue, if contains processed entry.
     */
    inline TBool ContainsProcessedEntry() const;

    /**
     * Fetches the extension UID for ES MR entry processor.
     *
     * @return MRUI processor extension UID.
     */
    IMPORT_C static TUid ExtensionUid();

    /**
     * Process entries and constructs scenario data.
     *
     * @param aParam AGN Entry UI input parameters.
     * @param aEntries Calendar entries to be processed.
     *        Ownership is not transferred.
     */
    IMPORT_C void ProcessL(
            const MAgnEntryUi::TAgnEntryUiInParams* aParams,
            RPointerArray<CCalEntry>* aEntries );

    /**
     * Process entries. Scenario data is not constructed.
     *
     * @param aEntries Calendar entries to be processed.
     *        Ownership is not transferred.
     */
    IMPORT_C void ProcessL(
            RPointerArray<CCalEntry>* aEntries );

    /**
     * Processes calendar instance. All operations affects only the
     * processed instance.
     *
     * @param aInstance Reference to calendar instance.
     */
    IMPORT_C void ProcessL(
            CCalInstance& aInstance );

    /**
     * Switches processor for forwarding mode.
     * @error KErrNotReady no entries has been processed yet.
     */
    IMPORT_C void SwitchToForwardL();

    /**
     * Switches processor to edit mode.
     * @error KErrNotReady no entries has been processed yet.
     */
    IMPORT_C void SwitchToEditL();

    /**
     * Switches processor to view mode.
     * @error KErrNotReady no entries has been processed yet.
     */
    IMPORT_C void SwitchToViewL();

    /**
     * Switches processor to Tracking mode.
     * @error KErrNotReady no entries has been processed yet.
     */
     IMPORT_C void SwitchToTrackL();

    /**
     * Fetches ES MR Entry. Methods panics, if entries has not
     * been processed before calling this method.
     *
     * @return Reference to CESMRMeetingRequestEntry object.
     */
    IMPORT_C MESMRMeetingRequestEntry& ESMREntryL();

    /**
     * Resets the entry processor. After calling this method the
     * processor is in the same state than after creation.
     */
    IMPORT_C void ResetL();

    /**
     * Process output parameters. Processing is done according to command
     * passed as parameter.
     *
     * @param aOutputParams Reference to output parameters.
     * @param aCommand Command for which output parameters are processed.
     */
    IMPORT_C void ProcessOutputParametersL(
            MAgnEntryUi::TAgnEntryUiOutParams& aOutParams,
            TESMRCommand aCommand );

private: // Implementaton

    CESMREntryProcessor(
            CMRMailboxUtils& aMRMailboxUtils,
            MESMRCalDbMgr& aDbMgr );
    void ConstructL();
    void SetPhoneOwnerL();
    void CheckViewModeL();
    TBool IsDataOk() const;
    void CreateESMREntryL();
    void CheckOrganizerL();
    void SetPhoneOwnerToOwnEntryL();

private: // Data
    /**
    * Scenario data
    * Own.
    */
    TESMRScenarioData iScenData;

    /**
    * ES MR Entry
    * Own.
    */
    CESMRMeetingRequestEntry* iESMREntry;

    /**
    * Reference to MR Mailbox Utilities API
    * Not own.
    */
    CMRMailboxUtils& iMRMailboxUtils;

    /**
    * Reference to calendar DB manager
    * Not own.
    */
    MESMRCalDbMgr& iDbMgr;

    /**
    * Entries to be processed
    * Not own.
    */
    RPointerArray<CCalEntry>* iMREntries;

    /**
    * Input parameters from calling application
    * Not own.
    */
    const MAgnEntryUi::TAgnEntryUiInParams* iParams;
    
    /**
     * Own: Mailbox utils class.
     */
    CESMRFsMailboxUtils* iMbUtils;
    };

#include "cesmrentryprocessor.inl"

#endif // CESMRENTRYPROCESSOR_H