ncdengine/engine/accesspointmanager/inc/catalogsaccesspointmanagerimpl.h
changeset 0 ba25891c3a9e
child 25 7333d7932ef7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/ncdengine/engine/accesspointmanager/inc/catalogsaccesspointmanagerimpl.h	Thu Dec 17 08:51:10 2009 +0200
@@ -0,0 +1,238 @@
+/*
+* Copyright (c) 2006 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:   Class CCatalogsAccessPointManager declation
+*
+*/
+
+
+#ifndef C_CATALOGSACCESSPOINTMANAGERIMPL_H
+#define C_CATALOGSACCESSPOINTMANAGERIMPL_H
+
+#include <e32def.h>
+#include <ApAccessPointItem.h>
+#include "catalogsaccesspointmanager.h"
+#include "catalogsaccesspointobserver.h"
+
+class CCatalogsAccessPointFilterSettings;
+class CCatalogsAccessPointSettings;
+class CCatalogsAccessPoint;
+class CCatalogsClientAccessPointData;
+class MNcdStorageManager;
+class CNcdNodeManager;
+class CNcdGeneralManager;
+
+class CCatalogsAccessPointManager: public CBase,
+                                   public MCatalogsAccessPointManager,
+                                   public MCatalogsAccessPointObserver
+{
+public:
+    static CCatalogsAccessPointManager* NewL(
+        CNcdGeneralManager& aGeneralManager );
+        
+    ~CCatalogsAccessPointManager();
+    
+
+public: // from MCatalogsAccessPointManager
+
+    /**
+     * @see MCatalogsAccessPointManager::SetFixedApL.
+     */
+    virtual void SetFixedApL( const RPointerArray<CNcdKeyValuePair>& aApDetails ); 
+    
+    /**
+     * @see MCatalogsAccessPointManager::GetFixedApL
+     */
+    virtual void GetFixedApL( TUint32& aAccessPointId );
+
+    /**
+     * @see MCatalogsAccessPointManager::ParseAccessPointDataFromClientConfL.
+     */
+    virtual void ParseAccessPointDataFromClientConfL(
+        const MNcdConfigurationProtocolClientConfiguration& aConfiguration,
+        const TUid& aClientUid, 
+        TBool aIgnoreFixedAp, 
+        RArray<TUint32>* aCreatedAps );
+        
+        
+    /**
+     * @see MCatalogsAccessPointManager::AccessPointIdL.
+     */
+    TInt AccessPointIdL(
+        const TDesC& aNameSpace,
+        const MCatalogsAccessPointManager::TAction& aAction, const TUid& aClientUid,
+        TUint32& aAccessPointId);
+        
+    /**
+     * @see MCatalogsAccessPointManager::AccessPointIdL.
+     */
+    TInt AccessPointIdL(
+        const TDesC& aNameSpace, const TDesC& aCatalogId,
+        const MCatalogsAccessPointManager::TAction& aAction, const TUid& aClientUid,
+        TUint32& aAccessPointId);
+        
+    /**
+     * @see MCatalogsAccessPointManager
+     */
+    TInt AccessPointIdL(
+        const CNcdNodeIdentifier& aNodeIdentifier,
+        const MCatalogsAccessPointManager::TAction& aAction, const TUid& aClientUid,
+        TUint32& aAccessPointId);
+
+    static void RemoveApFromCommsDatabaseL( const TUint32& aId );
+    
+public: // From MCatalogsAccessPointObserver
+
+    void HandleAccessPointEventL( 
+        const TCatalogsConnectionMethod& aAp,
+        const TCatalogsAccessPointEvent& aEvent );
+
+
+private:
+
+    CCatalogsAccessPointManager(
+        CNcdGeneralManager& aGeneralManager );
+    
+    void ConstructL();
+
+    /**
+     * Finds the access point settings for the given node from the
+     * given access point data. NOTE! The node represented by the given
+     * identifier must exist, otherwise the function leaves.
+     *
+     * @param aNodeIdentifier The node identifier.
+     * @param aAction The action type.
+     * @param aAccessPointData The data to search from.
+     * @return The access point or NULL if not found.
+     */    
+    CCatalogsAccessPoint* FindAccessPointL(
+        const CNcdNodeIdentifier& aNodeIdentifier,
+        const MCatalogsAccessPointManager::TAction& aAction,
+        const CCatalogsClientAccessPointData& aAccessPointData );
+
+    
+    /**
+     * Maps the access point for given namespace and action.
+     *
+     * @param aNameSpace Namespace of the content source.
+     * @param aAction The action.
+     * @param aApId The access point id obtained from client configuration.
+     * @param aClientUid Uid of the client.
+     */
+    void MapAccessPointL(
+        const TDesC& aNameSpace, const TAction& aAction,
+        const TDesC& aApId );
+        
+    /**
+     * Maps an access point for the given namespace, ID and action.
+     *
+     * @param aNameSpace Namespace of the catalog.
+     * @param aCatalogId ID of the catalog.
+     * @param aAction The action.
+     * @param aApId The access point ID obtained from client configuration.
+     * @param aClientUid Uid of the client.
+     */
+    void MapAccessPointL(
+        const TDesC& aNameSpace, const TDesC& aCatalogId, const TAction& aAction,
+        const TDesC& aApId );
+        
+    /**
+     * Create accesspoint to commsDB if corresponding accesspoint does not exist.
+     * Add the given access point to access point datas of the given client.
+     * 
+     * @param aSettings The access point settings.
+     * @param aClientUid Uid of the client.
+     */
+    void CreateAccessPointL( CCatalogsAccessPoint* aSettings );
+    
+    /**
+     * Creates the access point to commsDB if corresponding access point does not exist.
+     * Sets the id of the access point in commsDB to aSettings object.
+     *
+     * @param aSettings The access point settings.
+     */
+    void CreateAccessPointL( CCatalogsAccessPoint& aSettings );
+    
+    /**
+     * Removes the client's accesspoint settings from the comms database.
+     * 
+     * @param aClientUid UID of the client.
+     * @param aAddShutdownOperation If true, a shutdown operation is
+     * created if removing the accesspoint fails that will try to remove it
+     * later
+     */
+    void RemoveAccessPointsFromCommsDbL(
+        TBool aAddShutdownOperation );
+    
+    /**
+     * Creates the access points from the client configuration.
+     *
+     * @param aDetail The detail of which id is "accessPoints".
+     * @param aClientUid The Uid of the owner of the access points.
+     */
+    void CreateAccessPointsFromClientConfL(
+        const MNcdConfigurationProtocolDetail& aDetail, 
+        RArray<TUint32>* aCreatedAps );
+    /**
+     * Removes client's access point datas from the internal data structures and
+     * from the comms database.
+     *
+     */
+    void RemoveAccessPointsL();
+        
+    
+    HBufC16* ReadText16L( CApAccessPointItem* aItem, const TApMember& aApMember );
+
+    HBufC8* ReadText8L( CApAccessPointItem* aItem, const TApMember& aApMember );
+    
+    TBool MatchInCommsDbL( const CCatalogsAccessPointSettings& aSettings, TUint32& aId );
+
+    void CreateApToCommsDBL( const CCatalogsAccessPoint& aSettings, TUint32& aId );
+
+    TBool ValidateAccessPointL( CCatalogsAccessPoint* aAccessPoint ); 
+
+    void LoadFromStorageL();
+
+    void SaveToStorageL();
+    
+        
+    TBool MatchingSettingsL(const CCatalogsAccessPointSettings& aSettings, CApAccessPointItem& aItem);
+    
+    void SetApDetailL( CCatalogsAccessPoint& aAp, const TDesC& aKey, const TDesC& aValue );
+
+    TInt GetAccessPoint( 
+        CCatalogsAccessPoint*& aAccessPoint,
+        CCatalogsClientAccessPointData*& aApData );
+
+    TInt ValidateOrCreateAccessPointL(
+        CCatalogsAccessPoint* aAccessPoint,
+        TUint32& aAccessPointId );
+
+    void DestructL();
+
+private:
+    
+    CNcdGeneralManager& iGeneralManager;
+    // Storage manager is used to load and to save data from
+    // databases.
+    MNcdStorageManager& iStorageManager;
+    
+    CNcdNodeManager& iNodeManager;
+
+    CCatalogsClientAccessPointData* iClientAccessPointData;
+    
+    CCatalogsAccessPoint* iFixedAp;
+    TBool iCheckAp;
+};
+
+#endif