/*
* Copyright (c) 2002-2004 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:  Connection manager
 *
*/


#ifndef CRSFWCONNECTIONMANAGER_H
#define CRSFWCONNECTIONMANAGER_H

// INCLUDES
#include <commdb.h>
#include <rconnmon.h>
#include <es_sock.h>

// FORWARD DECLARATIONS

// DATA TYPES
// Connection event types for MRsfwConnectionObserver
enum TRsfwConnectionObserverEventConnection
    {
    ERsfwConnectionObserverEventConnectionDisconnected = 0,
    ERsfwConnectionObserverEventConnectionWeaklyConnected,
    ERsfwConnectionObserverEventConnectionStronglyConnected
    };

enum TRsfwConnectionManagerConnectionQuality
    {
    ERsfwConnectionQualityNull = 0,
    ERsfwConnectionQualityStrong
    };

// IAP selection algorithms
enum TRsfwConnectionManagerIapSelection
    {
    ERsfwIapSelectionAskUser = 0,            // show the IAP selection menu
    ERsfwIapSelectionUseDefaultPreferences,  // use CommDB preferences
    ERsfwIapSelectionExplicit                // use explicit list
    };

// CLASS DECLARATION
class TIapInfo
    {
public:
    TBuf<KCommsDbSvrMaxColumnNameLength> iName;
    TUint32                              iId;
    TBuf<KCommsDbSvrMaxColumnNameLength> iNetworkName;
    TBuf<KCommsDbSvrMaxColumnNameLength> iServiceName;
    TBuf<KCommsDbSvrMaxColumnNameLength> iSsId;
    TBuf<KCommsDbSvrMaxColumnNameLength> iBearerType;
    TInt                                 iBearerQuality;  // weak/strong
    };

// CLASS DECLARATION
class MRsfwConnectionObserver
    {
public:
    virtual void HandleConnectionEventL(TInt aConnectionEventType,
                                        TAny* aArg) = 0;
    };

// CLASS DECLARATION
// This class manages the link layer for the Rsfw remote access modules.
//
// The primary input is a list of access point names that are assumed
// to be in preference order. However,
// 1) if the list only contains a "*" string,
//    static commdb preference order will be used, or else
// 2) if the list is empty,
//    the user will be prompted for an access point
//
class CRsfwConnectionManager: public CActive
    {
public:
    // Ownership of aIapNames moves to RsfwConnectionManager
    IMPORT_C static CRsfwConnectionManager* NewL(
        MRsfwConnectionObserver* aConnectionObserver);
    IMPORT_C virtual ~CRsfwConnectionManager();
    IMPORT_C void UseIapL(const TDesC& aIap);
    IMPORT_C TInt GetConnection(RSocketServ*& aSocketServ, RConnection*& aConnection);

private:
    CRsfwConnectionManager();
    void ConstructL(MRsfwConnectionObserver* aConnectionObserver);
    TInt LoadIapInfoL(TIapInfo& aIapInfo);
    TInt StartConnection(TUint32 aIapId, TCommDbDialogPref aDialogPreference);
    void HandleDisconnectionEventL();
    
    // functions related to timer for GPRS 'suspend' event
    static TInt SuspensionTimerExpiredL(TAny* aArg);
    void StartSuspensionTimer();
    void StopSuspensionTimer();
    
    
    // from CActive
	void RunL();
	TInt RunError(TInt aError);
	void DoCancel();

private: // Data
    RSocketServ               iSocketServ;
    RConnection               iConnection;
    MRsfwConnectionObserver*  iConnectionObserver;
    TInt                      iIapSelection;        // IAP selection policy
    RArray<TIapInfo>          iIaps;                // allowed IAPs, if any
    TPckgBuf<TNifProgress>    iProgress; 
    CPeriodic*                iSuspensionTimer;     // for GPRS 'suspend' events
    };

#endif // CRSFWCONNECTIONMANAGER_H

// End of File