/*

* Copyright (c) 2008 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:  Presence in pbonebook

*

*/

#ifndef CONTACTSTOREACCESSOR_H

#define CONTACTSTOREACCESSOR_H

// INCLUDES

#include <e32std.h>

#include <e32base.h>

#include <MVPbkContactStoreListObserver.h>

#include <MVPbkContactStoreObserver.h>

#include <MPbk2StoreConfigurationObserver.h>

class TVPbkContactStoreEvent;

class MVPbkContactStore;

class CVPbkContactManager;

class MVPbkContactStoreList;

class CPbk2StoreConfiguration;

class CPresenceIconInfoListener;

// CLASS DECLARATION

/**

*  CContactStoreAccessor

*

*/

NONSHARABLE_CLASS( CContactStoreAccessor ): public CBase,

public MVPbkContactStoreListObserver

{

public: // Constructors and destructor

    /**

    * Destructor.

    */

    ~CContactStoreAccessor();

    /**

    * Two-phased constructor.

    */

    static CContactStoreAccessor* NewL( CVPbkContactManager* aManager, CPresenceIconInfoListener& aListener );

public: // new methods

    void OpenStoresL( TRequestStatus& aStatus );

    void OpenStoresL( TRequestStatus& aStatus, const TDesC8& aPackedLink  );    

    MVPbkContactStoreList* AccessStoreList();

    CVPbkContactManager* AccessContactManager();

    void CreateConfigurationL();

private:  //From MVPbkContactStoreListObserver

    /**

    * Called when the opening process is complete, ie. all stores have been reported

    * either failed or successful open.

    */

    void OpenComplete();

private:  //From MVPbkContactStoreObserver

    /**

    * Called when a contact store is ready to use.

    */

    void StoreReady( MVPbkContactStore& aContactStore );

    /**

    * Called when a contact store becomes unavailable.

    * Client may inspect the reason of the unavailability and decide whether or not

    * it will keep the store opened (ie. listen to the store events).

    * @param aContactStore The store that became unavailable.

    * @param aReason The reason why the store is unavailable.

    *                This is one of the system wide error codes.

    */

    void StoreUnavailable( MVPbkContactStore& aContactStore, TInt aReason );

    /**

     * Called when changes occur in the contact store.

     * @see TVPbkContactStoreEvent

     * @param aContactStore The store the event occurred in.

     * @param aStoreEvent   Event that has occured.

     */

    void HandleStoreEventL( MVPbkContactStore& aContactStore, TVPbkContactStoreEvent aStoreEvent );

private:

    /**

    * Constructor for performing 1st stage construction

    */

    CContactStoreAccessor(CPresenceIconInfoListener& aListener);

    /**

    * EPOC default constructor for performing 2nd stage construction

    */

    void ConstructL( CVPbkContactManager* aManager );

    void DoCloseStore();    

private: // data

    TRequestStatus* iClientStatus;

    TBool iStoreReady;

    MVPbkContactStore* iContactStore;

    CVPbkContactManager* iContactManager;

    MVPbkContactStoreList* iStoreList;

    CPbk2StoreConfiguration* iStoreConfiguration;

    /**

     * Whether open request is pending

     */

    TBool iOpening;

    TBool iGivenManager;

    /**

     * Pointer to stack variable to detect the deletion of the heap

     * instance. This case takes place if a client

     * calls destructor in callback method.

     * Own.

     */

     TBool* iDestroyedPtr;

     /**

      * Listener for contact modifications

      */

     CPresenceIconInfoListener& iListener;            

};

#endif // CONTACTSTOREACCESSOR_H