/*

* 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:  Class CAOConnection declaratation.

*

*/

#ifndef CAOCONNECTION_H

#define CAOCONNECTION_H

// INCLUDE FILES

#include <e32base.h>

#include <es_sock.h>

// FORWARD DECLARATIONS

class CAOConnectionImpl;

class MAOConnectionObserver;

class MAOSettings;

/**

 *  CAOConnection is responsible for creating a new connection

 *  if requested. Also it is possible to attach to an existing

 *  connection via connection ID.

 *  Events like succesfull connection, disconnection, connection failures

 *  are notified through MAOConnectionObserver interface.

 *  

 *  @lib PDPContextManager.lib

 *  @since S60 v3.1

 */

NONSHARABLE_CLASS( CAOConnection ): public CBase

    {

public: // Constructors & destructors

    /**

     * Two-phased constructor.

     *

     * @since S60 v3.1

     * @param aObserver ?

     * @param aSettings ?

     * @param aSocketServ ?

     * @return ?

     */

    static CAOConnection* NewL( MAOConnectionObserver& aObserver,

                                MAOSettings&           aSettings,

                                RSocketServ*           aSocketServ );

    /**

     * Default destructor

     *

     * @since S60 v3.1

     */

    virtual ~CAOConnection();

    /**

     * Starts a new connection if none exists.

     *

     * @since S60 v3.1

     */

    void ActivateConnection();

    /**

     * Cancels any outstanding connections.

     *

     * @since S60 v3.1

     */

    void CancelConnection();

     /**

     * Closes connection without stopping it.

     *

     * @since S60 v3.2

     */

    void CloseConnection();

    /**

     * 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: // New methods

    /**

     * Default constructor.

     *

     * @since S60 v3.1

     */

    CAOConnection();

    /**

     * Default Symbian constructor

     *

     * @since S60 v3.1

     * @param aObserver ?

     * @param aSettings ?

     * @param aSocketServ ?

     */

    void ConstructL( MAOConnectionObserver& aObserver,

                     MAOSettings&           aSettings,

                     RSocketServ*           aSocketServ );

private: // Data

    /**

     * Own: Connection implementation

     */

    CAOConnectionImpl* iConnectionImpl;

    };

#endif /* CAOCONNECTION_H */