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: sl@0: #ifndef __LOADMANAGER_H__ sl@0: #define __LOADMANAGER_H__ sl@0: sl@0: #include sl@0: #include sl@0: //Forward declarations sl@0: class CUnloadPolicy; sl@0: sl@0: /** sl@0: @internalComponent sl@0: Represents an instance of an implementation sl@0: */ sl@0: NONSHARABLE_CLASS(CInstanceInfo): public CBase sl@0: { sl@0: public: sl@0: virtual ~CInstanceInfo(); sl@0: CUnloadPolicy* UnloadPolicy() {return iUnloadPolicy;}; sl@0: public: sl@0: virtual TUid ImplementationUid() = 0; sl@0: virtual TProxyExtendedInterfaceGetPtrL ProxyExtendedIntGetPtr() = 0; sl@0: virtual TProxyExtendedInterfaceReleasePtr ProxyExtendedIntReleasePtr() = 0; sl@0: virtual TAny* CreateExtObjectL(const TUid& aExtendedInterfaceUID) = 0; sl@0: virtual void DestroyExtObject(const TUid& aExtendedInterfaceUID) = 0; sl@0: virtual TAny* ImplementationObject() = 0; sl@0: protected: sl@0: CInstanceInfo(CUnloadPolicy* aUnloadPolicy); sl@0: private: sl@0: // The Unload Policy for the dll which contains this implementation sl@0: CUnloadPolicy* iUnloadPolicy; sl@0: }; sl@0: sl@0: /** sl@0: @internalComponent sl@0: Represents an instance of a PLUGIN3 type implementation sl@0: */ sl@0: NONSHARABLE_CLASS(CInstanceInfoExtended): public CInstanceInfo sl@0: { sl@0: public: sl@0: static CInstanceInfoExtended* NewL(CUnloadPolicy* aUnloadPolicy,const TImplementationProxy3* aRow); sl@0: void SetObject(TAny* aImplementationObject); sl@0: ~CInstanceInfoExtended(); // Release all extended objects (if not already released) sl@0: public: sl@0: TUid ImplementationUid() {return iImplementationProxyRow->iImplementationUid;}; sl@0: TProxyExtendedInterfaceGetPtrL ProxyExtendedIntGetPtr() {return iImplementationProxyRow->iFuncPtrInterfaceGetL;}; sl@0: TProxyExtendedInterfaceReleasePtr ProxyExtendedIntReleasePtr() {return iImplementationProxyRow->iFuncPtrInterfaceRelease;}; sl@0: TAny* CreateExtObjectL(const TUid& aExtendedInterfaceUID); sl@0: void DestroyExtObject(const TUid& aExtendedInterfaceUID); sl@0: TAny* ImplementationObject() {return iImplementationObject;}; sl@0: private: sl@0: CInstanceInfoExtended(CUnloadPolicy* aUnloadPolicy,const TImplementationProxy3* aImplementationProxyRow); sl@0: private: sl@0: // Pointer to proxy implementation table row entry that this instance corresponds to. sl@0: // This is where the implementation UID, get and release extended interface function sl@0: // pointers reside. sl@0: const TImplementationProxy3* iImplementationProxyRow; sl@0: // The instantiation interface object for the dll which contains this implementation sl@0: TAny* iImplementationObject; sl@0: // The created extended object information structure. sl@0: struct TExtendedObjectInfo sl@0: { sl@0: // The extended interface UID sl@0: TUid iExtendedInterfaceUID; sl@0: // The extended interface object for the this implementation sl@0: TAny* iExtendedInterfaceObject; sl@0: }; sl@0: sl@0: // List of all of the created extended objects for this implementation sl@0: RArray iExtendedObjectInfo; sl@0: sl@0: // Friend classes sl@0: friend class TLoadManager_StateAccessor; sl@0: }; sl@0: sl@0: /** sl@0: @internalComponent sl@0: Represents an instance of a PLUGIN1 type implementation sl@0: */ sl@0: NONSHARABLE_CLASS(CInstanceInfoSimple): public CInstanceInfo sl@0: { sl@0: public: sl@0: static CInstanceInfoSimple* NewL(CUnloadPolicy* aUnloadPolicy,const TImplementationProxy* aImplementationProxyRow); sl@0: public: sl@0: TUid ImplementationUid() {return iImplementationProxyRow->iImplementationUid;}; sl@0: // The following functions are not required for CInstanceInfoSimple. sl@0: // PLUGIN1 type is not meant to extend interfaces. sl@0: TProxyExtendedInterfaceGetPtrL ProxyExtendedIntGetPtr(){return NULL;}; sl@0: TProxyExtendedInterfaceReleasePtr ProxyExtendedIntReleasePtr(){return NULL;}; sl@0: TAny* CreateExtObjectL(const TUid& /*aExtendedInterfaceUID*/) {return NULL;}; sl@0: void DestroyExtObject(const TUid& /* aExtendedInterfaceUID*/) {}; sl@0: TAny* ImplementationObject() {return NULL;}; sl@0: sl@0: private: sl@0: CInstanceInfoSimple(CUnloadPolicy* aUnloadPolicy,const TImplementationProxy* aImplementationProxyRow); sl@0: sl@0: private: sl@0: // Pointer to proxy implementation table row entry that this instance corresponds to. sl@0: // This is where the implementation UID resides. sl@0: const TImplementationProxy* iImplementationProxyRow; sl@0: sl@0: }; sl@0: sl@0: /** sl@0: @internalComponent sl@0: Manages the loading and unloading of interface implementation groupings. sl@0: */ sl@0: NONSHARABLE_CLASS(CLoadManager) : public CBase sl@0: { sl@0: public: sl@0: static CLoadManager* NewL(); sl@0: ~CLoadManager(); sl@0: TBool DestroyedThis(TUid aInstanceKey); sl@0: sl@0: TBool PolicyArraysEmpty() const ; sl@0: sl@0: TAny* ImplementationObjectL(const TUid& aUniqueImplementationUid, sl@0: const TEntry& aEntry, sl@0: TAny* aCreationParameters, sl@0: TBool aCreationParamsFlag, sl@0: TUid& aInstanceKey); sl@0: sl@0: TAny* GetExtendedInterfaceL(const TUid& aInstanceKey, const TUid& aExtendedInterfaceUid); sl@0: void ManuallyReleaseExtendedInterfaceL(const TUid& aInstanceKey, const TUid& aExtendedInterfaceUid); sl@0: void ClearGarbage(); sl@0: sl@0: TUid GetImplementationUidL(TUid aInstanceKey); sl@0: sl@0: private: sl@0: CLoadManager(); sl@0: sl@0: void GetUnloadPolicy(TUid aUniqueImplementationUid, sl@0: const TEntry& aEntry, sl@0: CUnloadPolicy*& aPolicy); sl@0: sl@0: template TAny* GetNewLPointerAndProxyTableRowL(TUid aUniqueImplementationUid, sl@0: TImpProxy*& aImplementationTableEntry, sl@0: const T aProxy); sl@0: sl@0: TAny* ImplementationObject1L(const TUid& aUniqueImplementationUid, sl@0: TAny* aCreationParameters, sl@0: TBool aCreationParamsFlag, sl@0: TUid& aInstanceKey, sl@0: CUnloadPolicy* aPolicy, sl@0: TLibraryFunction& aLibFunctionProxy); sl@0: sl@0: TAny* ImplementationObject3L(const TUid& aUniqueImplementationUid, sl@0: TAny* aCreationParameters, sl@0: TBool aCreationParamsFlag, sl@0: TUid& aInstanceKey, sl@0: CUnloadPolicy* aPolicy, sl@0: TLibraryFunction& aLibFunctionProxy); sl@0: sl@0: TAny* ImplementationObjectL(TAny* aCreationParameters, sl@0: TBool aCreationParamsFlag, sl@0: const TAny* aNewLpointer); sl@0: sl@0: void CleanupAfterFailure(CUnloadPolicy* aPolicy); sl@0: void Cleanup(CUnloadPolicy* aPolicy); sl@0: private: sl@0: #ifdef ECOM_TRACE sl@0: /** Instantiation counter for debug trace */ sl@0: TInt iDebugInstantiationCounter; sl@0: #endif sl@0: /** List of all the UnloadPolicies for objects which have been created */ sl@0: RPointerArray iAllUnloadPolicies; sl@0: /** Garbage UnloadPolicy which is not in use anymore */ sl@0: CUnloadPolicy* iGarbagePolicy; sl@0: // Array of instance information sl@0: RPointerArray iInstanceInfoList; sl@0: sl@0: // Make the test State Accessor a friend sl@0: friend class TLoadManager_StateAccessor; sl@0: }; sl@0: sl@0: #include "loadmanager.inl" sl@0: sl@0: #endif //__LOADMANAGER_H__