/*
* Copyright (c) 2005-2006 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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:  CLandmarkManageHandlers class
 *
*/


#ifndef __CLANDMARKMANAGEHANDLERS_H__
#define __CLANDMARKMANAGEHANDLERS_H__

// INCLUDES
#include <e32base.h>
#include <e32cmn.h>

//FORWARD DECLARARTION
class CPosLandmarkDatabase;
class CPosLmCategoryManager;
class CPosLandmarkSearch;
class CLandmarkHandler;

/**
 * CLandmarkManageHandlers
 * This class maintains a list of handles to different databases.
 */
// CLASS DECLARATION
NONSHARABLE_CLASS(CLandmarkManageHandlers): public CBase
	{
public: // New methods

	/**
	 * NewL.
	 * Two-phased constructor.
	 * Create a CPosLmManageHandle object.	
	 * @return A pointer to the newly created instance of CLandmarkManageHandlers.	
	 */
	static CLandmarkManageHandlers* NewL();

	/**
	 * ~CPosLmManageHandle
	 * Destructor.
	 */
	~CLandmarkManageHandlers();

public: // Functions to create, return and destroy handle

	/**
	 * CreateHandlerL
	 * This creates and returns CLandmarkHandler instance.
	 * @param aDatabaseUri The URI of the database to be opened.
	 * @return A pointer to the newly created instance of CLandmarkHandler.
	 */
	CLandmarkHandler* CreateHandlerL( const TDesC& aDatabaseUri );

	/**
	 * GetHandlerL
	 * This returns CLandmarkHandler instance.
	 * @param aDatabaseUri The URI of the database to be opened.
	 * @return A pointer to an existing instance of CLandmarkHandler.
	 */
	CLandmarkHandler* GetHandlerL( const TDesC& aDatabaseUri );

	/**
	 * CloseHandler
	 * This destroys CLandmarkHandler instance.
	 * @param aHandler The CLandmarkHandler instance to be destroyed.
	 */
	void CloseHandler( CLandmarkHandler* aHandler );

	/**
	 * SetDefaultHandler
	 * This changes the default handle managed by this class.
	 * @param aHandler The CLandmarkHandler instance to be set as default.
	 */
	void SetDefaultHandler( CLandmarkHandler* aHandler );

private: // Constructors

	/**
	 * CLandmarkManageHandlers.
	 * C++ default constructor.
	 */
	CLandmarkManageHandlers();

private: // Data members

	/**
	 * iHandlers
	 * Array of CLandmarkHandler instances to all open databases.
	 */
	RPointerArray <CLandmarkHandler> iHandlers;

	/**
	 * iDefaultHandler
	 * CLandmarkHandler instance to the default database.
	 */
	CLandmarkHandler* iDefaultHandler;
	};

/**
 * CLandmarkHandler
 * This class maintains a handle to an open database as well as the CPosLmCategoryManager
 * handle and CPosLandmarkSearch handle associated with the CPosLandmarkDatabase
 * database.
 */
// CLASS DECLARATION
NONSHARABLE_CLASS(CLandmarkHandler): public CBase
	{
public: // New methods

	/**
	 * CreateL.
	 * Two-phased constructor.
	 * Create a CLandmarkHandler object.
	 * @param aDatabaseUri The URI of the database to be opened.
	 * @return A pointer to the created instance of CLandmarkHandler.
	 */
	static CLandmarkHandler* CreateL( const TDesC& aDatabaseUri );

	/**
	 * ~CLandmarkHandler
	 * Destructor.
	 */
	~CLandmarkHandler();

public: // Functions to retrieve data members

	/**
	 * LandmarkDatabaseHandle.
	 * @return The handle to CPosLandmarkDatabase instance.
	 */
	inline CPosLandmarkDatabase* LandmarkDatabaseHandle ();

	/**
	 * CategoryManagerHandle.
	 * @return The handle to CPosLmCategoryManager instance.
	 */
	inline CPosLmCategoryManager* CategoryManagerHandle ();

	/**
	 * LandmarkSearchHandle.
	 * @return The handle to CPosLandmarkSearch instance.
	 */
	inline CPosLandmarkSearch* LandmarkSearchHandle ();

	/**
	 * GetDatabaseUri.
	 * @param aDatabaseUri The URI of the open CPosLandmarkDatabase.
	 */
	inline void GetDatabaseUri( TPtrC& aDatabaseUri ) const;

	/**
	 * InitL.
	 * This initializes the CPosLandmarkDatabase if required.
	 */
	void InitL();

private: // Constructors

	/**
	 * ConstructL
	 * 2nd phase constructor.
	 * Perform the second phase construction of a
	 * CLandmarkHandler object.
	 * @param aDatabaseUri The URI of the CPosLandmarkDatabase to be opened.
	 */
	void ConstructL(const TDesC& aDatabaseUri);

	/**
	 * CLandmarkHandler.
	 * C++ default constructor.
	 */
	CLandmarkHandler();

private: // Data members

	/**
	 * iDatabaseUri
	 * The URI of the open CPosLandmarkDatabase.
	 */
	HBufC* iDatabaseUri;

	/**
	 * iLandmarkDatabaseHandle
	 * The handle to the open CPosLandmarkDatabase.
	 */
	CPosLandmarkDatabase* iLandmarkDatabaseHandle;

	/**
	 * iLmCategoryManagerHandle
	 * The handle to the CPosLmCategoryManager of the database.
	 */
	CPosLmCategoryManager* iLmCategoryManagerHandle;

	/**
	 * iLandmarkSearchHandle
	 * The handle to the CPosLandmarkSearch of the database.
	 */
	CPosLandmarkSearch* iLandmarkSearchHandle;
	};

#include "clandmarkhandler.inl"

#endif // __CLANDMARKMANAGEHANDLERS_H__

// End of File
