/*

* 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