wlanutilities/wlansniffer/engine/server/inc/wsfwlansettingsaccessor.h
branchRCL_3
changeset 25 f28ada11abbf
parent 0 56b72877c1cb
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/wlanutilities/wlansniffer/engine/server/inc/wsfwlansettingsaccessor.h	Wed Sep 01 12:20:32 2010 +0100
@@ -0,0 +1,209 @@
+/*
+* Copyright (c) 2007-2008 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 header for CWsfWlanScanner
+*
+*/
+
+
+#ifndef C_WSFWLANSETTINGSACCESSOR_H
+#define C_WSFWLANSETTINGSACCESSOR_H
+
+//  EXTERNAL INCLUDES
+#include <e32base.h>
+#include <commsdattypesv1_1.h>
+
+//  INTERNAL INCLUDES
+#include "wlanmgmtcommon.h"
+#include "wlanscaninfo.h"
+
+
+//  FORWARD DECLARATIONS
+class CCDWlanDeviceSettingsRecord;
+class MWsfWlanScanIntervalChangeObserver;
+
+
+//  CLASS DEFINITION
+/**
+ * Class to monitor WLAN background scan interval and Show WLAN availability 
+ * flag value
+ *
+ * @since S60 5.0
+ * @lib wsfserver.exe
+ */
+NONSHARABLE_CLASS( CWsfWlanSettingsAccessor ): public CActive
+    {
+    public:     // Constructors and destructor
+        /**
+        * Factory function.
+        * @since S60 5.0
+        * @param aDbSession Reference to the database session to use
+        * @return Class instance
+        */
+        static CWsfWlanSettingsAccessor* NewL( 
+                                          CommsDat::CMDBSession& aDbSession );
+
+        /**
+        * Factory function.
+        * @since S60 5.0
+        * @param aDbSession Reference to the database session to use
+        * @return Class instance
+        */
+        static CWsfWlanSettingsAccessor* NewLC( 
+                                          CommsDat::CMDBSession& aDbSession );
+
+        /**
+        * Destructor.
+        */
+        ~CWsfWlanSettingsAccessor();
+        
+
+    private:    // Constructors
+        /**
+        * Constructor
+        * @since S60 5.0
+        * @param aDbSession Reference to the database session to use
+        * @return Class instance
+        */
+        CWsfWlanSettingsAccessor( CommsDat::CMDBSession& aDbSession );
+
+        /**
+        * Second-phase constructor.
+        * @since S60 5.0
+        */
+        void ConstructL();
+
+
+    public: // new methods
+        /**
+        * Returns the value of the scan interval
+        * @since S60 5.0
+        * @return The value of the scan interval in seconds
+        */ 
+        TUint ScanInterval() const;
+
+        /**
+        * Returns the value of the show WLAN availability flag
+        * @since S60 5.0
+        * @return The value of the flag
+        */ 
+        TBool ShowAvailability() const;
+
+        /**
+        * Requests notification for when the scan interval changes
+        * @since S60 5.0
+        * @param aObserver The observer object to be notified
+        */
+        void RequestNotificationL( 
+                              MWsfWlanScanIntervalChangeObserver& aObserver );
+            
+        /**
+        * Cancels the change notifications
+        * @since S60 5.0
+        */
+        void CancelNotifications();
+
+
+    private:    // New methods
+        /**
+        * Does the actual setting check
+        * @since S60 5.0
+        * @param aBgScanInterval Variable to store the latest background scan 
+        *                        interval value
+        * @param aShowAvailability Variable to store the latest Show WLAN 
+        *                        availability flag value
+        */
+        void DoCheckSettingL( TUint& aBgScanInterval, 
+                              TBool& aShowAvailability);
+
+        /**
+        * Checks if the current bgscaninterval/availability flag is different 
+        * from the previously retrieved value
+        * @since S60 5.0
+        * @return ETrue if the settings has been changed
+        */
+        TBool CheckIfSettingChangedL();
+
+        /**
+        * Reissues the request for database notification
+        * @since S60 5.0
+        */
+        void IssueNotificationRequestL();
+
+
+    private:  // from CActive
+        /**
+        * Implements cancellation of an outstanding request.
+        * @since S60 5.0
+        */
+        void DoCancel();
+
+        /**
+        * Handles an active object's request completion event.
+        * @since S60 5.0
+        */
+        void RunL();
+
+        /**
+        * Handles a leave occurring in RunL().
+        * @since S60 5.0
+        * @param aError Leave code
+        * @return aError
+        */
+        TInt RunError( TInt aError );
+        
+    
+    private:    // Data
+        /**
+        * Handle to the database session (not owned)
+        */
+        CommsDat::CMDBSession* iDbSession;
+        
+        /**
+        * Reference to the observer object (not owned)
+        */
+        MWsfWlanScanIntervalChangeObserver* iChangeObserver;
+        
+        /**
+        * Instance of the WLAN settings record (owned)
+        */
+        CCDWlanDeviceSettingsRecord* iWlanSettingsRecord;
+        
+        /**
+        * The last retrieved bgscaninterval value (in seconds)
+        */
+        TUint iScanInterval;
+        
+        /**
+        * Table ID for the WLAN settings table
+        */
+        CommsDat::TMDBElementId iTableId;
+        
+        /**
+        * Hold-up timer to avoid notification bursts
+        */
+        RTimer iTimer;
+        
+        /**
+        * Indicates whether the processing has been activated but got held up
+        */
+        TBool iBeingHeldUp;
+        
+        /**
+        * Indicates whether show wlan availability flag is on
+        */
+        TBool iShowAvailability;
+    };
+
+#endif // C_WSFWLANSETTINGSACCESSOR_H
+