/*
 * 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:  Implementation of CWsfWLANListActiveWrapper.
 *
 */

#ifndef CWSFWLANLISTACTIVEWRAPPER_H
#define CWSFWLANLISTACTIVEWRAPPER_H

//  EXTERNAL INCLUDES
#include <e32base.h>

//  INTERNAL INCLUDES
#include "wsfaicontroller.h"

//  FORWARD DECLARATIONS
class CWsfModel;
class CWsfWlanInfoArray;

/**
 *  Active object that fetches wlan list data
 *
 *  @lib wsfaiplugin.lib
 *  @since S60 v5.2
 */
class CWsfWLANListActiveWrapper : public CActive
    {
public: // Constructors and destructor

    /**
     * Destructor
     * @since S60 5.2     
     */
    ~CWsfWLANListActiveWrapper();

    /**
     * Two-phased constructor.
     * @since S60 5.2     
     */
    static CWsfWLANListActiveWrapper* NewL( CWsfModel* aModel,
                                            TWsfAiController &aController );

    /**
     * Two-phased constructor.
     * @since S60 5.2     
     */
    static CWsfWLANListActiveWrapper* NewLC( CWsfModel* aModel, 
                                             TWsfAiController &aController );

public:
    /**
     * Function for making the initial request
     * @since S60 5.2
     * @param aStarUp is start called from plugin start up    
     */
    void Start( TBool aStarUp );

    /**
     * Returns the list of found WLANs. 
     * Ownership not passed.
     * @since S60 5.2
     * @return Array of WLANs
     */
    CWsfWlanInfoArray* GetWlanList();
    
    /**
     * Returns the connected WLAN network
     * @since S60 5.2
     * @return TWsfWlanInfo
     */
    TWsfWlanInfo GetConnectedWLANNetwork();

private:
    
    /**
     * constructor
     */
    CWsfWLANListActiveWrapper();

    /**
     * Factory function.
     * @since S60 5.2
     * @param aModel Whether to react to screensaver events 
     * @param aController Whether to react to screensaver events
     */
    void ConstructL( CWsfModel* aModel, TWsfAiController &aController );

private: // From CActive

    /**
     * @see CActive
     */
    void RunL();

    /**
     * @see CActive
     */
    void DoCancel();

    /**
     * @see CActive
     */
    TInt RunError( TInt aError );

private:

    /**
     * States of the active object
     */
    enum TCWsfWLANListActiveWrapperState
        {
        EUninitialized, // Uninitialized
        EInitialized, // Initalized
        EProcessWLANListData, // Create wlan array from results
        EGetConnectedNetwork, // Request connected network
        EError
        // Error condition
        };

private:

    /**
     * State of the active object
     */
    TInt iState; // State of the active object

    /**
     * Needed size to allocate result data
     */
    TPckgBuf<TUint> iPckgNeededSize;

    /**
     * Data size in engine
     */
    TPckgBuf<TUint> iPckgAllocatedSize;
    
    /**
     * Connected network request result
     */
    TPckgBuf<TBool> iPckg;

    /**
     * Reference to Model
     */
    CWsfModel* iModel;

    /**
     * Array to store WLAN scan results. Owned.
     */
    CWsfWlanInfoArray* iArray;

    /**
     * TPtr to wlan data
     */
    TPtr8 iPtr;

    /**
     * Wlan data buffer
     */
    HBufC8* iBuffer;

    /**
     * Pointer to TWsfAiController
     */
    TWsfAiController *iController;

    /**
     * Is this object called from plugin startup
     */
    TBool iStartUp;

    /**
     * Retries to fetch data
     */
    TInt iRetriesLeft;
    
    /**
    * Cache of the connected WLAN data
    */
    TWsfWlanInfo iConnectedWlan;

    };

#endif // CWSFWLANLISTACTIVEWRAPPER_H