/*

* 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 CAOCONNECTIONIMPLSTUB_H

#define CAOCONNECTIONIMPLSTUB_H

// INCLUDE FILES

#include <e32base.h>

#include <e32property.h>

#include "maoconnectionmanager.h"

// FORWARD DECLARATIONS

class MAOSettings;

class MAOConnectionObserver;

class CPeriodic;

template<class T> class CAOAsyncWrapper;

/**

 *  Connection implementation.

 *  This is the stub version of CAOConnectionImpl.

 *

 *  @lib PDPContextManager.lib

 *  @since S60 v3.1

 */

class CAOConnectionImpl : public CActive

    {

private: // Data types

    /**

     * Internal state bit

     */

    enum TInternalState

        {

        EDisconnected,

        EOpeningLink,

        EListeningAccessPoint,

        EAttachingExistingConnection

        };

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();

    /**

     * ?

     *

     * @since S60 v3.1

     * @param aConnectionId ?

     */

    void AttachToExistingConnection( TUint aConnectionId );

    /**

     * 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();

private:

    /**

     * Default constructor.

     *

     * @since S60 v3.1

     * @param aObserver

     * @param aSettings

     * @param aSocketServ

     */

    CAOConnectionImpl( 

        MAOConnectionObserver& aObserver,

        MAOSettings&           aSettings,

        RSocketServ*           aSocketServ );

    /**

     * Default Symbian constructor

     *

     * @since S60 v3.1

     */

    void ConstructL();

    /**

     * Change state

     *

     * @since S60 v3.1

     * @param aNewState ?

     */

    void ChangeState( TInternalState aNewState );

    /**

     * Completes self

     *

     * @since S60 v3.1

     * @param aStatus ?

     * @param aReason ?

     */

    void CompleteSelf( TRequestStatus& aStatus, TInt aReason );

    /**

     * Callback for connection timer

     *

     * @since S60 v3.1

     * @param aSelf ?

     */

    static TInt ConnectionCallBack( TAny* aSelf );

    /**

     * Handles callback timer trigger

     *

     * @since S60 v3.1

     */

    void HandleConnectionCallBackL();

    /**

     * Activates connection

     *

     * @since S60 v3.1

     */

    void DoActivateConnection();

    /**

     * Handles EOpeningLink request completion

     *

     * @since S60 v3.1

     * @param aStatus ?

     */

    void HandleOpeningLinkL( TInt aStatus );

    /**

     * Converts error code to failure reason

     *

     * @since S60 v3.1

     * @param aError ?

     * @return ?

     */

    MAOConnectionManager::TFailureReason FailureReason( TInt aError );

    /**

     * Handles EListeningAccessPoint request completion

     *

     * @since S60 v3.1

     * @param aStatus ?

     */

    void HandleListeningAccessPointL( TInt aStatus );

    /**

     * Reports PDP context activation error

     *

     * @since S60 v3.1

     * @param aError ?

     */ 

    void BroadcastPDPContextActivationFailureL( TInt aError );

    /**

     * Reports PDP context disconnection

     *

     * @since S60 v3.1

     * @param aError ?

     */

    void BroadcastPDPContextDisconnectionL( TInt aError );

    /**

     * Handles EAttachingExistingConnection request completion

     *

     * @since S60 v3.1

     * @param aStatus ?

     */

    void HandleAttachingExistingConnectionL( TInt aStatus );

    /**

     * PDP context activation property

     *

     * @since S60 v3.1

     */

    void SubscribePDPContextActivation();

    /**

     * ?

     *

     * @since S60 v3.1

     * @param aStatus ?

     */

    void PDPContextActivationIssueRequest( TRequestStatus& aStatus );

    /**

     * ?

     *

     * @since S60 v3.1

     * @param aStatus ?

     */

    void PDPContextActivationRunL( TInt aStatus );

    /**

     * ?

     *

     * @since S60 v3.1

     */

    void PDPContextActivationDoCancel();

    /**

     * PDP context disconnection property

     *

     * @since S60 v3.1

     */

    void SubscribePDPContextDisconnection();

    /**

     * ?

     *

     * @since S60 v3.1

     * @param aStatus ?

     */

    void PDPContextDisconnectionIssueRequest( TRequestStatus& aStatus );

    /**

     * ?

     *

     * @since S60 v3.1

     * @param aStatus ?

     */

    void PDPContextDisconnectionRunL( TInt aStatus );

    /**

     * ?

     *

     * @since S60 v3.1

     */

    void PDPContextDisconnectionDoCancel();

    /**

     * Broadcast PDP context activated

     *

     * @since S60 v3.1

     */

    void BroadcastPDPContextActivatedL();

// 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: Internal state flag

     */

    TInternalState iState;

    /**

     * Own: Connection timer

     */

    CPeriodic* iConnectionTimer;

    /**

     * Own: PDP context activation property

     */

    RProperty iPDPContextActivationProperty;

    /**

     * Own: ?

     */

    CAOAsyncWrapper<CAOConnectionImpl>* iPDPContextActivationSubscriber;

    /**

     * Own: PDP context disconnection property

     */

    RProperty iPDPContextDisconnectionProperty;

    /**

     * Own: ?

     */

    CAOAsyncWrapper<CAOConnectionImpl>* iPDPContextDisconnectionSubscriber;

    /**

     * Own: PDP context activation error

     */

    TInt iActivationError;

    /**

     * Own: PDP context activation error

     */

    TInt iDisconnectionError;

    };

#endif /* CAOCONNECTIONIMPLSTUB_H */