/*

 * 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 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: 

 *

 */

 /**

  @file

  @internalComponent

  @released 

 */

 #ifndef PLUGINMANAGER_H

 #define PLUGINMANAGER_H

 namespace UserPromptService

 	{	

 	class CPolicyEvaluator;

 	class CDialogCreator;

 	class CPolicyEvaluatorPlugin;

 	class CDialogCreatorPlugin;

 	class CPluginManager;

 	/**

 	Container class for a plug-in that notifies a manager object when 

 	it is destroyed.

 	*/

 	template <class T> 

 		class CPlugin : public CBase

 			{

 		public:

 			CPlugin(CPluginManager* aManager, T* aImp);

 			T& Imp();

 			~CPlugin();

 		private:

 			CPluginManager* iManager;	///< The plug-in manager that tracks active plug-ins.

 			T* iImp;					///< The policy evaluator or dialog creator owned by this object.

 			};

 	/**

 	Plug-in manager that tracks the number of plug-ins enabling REComSession::FinalClose()

 	to be deferred (after calling Unload) once all the plug-ins have been unloaded.

 	N.B. REComSession::FinalClose CANNOT be called from within an ECOM plug-in.	

 	*/

 	NONSHARABLE_CLASS(CPluginManager) : public CBase

 		{

 		template <class T> friend class CPlugin;

 	public:

 		IMPORT_C static CPluginManager* NewL();		

 		IMPORT_C CPlugin<CPolicyEvaluator>* CreateEvaluatorL(const TUid& aEvaluatorId);

 		IMPORT_C CPlugin<CDialogCreator>* CreateDialogCreatorL(const TUid& aDialogCreatorId);

 		IMPORT_C void Unload();	

 		~CPluginManager();

 	public:

 		// For testing. Do not modify directly

 		TInt iPluginCount;		///< The number of active CPlugin objects. (do not modify)

 	private:

 		CPluginManager();			

 		IMPORT_C void ReleasePlugin();

 		TBool iUnload;			///< Indicates that a deferred call to REComSession::FinalClose is required		

 		};	

 	template <class T>

 	inline CPlugin<T>::CPlugin(CPluginManager* aManager, T* aImp) : iManager(aManager), iImp(aImp)	

 	/**

 	Constructor

 	@param aManager	The plug-in manager that tracks the number of plug-ins in existance.

 	@param aImp		The ECOM implementation that this class managers.

 	*/

 		{

 		}

 	template <class T>

 	inline T& CPlugin<T>::Imp() 

 	/**

 	Gets a reference to the plug-in implementation

 	@return The plug-in implementation.

 	*/

 		{

 		return *iImp;

 		}

 	template <class T>

 	inline CPlugin<T>::~CPlugin() 

 	/**

 	Destructor

 	*/

 		{		

 		delete iImp;

 		iManager->ReleasePlugin();

 		}		

 	}

 #endif // PLUGINMANAGER_H