/*
* Copyright (c)  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:  ?
*
*/


#ifndef CAOCONNECTIONMANAGER_H
#define CAOCONNECTIONMANAGER_H

// INCLUDE FILES
#include <e32base.h>

#include "maoconnectionmanager.h"
#include "maoconnectionobserver.h"
#include "maoconnectionmonitorobserver.h"
#include "linger.h"

// FORWARD DECLARATIONS
class MAOConnectionManagerObserver;
class MAOSettings;
class CAOConnection;
class CAOConnectionMonitor;

/**
 *  Connection manager class.
 *  Connection manager is responsible for creating new
 *  connections and monitoring existing ones.
 *  Network registration is also fetchable through Connection manager.
 *
 *  Events are notified through MAOConnectionManagerObserver
 *  interface.
 *
 *  @lib PDPContextManager.lib
 *  @since S60 v3.1
 */
NONSHARABLE_CLASS( CAOConnectionManager ):
    public CBase,
    public MAOConnectionManager,
    public MAOConnectionObserver,
    public MAOConnectionMonitorObserver
    {
public:

    /**
     * Two-phased constructor.
     *
     * @since S60 v3.1
     */
    static CAOConnectionManager* NewL(
        MAOConnectionManagerObserver& aObserver,
        MAOSettings& aSettings );

    /**
     * Default destructor
     *
     * @since S60 v3.1
     */
    virtual ~CAOConnectionManager();
    
    /**
     * Fetches network registration status.
     * Asynchronous.
     *
     * @since S60 v3.1
     */
    void FetchNetworkRegistrationStatus();
    
// From base class MAOConnectionManager
// Allow Always-On Server to access these methods

    /**
     * From MAOConnectionManager
     *
     * @since S60 v3.1
     */ 
    void ActivatePDPContextL();
    
    /**
     * From MAOConnectionManager
     *
     * @since S60 v3.1
     * @return ETrue if PDP context is active
     */
    TBool IsPDPContextActive() const;

    /**
     * From MAOConnectionManager
     *
     * @since S60 v3.1
     */
    void CloseConnection();
    
     /**
     * From MAOConnectionManager
     *
     * @since S60 v3.2
     */
    void DetachConnection();
       
    /**
     * From MAOConnectionManager
     *
     * @since S60 v3.1
     */
    TNetworkType NetworkType() const;

    /**
     * From MAOConnectionManager
     *
     * @since S60 v3.1
     */
    TInt NumberOfConnections();
    
     /**
     * From MAOConnectionManager
     *
     * @since S60 v3.2
     */
    void HandleSettingsChangedL();
        
private:

    /**
     * Default constructor.
     *
     * @since S60 v3.1
     * @param aObserver ?
     */
    CAOConnectionManager(
        MAOConnectionManagerObserver& aObserver,
        MAOSettings& aSettings );

    /**
     * Default Symbian constructor
     *
     * @since S60 v3.1
     * @param aSettings
     */
    void ConstructL( MAOSettings& aSettings );
    
    /**
     * Checks if network status and settings support always-on
     *
     * @since S60 v3.2
     * @return ETrue if always-on is enabled, EFalse otherwise.
     */
    TBool IsAlwaysOnEnabled();
    
// From base class MAOConnectionObserver

    /**
     * From MAOConnectionObserver
     *
     * @since S60 v3.1
     */
    void HandlePDPContextActivatedL();

    /**
     * From MAOConnectionObserver
     *
     * @since S60 v3.1
     */
    void HandlePDPContextActivationFailedL(
        MAOConnectionManager::TFailureReason aReason );
        
    /**
     * From MAOConnectionObserver
     *
     * @since S60 v3.1
     */
    void HandlePDPContextDisconnectedL(
        MAOConnectionManager::TFailureReason aReason );
    
    /**
     * From MAOConnectionObserver
     *
     * @since S60 v3.1
     */
    void HandlePDPContextTemporarilyBlockedL();
    
// From base class MAOConnectionMonitorObserver

    /**
     * From MAOConnectionMonitorObserver
     *
     * @since S60 v3.1
     * @param aNetworkRegistration ?
     */
    void HandleNWRegistrationStatusChangedL(
        CTelephony::TRegistrationStatus aNetworkRegistration );
                
    /**
     * From MAOConnectionMonitorObserver
     *
     * @since S60 v3.1
     * @param aConnectionId connection id from connection monitor
     * @param aForward Tells whether message should be forwarded next layer
     */
    void HandleConnectionDeletedL( const TUint aConnectionId,
                                   const TBool aForward );
    
    /**
     * Notifies that external connection has been created.
     *
     * @since 3.0
     */
    void HandleExternalConnectionCreatedL();
    
    /**
     * Notifies that internal not-always-on connection has been created.
     *
     * @since S60 v3.2
     * @param aConnectionId connection id from connection monitor
     * @param aIapId iap id
     * @param anetId network id
     * @return void
     */
    void HandleInternalConnectionCreatedL( const TUint aConnectionId,
                                           const TUint aIapId, 
                                           const TUint aNetId );  
    
    /**
     * From MAOConnectionMonitorObserver
     *
     * @since S60 v3.1
     */
    void HandleError( TInt aError );
  
private: // Data

    /**
     * Ref: Connection manager observer
     */
    MAOConnectionManagerObserver& iObserver;
    
    /**
     * Ref: Settings
     */
    MAOSettings& iSettings;
    
    /**
     * Own: Socket server session
     */
    RSocketServ iSocketServ;
    
    /**
     * Own: Connection handler
     */
    CAOConnection* iConnection;
    
    /**
     * Own: Connection monitor
     */
    CAOConnectionMonitor* iConnectionMonitor;
    
    /**
     * Array of pointers to linger objects
     */
    RArray< CLingerConnection* > iLingerArray;
    };

#endif /* CAOCONNECTIONMANAGER_H */