/*

* Copyright (c) 2005 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: Meeting request mailbox utils ECom implementation header.

*

*/

#ifndef __CMRMAILBOXUTILSIMPL_H__

#define __CMRMAILBOXUTILSIMPL_H__

//  INCLUDES

#include <cmrmailboxutils.h>

#include <msvapi.h>

// FORWARD DECLARATIONS

class CMRUtilsMsvHelper;

class CMRMBUtilsMBInfoHandler;

class CMRUtilsSettingsMgr;

class CCalUser;

class CMRMailboxUtilsImpl

    : public CMRMailboxUtils,

      public MMsvSessionObserver,

      public MMRMailboxUtilsObserver

    {    

    public: // Constructors and destructors

        /**

        * ECom plug-in instantiation method.

        *

        * @param aMsvSession, ownership not transferred

        * @return instantiated object

        */

        static CMRMailboxUtilsImpl* NewL( CMsvSession* aMsvSession );

        /**

        * Destructor.

        */

        ~CMRMailboxUtilsImpl();

    protected: // From CMRMailboxUtils

        TInt GetDefaultMRMailBoxL( TMailboxInfo& aBoxInfo );

        TInt SetDefaultMRMailBoxL( TMsvId aDefaultBox );

        void ListMailBoxesL( RArray<TMailboxInfo>& aMailBoxes );

        TInt GetSourceMtmUidL( const CCalEntry& aCalEntry, TUid& aMtmUid );

        CCalAttendee* ThisAttendeeL( const CCalEntry& aCalEntry );

        TBool IsOrganizerL( const CCalEntry& aCalEntry );

        TInt SetPhoneOwnerL( CCalEntry& aCalEntry,

                             TMsvId aPrimaryBox = KMsvNullIndexEntryId );                             

        void AddObserverL( MMRMailboxUtilsObserver& aObserver );

        void RemoveObserver( MMRMailboxUtilsObserver& aObserver );

        CMsvSession& MsvSessionL();

    protected: // From MMsvSessionObserver

        /**

        * CMRUtilsMsvHelpers performs first-hand filtering of

        * uninteresting events.

        */

        void HandleSessionEventL( TMsvSessionEvent aEvent, 

                                  TAny *aArg1, 

                                  TAny *aArg2, 

                                  TAny *aArg3 );

    protected: // From MMRMailboxUtilsObserver

        void HandleMRMailboxEventL( 

                MMRMailboxUtilsObserver::TEventType aType );

    protected: // New functions

        /**

        * Returns TPtrC to all/part of the aAddress parameter

        * so that possible "mailto:" prefix is stripped out.

        *

        * @param aAddress address which might contain the prefix

        * @return TPtrC which represents only the address

        */                        

        TPtrC AddressWithoutMailtoPrefix( const TDesC& aAddress );

        /**

        * Helper method for finding out phone owner.

        * @param aCalEntry entry containing matched organizer and attendees

        * @param aMailBoxes contains a list of mailboxes to evaluate

        * @param aMatchIndex contains matching mailbox if owner was found

        * @return phone owner, NULL if not found, ownership not transferred

        */

        CCalUser* PhoneOwnerL(

            const CCalEntry& aCalEntry,

            const RArray<CMRMailboxUtils::TMailboxInfo>& aMailBoxes,

            TInt& aMatchIndex );   

        /**

        * Helper method for checking whether aUser is phone owner.

        * @param aUser either an organizer or an attendee

        * @param aMailBoxes contains a list of mailboxes to evaluate

        * @param aMatchIndex contains matching mailbox if owner was found

        * @return ETrue if aUser is phone owner

        */  

        TBool IsPhoneOwnerL(

            const CCalUser& aUser,

            const RArray<CMRMailboxUtils::TMailboxInfo>& aMailBoxes,

            TInt& aMatchIndex );

        /**

        * Helper method for notifying all observers.

        */

        void NotifyObserversL( MMRMailboxUtilsObserver::TEventType aEvent );            

    protected: // Constructors

        /**

        * C++ default constructor.

        */

        CMRMailboxUtilsImpl();

        /**

        *  Constructor, second phase.

        */

        void ConstructL( CMsvSession* aMsvSession );            

    private:   // data

        // observers not own

        RPointerArray<MMRMailboxUtilsObserver> iObservers;

        // Msv helper, own

        CMRUtilsMsvHelper* iMsvHelper;              

        // Database manager, own

        CMRUtilsSettingsMgr* iSettingsMgr;

        CMRMBUtilsMBInfoHandler* iCmailHandler;

    };

#endif //__CMRMAILBOXUTILSIMPL_H__