/*

* Copyright (c) 2002-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:

*

*

*/

#ifndef CALENGLOBALDATA_H

#define CALENGLOBALDATA_H

//  INCLUDES

#include <e32base.h>

#include <w32std.h>

// FORWARD DECLARATIONS

class CCalSession;                      // Calendar session

class CCalEntryView;                    // Calendar entry view

class CCalInstanceView;                 // Calendar instance view

class MCalenContextChangeObserver;      // Context changes

class MCalenContext;

// CLASS DECLARATION

/**

*  CCalenGlobalData is a singleton using Thread local storage

*  It provides easy access to instances of the following classes:

*       CMRMailboxUtils

*       CMRUtils

*       CCalSession

*       CCalInstanceView

*       CCalEntryView

*       CCalenInterimUtils2

*       CCalenSend

*       CCalenDbChangeNotifier

*       CCalenContext

*/

    {

    public:  // Constructors and destructor

        /**

         * The only classes that should call NewL are the controller

         * and server classes. Otherwise use InstanceL.

         * Doesn't take ownership of aNotifier.

         */

                            NewL( MCalProgressCallBack& aCalCallBack,

        /**

        * Constructor.  Returns a new instance of CCalenGlobalData if

        * none exists, or returns the existing instance.

        * @return CCalenGlobalData pointer

        */

        /**

        * Constructs CCalenGlobalData with an existing CCalSession.  It

        * is the responsibility of the caller to ensure that the session

        * remains open until ALL references to the CCalenGlobalData have been

        * released.  If the CCalenGlobalData already has created a different

        * CCalSessionthis call will leave with KErrAlreadyExists.  If the

        * CCalenGlobalData has previously been initialised with the same

        * external CCalSession, the  existing instance will be returned.

        * @param aSession initialised calendar session

        * @return CCalenGlobalData pointer

        */

        /**

        * Non-leaving version of constructor. Returns an instance of

        * CCalenGlobalData if one exists or NULL otherwise

        */

        /**

        * CCalenGlobalData is a reference counting singleton.  Call Release()

        * when you are done with it, it will clean itself up when it needs to

        */

    public: // New functions

        /**

        * Returns a reference to the calendar session

        * @return reference to a CCalSession

        */

        /**

        * Returns a pointer to the calendar instance view

        * if it has been constructed otherwise it

        * returns NULL and constructs the instance view

        * asynchronously.

        * @return pointer to a CCalInstanceView

        */

        * Returns a pointer to the calendar entry view

        * if it has been constructed otherwise it

        * returns NULL and constructs the entry view

        * asynchronously.

        * @return pointer to a CCalEntryView

        */

        /**

        * Returns information does complete entry view exist

        * @return ETrue if exists EFalse if does not exist.

        */

        /**

        * Returns a reference to the calendar context

        * @return reference to a CCalenContext

        */

    public: // MCalenNotificationHandler

        void HandleNotification( const TCalenNotification aNotification );

    private:

        /**

        * C++ constructor.

        *

        */

        CCalenGlobalData( MCalProgressCallBack& aCalCallBack);

        /**

        * By default Symbian 2nd phase constructor is private. 

        * Doesn't take ownership of aNotifier.

        */

        /**

        * Private Destructor.  Users of this class should call Release() instead

        */

        ~CCalenGlobalData();

        /**

        * Sets the CCalenGlobalData to use an externally created CCalSession.

        * Leaves with KErrAlreadyExists if a different session has already been

        * created by the CCalenGlobalData

        */

        void SetSessionL(CCalSession* aSession);

        /**

        */

        void CreateEntryViewL();

        /**

        * Create instanceview

        */

        void CreateInstanceViewL();

        /**

        * Handle clean up after entryview/ instanceview being created

        */

        void ViewCreationCompleted( TBool aSuccess );

        CCalSession* iCalSession;

        CCalEntryView* iEntryView;

        CCalEntryView* iEntryViewCreation;

        CCalInstanceView* iInstanceView;

        CCalInstanceView* iInstanceViewCreation;

        typedef void (CCalenGlobalData::*QueuedFunction)();

        QueuedFunction iQueued;

        // Not owned by class. Needed for entry and instance view

        // creation.

        MCalProgressCallBack& iCalCallBack;

    };

#endif  // CALENGLOBALDATA_H

// End of File