PECengine/AttributeLibrary2/Src/CPEngAttrLibObjectHolder.h
changeset 0 094583676ce7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/PECengine/AttributeLibrary2/Src/CPEngAttrLibObjectHolder.h	Thu Dec 17 08:41:52 2009 +0200
@@ -0,0 +1,174 @@
+/*
+* Copyright (c) 2004 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:  Attribute library object holder.
+*
+*/
+
+#ifndef CPENGATTRLIBOBJECTHOLDER_H
+#define CPENGATTRLIBOBJECTHOLDER_H
+
+//  INCLUDES
+#include <E32Base.h>
+
+
+
+// FORWARD DECLARATIONS
+class MPEngPresenceAttrManager;
+class MPEngPresenceAttrTransactionEnv;
+class MPEngTransactionFactory;
+class CPEngSessionSlotId;
+class CPEngSessionSlotObjectCon;
+
+
+// CLASS DECLARATION
+
+/**
+ * Attribute library reference counted singleton holder.
+ *
+ * @lib PEngAttrLib
+ * @since 3.0
+ */
+NONSHARABLE_CLASS( CPEngAttrLibObjectHolder ) : public CObject
+    {
+public:  // Constructors and destructor
+
+    /**
+     * Singleton instance retrieve method.
+     *
+     * Gets pointer to attribute library
+     * singleton object holder. Object holder
+     * is reference counted, so returned instance
+     * is pushed on the CleanupStack and freed
+     * automaticly in case of leave or
+     * CleanupStack::PopAndDestroy().
+     *
+     * @since 3.0
+     */
+    static CPEngAttrLibObjectHolder* InstanceLC();
+
+
+    /**
+     * Helper to verify that everything is
+     * cleaned properly when executing
+     * thread is closing.
+     *
+     * @since 3.0
+     */
+    static void HandleThreadDetach();
+
+
+private:
+
+    /**
+     * Two-phased constructor.
+     * Leaves created object on the CleanupStack.
+     */
+    static CPEngAttrLibObjectHolder* NewLC();
+
+
+    /**
+     * C++ default constructor.
+     */
+    CPEngAttrLibObjectHolder();
+
+
+    /**
+     * Private destructor.
+     *
+     * Singleton holder is reference counted.
+     * It is automaticly destroyed when last
+     * holded object or reference is destroyed.
+     */
+    ~CPEngAttrLibObjectHolder();
+
+
+
+    /**
+     * Symbian 2nd phase constructor
+     */
+    void ConstructL();
+
+
+
+public: // Singleton access
+
+
+    /**
+     * Returns attribute manager instance for requested
+     * NWSessionSlot.
+     *
+     * Method increases returned object reference
+     * count by one before returning it ==> client must
+     * call Close() to object when no more needed.
+     *
+     * @since 3.0
+     * @return Attribute manager instance.
+     */
+    MPEngPresenceAttrManager* AttributeManagerInstanceL(
+        const CPEngSessionSlotId& aSlotId );
+
+
+    /**
+     *
+     * @since 3.0
+     * @return Attribute transaction environment instance.
+     */
+    MPEngPresenceAttrTransactionEnv* AttributeTransEnvInstanceL(
+        const CPEngSessionSlotId& aSlotId );
+
+
+    /**
+     *
+     * @since 3.0
+     * @return Attribute transaction factory instance.
+     */
+    MPEngTransactionFactory* AttributeTransFactInstanceL(
+        const CPEngSessionSlotId& aSlotId );
+
+
+
+
+public: // Debug helpers
+
+#ifdef _DEBUG
+    static CPEngAttrLibObjectHolder* __DbgInstanceOrNull();
+    void __DbgObjectCounts( TInt& aHolder,
+                            TInt& aAttrMan,
+                            TInt& aTransEnv,
+                            TInt& aTransFact ) const;
+    void __DbgAttrManRefCount( const CPEngSessionSlotId& aSlotId, TInt& aRefCount ) const;
+    void __DbgTransEnvRefCount( const CPEngSessionSlotId& aSlotId, TInt& aRefCount ) const;
+    void __DbgTransFactRefCount( const CPEngSessionSlotId& aSlotId, TInt& aRefCount ) const;
+#endif // _DEBUG
+
+
+
+private:    // Data
+
+    //OWN: Session Slot attribute managers
+    CPEngSessionSlotObjectCon*      iAttributeManagers;
+
+
+    //OWN: Session Slot attribute transaction environments
+    CPEngSessionSlotObjectCon*      iAttributeTransEnvs;
+
+
+    //OWN: Session Slot attribute transaction factories
+    CPEngSessionSlotObjectCon*      iAttributeTransFacts;
+
+    };
+
+#endif      // CPENGATTRLIBOBJECTHOLDER_H
+
+// End of File