/*
* Copyright (c) 2004,2006 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:  RAU manager
*
*/


#ifndef CAOCONNECTIONIMPL_H
#define CAOCONNECTIONIMPL_H

// INCLUDE FILES
#include <e32base.h>
#include <commdbconnpref.h>
#include <es_sock.h>
#include <commdb.h>
#include <extendedconnpref.h>
#include "maoconnectionmanager.h"

// FORWARD DECLARATIONS
class MAOSettings;
class CCommsDatabase;
class MAOConnectionObserver;

/**
 *  Connection implementation.
 *  @see CAOConnection
 *
 *  @lib PDPContextManager.lib
 *  @since S60 v3.1
 */
NONSHARABLE_CLASS( CAOConnectionImpl ): public CActive
    {
private: // Data types

    /**
     * Internal state bit
     */
    enum TInternalState
        {
        EDisconnected,
        EOpeningLink,
        EListeningAccessPoint
        };
        
public: // Constructors & destructors

    /**
     * Two-phased constructor.
     *
     * @since S60 v3.1
     * @param aObserver ?
     * @param aSettings ?
     * @param aSocketServ ?
     * @return ?
     */
    static CAOConnectionImpl* NewL( MAOConnectionObserver& aObserver,
                                    MAOSettings&           aSettings,
                                    RSocketServ*           aSocketServ );

    /**
     * Default destructor
     *
     * @since S60 v3.1
     */
    virtual ~CAOConnectionImpl();

    /**
     * Starts a new connection if none exists.
     *
     * @since S60 v3.1
     */ 
    void ActivateConnection();
    
    /**
     * Cancels any outstanding connections.
     *
     * @since S60 v3.1
     */
    void CancelConnection();
    
    /**
     * Checks if there is already a connection ongoing.
     *
     * @since S60 v3.1
     * @return ETrue if there is connection
     */ 
    TBool IsConnectedToDefaultIAP();
        
    /**
     * Returns number of ongoing connections.
     *
     * @since 3.0
     * @return TInt
     */ 
    TInt NumberOfConnections();
    
    /**
     * Closes connection (detaches) without stopping it.
     *
     * @since 3.2
     * @return void
     */ 
    void CloseConnection();
        
private: // New methods

    /**
    * Default constructor.
    * @param aObserver ?
    * @param aSettings ?
    * @param aSocketServ ?
    */
    CAOConnectionImpl( MAOConnectionObserver& aObserver,
                       MAOSettings&           aSettings,
                       RSocketServ*           aSocketServ );

    /**
    * Default Symbian constructor
    */
    void ConstructL();

    /**
     * Checks if current IAP is valid
     *
     * @since S60 v3.1
     * @param aId ?
     * @return ?
     */
    TBool IsValidIAP( TUint32 aId ) const;
    
    /**
     * Complete self
     *
     * @since S60 v3.1
     * @param aStatus ?
     * @param aReason ?
     */     
    void CompleteSelf( TRequestStatus& aStatus, TInt aReason );
    
    /**
     * Handle method for EOpeningLink state
     *
     * @since S60 v3.1
     * @param aStatus ?
     */
    void HandleOpeningLinkL( TInt aStatus );

    /**
     * Handle method for EListeningAccessPoint state
     *
     * @since S60 v3.1
     * @param aStatus ?
     */
    void HandleListeningAccessPointL( TInt aStatus );
    
    /**
     * Change state
     *
     * @since S60 v3.1
     * @param aNewState ?
     */
    void ChangeState( TInternalState aNewState );
    
    /**
     * Issue progress notification
     *
     * @since S60 v3.1
     */
    void IssueProgressNotification();
    
    /**
     * Sends 'disconnected' error
     *
     * @since S60 v3.1
     * @param aError ?
     */
    void BrodcastDisconnectedError( TInt aError );
    
    /**
     * Sends 'activation failed' error
     *
     * @since S60 v3.1
     * @param aError ?
     */
    void BrodcastActivationFailedError( TInt aError );
    
    /**
     * Converts error code to failure reason
     *
     * @since S60 v3.1
     * @param aError ?
     * @return ?
     */
    MAOConnectionManager::TFailureReason FailureReason( TInt aError );
    
    /**
     * Activates self
     *
     * @since S60 v3.1
     * @param aCode ?
     */
    void ActivateSelf( TInt aCode );
    
    /**
     * Stops connection
     *
     * @since S60 v3.1
     */
    void StopConnection();

// From base classes CActive

    /**
     * From CActive
     * ?
     *
     * @since S60 v3.1
     */
    void RunL();
    
    /**
     * From CActive
     * ?
     *
     * @since S60 v3.1
     */
    void DoCancel();
    
    /**
     * From CActive
     * ?
     *
     * @since S60 v3.1
     * @param aError ?
     * @return ?
     */     
    TInt RunError( TInt aError );

private: // Data

    /**
     * Ref: Connection observer
     */
    MAOConnectionObserver& iObserver;

    /**
     * Ref: Settings
     */
    MAOSettings& iSettings;
    
    /**
     * Not Own: Socket server session
     */
    RSocketServ* iSocketServ;
    
    /**
     * Own: Connection
     */
    RConnection iConnection;
    
    /**
     * Own: Progress notification buffer
     */
    TNifProgressBuf iProgressBuf;
    
    /**
     * Own: Internal state flag
     */
    TInternalState iState;
    
    /**
     * Own: Comms database
     */
    CCommsDatabase* iCommsDatabase;
    
    TConnPrefList*        iPrefsList;
    TExtendedConnPref*    iExtPrefs;
    };
#endif /* CAOCONNECTIONIMPL_H */