sl@0: // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: //
sl@0: 
sl@0: #ifndef __TLSDATA_H__
sl@0: #define __TLSDATA_H__
sl@0: 
sl@0: /** 
sl@0: @internalComponent
sl@0: @file
sl@0: Comments : definition of the thread local storage data structure,
sl@0: 			and the global access pointer.
sl@0: */
sl@0: #include <ecom/ecom.h>
sl@0: 
sl@0: //Forward declarations
sl@0: class CLoadManager;
sl@0: class CGlobalData;
sl@0: 
sl@0: /**
sl@0: CGlobalData class controls the life time of a single CEComSession instance and
sl@0: single CLoadManager instance. It works in a close cooperation with REComSession class.
sl@0: The life time of the CGlobalData singleton instance will be controlled  by the following
sl@0: static and non-static methods of REComSession:
sl@0: 1) REComSession::OpenL() (static method).
sl@0:    CGlobalData singleton instance, so the CEComSession instance and CLoadManager instance, 
sl@0:    will be created during the first successfull call of REComSession::OpenL(). 
sl@0:    Each next REComSession::OpenL() call will not create new CGlobalData instance, 
sl@0:    it will just increment the reference count of the already created singleton.
sl@0: 2) REComSession::Close() (non-static method).
sl@0:    It will not destroy the created CGlobalData singleton, it will just decrement its 
sl@0:    reference count.
sl@0: 3) REcomSession::FinalClose() (static method).
sl@0:    It will check the reference count of CGlobalData singleton and if it is less or equal to
sl@0:    0, then CGlobalData singleton, so the CEComSession instance and CLoadManager instance, 
sl@0:    will be destroyed.
sl@0: @internalComponent
sl@0: */
sl@0: NONSHARABLE_CLASS(CGlobalData) : public CBase
sl@0: 	{
sl@0: public:	
sl@0: 	static CGlobalData* NewL();
sl@0: 	static CGlobalData* Instance();
sl@0: 	virtual ~CGlobalData();
sl@0: 	
sl@0: 	inline TInt IncRefCnt();
sl@0: 	inline TInt DecRefCnt();
sl@0: 	inline TInt RefCnt() const;
sl@0: 	
sl@0: 	inline REComSession& EComSession();
sl@0: 	inline CLoadManager& LoadManager();
sl@0: 	
sl@0: private:	
sl@0: 	CGlobalData();
sl@0: 	void ConstructL();
sl@0: 	
sl@0: private:	
sl@0: 	/** The overall count of successfull REComSession::OpenL() calls. */
sl@0: 	TInt iRefCount;
sl@0: 	/** The single REComSession instance */
sl@0: 	REComSession iEComSession;
sl@0: 	/** Handles the loading of the dlls and the deletion of objects */
sl@0: 	CLoadManager* iLoadManager;
sl@0: 	};
sl@0: 
sl@0: /**
sl@0: Increments the reference count of CGlobalData object. 
sl@0: It should be called for every successfull call of REComSession::OpenL(). 
sl@0: @return Reference count value after the increment.
sl@0: */
sl@0: inline TInt CGlobalData::IncRefCnt()
sl@0: 	{
sl@0: 	return ++iRefCount;
sl@0: 	}
sl@0: 
sl@0: /**
sl@0: Decrements the CGlobalData object's reference count. 
sl@0: It should be called from REComSession::Close(). 
sl@0: @return Reference count value after the decrement.
sl@0: */	
sl@0: inline TInt CGlobalData::DecRefCnt()
sl@0: 	{
sl@0: 	return --iRefCount;
sl@0: 	}
sl@0: 		
sl@0: /**
sl@0: It is used in REComSession::FinalClose().
sl@0: @return Reference count value.
sl@0: */	
sl@0: inline TInt CGlobalData::RefCnt() const
sl@0: 	{
sl@0: 	return iRefCount;
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: @return A reference to the controlled REComSession object.
sl@0: */
sl@0: inline REComSession& CGlobalData::EComSession()
sl@0: 	{
sl@0: 	return iEComSession;
sl@0: 	}
sl@0: 	
sl@0: /**
sl@0: @return A reference to the controlled CLoadManager object.
sl@0: */
sl@0: inline CLoadManager& CGlobalData::LoadManager()
sl@0: 	{
sl@0: 	return *iLoadManager;
sl@0: 	}
sl@0: 
sl@0: #endif //__TLSDATA_H__