/*

* Copyright (c) 2007-2010 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:  CCCHConnMonHandler declaration

*

*/

#ifndef C_CCHCONNMONHANDLER_H

#define C_CCHCONNMONHANDLER_H

// INCLUDES

#include <e32std.h>

#include <e32base.h>

#include <rconnmon.h>

// CONSTANTS

// None

// MACROS

// None

// DATA TYPES

// None

// FUNCTION PROTOTYPES

// None

// FORWARD DECLARATIONS

class CCCHServerBase;

class MCCHConnMonHandlerNotifier;

// CLASS DECLARATION

class TCCHConnectionInfo

    {

public:

    TUint iIapId;

    TUint iConnId;

    };

/**

 *  CCCHConnMonHandler declaration

 *  Handles Connection Monitor for CCH server

 *  @lib cchserver.exe

 *  @since S60 3.2

 */

NONSHARABLE_CLASS( CCCHConnMonHandler ) : public CActive,

                                          private MConnectionMonitorObserver

    {

public: // Constructors and destructor

    /**

     * State's of object

     */

    enum TCCHConnMonHandlerState

        {

          EUninitialized,   /// Uninitialized

          EInitialized,     /// Initalized

          EGetIAPS,

          EGetSNAPs,

          EGetIAP,

          EGetConnectionCount,

          EError            /// Error condition

        };

    /**

     * Two-phased constructor.

     */

    static CCCHConnMonHandler* NewL( CCCHServerBase& aServer );

    /**

     * Two-phased constructor.

     */

    static CCCHConnMonHandler* NewLC( CCCHServerBase& aServer );

    /**

     * Destructor.

     */

    virtual ~CCCHConnMonHandler();

public: // New functions

    /**

     * Scan available networks

     *

     * @since S60 9.2

     * @param aWlanScan ETrue if WLAN network scan needed

     * @param aObserver Completion notified by method

     *        NetworkScanningCompletedL() if set.

     */

    void ScanNetworks( TBool aWlanScan = EFalse,

	    MCCHConnMonHandlerNotifier* aObserver = NULL );

    /**

     * Cancel network scanning

     * @since S60 3.2

     */

    void ScanNetworksCancel();

    /**

     * Is Snap available

     * @since S60 3.2

     * @param aSNAPId

     * @return ETrue if SNAP is available

     */

    TBool IsSNAPAvailable( TUint aSNAPId ) const;

    /**

     * Is IAP available

     * @since S60 3.2

     * @param aIapId

     * @return ETrue if IAP is available

     */

    TBool IsIapAvailable( TUint aIapId ) const;

    /**

     * Sets observer to notify if SNAPs availability is changed

     *

     * @since S60 9.2

     * @param aObserver Notifies by method

     *        SNAPsAvailabilityChanged(). NULL turns off notify.

     */

    void SetSNAPsAvailabilityChangeListener( MCCHConnMonHandlerNotifier* aObserver );

	/**

     * Collects all connected IAP Ids and Connection Ids to array.

     */

    void StartMonitoringConnectionChanges();

	/**

     * Connected IAPs getter.

     * @param aIapIds

     */

    void StopMonitoringConnectionChanges( RArray<TUint>& aIapIds );

protected: // From base classes

    /**

     * From CActive

     * @since Series 60 3.0

     */

    void RunL();

    /**

     * From CActive

     * @since Series 60 3.0

     */

    void DoCancel();

private: // From MConnectionMonitorObserver

    /**

     * @see MConnectionMonitorObserver, called when ConnMon event occured.

     */

    void EventL( const CConnMonEventBase &aConnMonEvent );

private:

    /**

     * C++ default constructor.

     */

    CCCHConnMonHandler( CCCHServerBase& aServer );

    /**

     * By default Symbian 2nd phase constructor is private.

     */

    void ConstructL();

    /**

     * Get IAPs from Connection Monitor and performs network scan

     * @since S60 3.2

     * @param aBearerId Bearer specific connection id.

     */

    void GetIaps( TConnMonBearerId aBearerId );

    /**

     * Updates available IAP Array

     * @since S60 3.2

     * @param aIaps available IAPs

     */

    void UpdateIapArray( TConnMonIapInfo aIaps );

    /**

     * Get SNAPs from Connection Monitor

     * @since S60 3.2

     */

    void GetSNAPs();

    /**

     * Updates available SNAP array

     * @since S60 3.2

     * @param aSNAPs available SNAPs

     */

    void UpdateSnapArray( TConnMonSNAPInfo aSNAPs );

    /**

     * Request SNAP/IAP availability notifications from Connection Monitor.

     * @since S60 3.2

     */

    void NotifyL() ;

    /**

     * Stops notifications.

     * @since S60 3.2

     */

    void StopNotify();

    /**

     * Call back function to the CPeriodic.

     * 

     * @since S60 9.2

     * @param aAny A pointer to this class.

     * @return Error code

     */

    static TInt PeriodicTimerCallBack(TAny* aAny);

	/**

     * Connection count solver.

     */

    void GetConnectionCount();

	/**

     * IAP Id solver.

     */

    void GetIapId();

	/**

     * Remove connected IAP id from connected IAPs array.

	 * @param aConnId disconnected connection id.

     */

    void RemoveIapId( TUint aConnId );

private: // data

    /**

     * State of active object

     */

    TCCHConnMonHandlerState         iState;

    /**

     * Handle to server

     */

    CCCHServerBase&                 iServer;

    /**

     * Connection Monitor

     */

    RConnectionMonitor              iConnMon;

    /**

     * Package buffer for getting available IAPs

     */

    TConnMonIapInfoBuf              iIapsBuf;

    /**

     * Package buffer for getting available SNAPs

     */

    TConnMonSNAPInfoBuf             iSNAPbuf;

    /**

     * SNAP array

     */

    RArray<TUint>                   iAvailableSNAPs;

    /**

     * IAP Array

     */

    RArray<TUint>                   iAvailableIAPs;

    /**

     * Connection change listener timer.

     * owns.

     */

    CPeriodic* iConnChangeListenerTimer;

    /**

     * Network scanning observer

     */

    MCCHConnMonHandlerNotifier* iNetworkScanningObserver;

    /**

     * SNAPs availability change observer

     */

    MCCHConnMonHandlerNotifier* iSNAPsAvailabilityObserver;

	/**

     * pending async request

     */

    RArray<TCCHConnMonHandlerState> iPendingRequests;

	/**

     * Unsolved connection ids

     */

    RArray<TUint>                   iUnsolvedConnIds;

	/**

     * Connected IAP Ids

     */

    RArray<TCCHConnectionInfo>      iConnIapIds;

	/**

     * Async helpers

     */

    TUint                           iConnIapId;

    TUint                           iConnId;

    TUint                           iConnCount;

    };

#endif // C_CCHCONNMONHANDLER_H

// End of file