/*******************************************************************************
 * Copyright (c) 2007, 2010 Nokia Corporation and/or its subsidiary(-ies).
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     Nokia Corporation - S60 implementation
 *******************************************************************************/


#ifndef SWTBROWSERACTIVEAPDB_H
#define SWTBROWSERACTIVEAPDB_H


#include <e32base.h>

class CActiveApDb;
class CApListItemList;
class CSwtBrowserApDbObserver;

/**
 * CSwtBrowserActiveApDb
 * @lib eswtapifacade.dll
 */

class CSwtBrowserActiveApDb
        : public CBase
{
public:     // construction

    /**
     * Two-phased constructor. Leaves on failure.
     *
     * @return The constructed model
     */
    IMPORT_C static CSwtBrowserActiveApDb* NewL();

    /**
     * Destructor.
     */
    virtual ~CSwtBrowserActiveApDb();


public:


    /**
     * Get Access Point Engine object.
     *
     * @return Access Point Engine object
     */
    IMPORT_C CActiveApDb& ApDb() const;

    /**
     * Get CommsDb object.
     *
     * @return CommsDb object
     */
    IMPORT_C CCommsDatabase& CommsDb() const;

    // From MActiveApDbObserver

    /**
     * From MActiveApDbObserver
     * Handle database event (refresh cached AP list on change).
     *
     * @param aEvent Database-related event.
     * @return void.
     */
    void HandleApDbEventL(const TInt aEvent);

    /**
     * Get Access Point list.
     *
     * @return Access Point list
     */
    IMPORT_C TUint32 FirstAccessPointUidL();



protected:  // construction

    /**
     * Constructor.
     */
    CSwtBrowserActiveApDb();

    /**
     * Second phase constructor. Leaves on failure.
     */
    void ConstructL();

private:

    /**
     * Get all access points (implementation detail). If database is
     * inaccessible, old data remains and update becomes pending.
     *
     * @return void.
     */
    void GetAccessPointsL();

    /**
     * Get all access points (implementation detail).
     *
     * @param aList Append access points to this list
     * @return void.
     */
    void DoGetAccessPointsL(CApListItemList& aList) const;


private:    // data


    /**
     * ETrue if database has changed, but could not get new data yet.
     */
    TBool iUpdatePending;

    /**
     *Etrue if referesh needs to be done on next access to cached data
     *Added as a result of performance tuning
     */
    TBool iDelayedRefresh;


    /**
     * Access Point database.
     * Own
     */
    CActiveApDb* iDb;

    /**
     * Cached AP list. Since querying the AP Engine is expensive (slow),
     * we maintain a cached list of AP-s for quick access.
     * Own
     */
    CApListItemList* iCachedApList;

    /**
     * Pointer to active ap observer,
     * Own
     */
    CSwtBrowserApDbObserver* iObserver;

};

#endif // SWTBROWSERACTIVEAPDB_H