/*

* Copyright (c) 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:  Monitors for WLAN connection

*

*/

#ifndef C_UPNPCONNECTIONMMONITOR_H

#define C_UPNPCONNECTIONMMONITOR_H

// INCLUDES

#include <e32base.h>

#include <rconnmon.h>

#include "upnpconnectionmonitorobserver.h"

/**

* CUPnPConnectionMonitor class provides a WLAN connection monitor

* for UPnP applications.

*

* @lib upnputilities.lib

* @since S60 3.0

*/

class CUPnPConnectionMonitor :  public CActive,

                                public MConnectionMonitorObserver

    {

public:  // Constructors and destructor

    /**

     * Two-phased constructor.

     */

    IMPORT_C static CUPnPConnectionMonitor* NewL( TInt aAccessPoint );

    /**

     * Destructor.

     */

    virtual ~CUPnPConnectionMonitor();

    /**

     * Sets connection observer. Can be used if observer changes 

     * after creation of connection monitor.

     * @param aObserver Observer.

     */

    IMPORT_C void SetObserver( MUPnPConnectionMonitorObserver& aObserver );

    /**

     * Requests a notification when requested access point is available.

     * To avoid high power consumption, access point is observed some

     * minutes. If access point is available earlier, IapAvailable is 

     * called and monitoring stopped. Observation of access point can 

     * be canceled with NotifyIapCancel at any point.

     * @param aAccessPoint Access point from which notification is requested.

     */

    IMPORT_C void NotifyIap( TInt aAccessPoint );

    /**

     * Stops scanning of access point started with NotifyIap.

     */

    IMPORT_C void NotifyIapCancel();

protected: // From CActive

    void DoCancel();

    void RunL();

protected: // From MConnectionMonitorObserver

    /**

     * Catches the Connection monitor events 

     * @since Series 60 3.0

     * @param aConnMonEvent event

     * @return none

     */

    void EventL( const CConnMonEventBase& aConnMonEvent ) ;

private:

    /**

     * C++ default constructor.

     */

    CUPnPConnectionMonitor( TInt aAccessPoint );

    /**

     * By default Symbian 2nd phase constructor is private.

     */

    void ConstructL();

    /**

     * Checks connection type

     */

    TBool IsWlanConnection( TInt aConnectionId);

    /**

     * Checks current connection ids what is wlan id

     * and stores it to iConnectionId

     */

    void  ParseCurrentConnections();

    /**

     * Callback for iap observation stop timer.

     */

    static TInt TimeoutCallback( TAny* aSelf );

    /**

     * Implementation of timeout handling.

     */

    void StopIapObservation();

    /**

     * Cancels and deletes timeout timer.

     */

    void DeleteTimeoutTimer();

private:

    enum EMonitorState

        {

        EMonitorStateWait,

        EMonitorStateIap

        };

private:    // Data

    // Connection monitor server

    RConnectionMonitor              iConnectionMonitor;

    // Connection id on connection creation

    TInt                            iConnectionIdOnCreate;

    // Connection id on connection deletion

    TInt                            iConnectionId;

    // Callback pointer, not owned

    MUPnPConnectionMonitorObserver* iObserver;

    // Accesspoint to be observed

    TInt                            iAccessPoint;

    // Indication of scan request

    TBool                           iMonitorState;

    // Buffer for iap information

    TConnMonIapInfoBuf              iIapBuf;

    // Timer used when scanning iap at intervals

    RTimer                          iTimer;

    // Timer used to avoid scanning of access point

    // forever if client does not stop scanning.

    CPeriodic*                      iTimeout;

    };

#endif // C_UPNPCONNECTIONMMONITOR_H

// End of File