/*******************************************************************************

 * Copyright (c) 2007, 2010 Nokia Corporation and/or its subsidiary(-ies).

 * All rights reserved. This program and the accompanying materials

 * are made available under the terms of the Eclipse Public License v1.0

 * which accompanies this distribution, and is available at

 * http://www.eclipse.org/legal/epl-v10.html

 *

 * Contributors:

 *     Nokia Corporation - S60 implementation

 *******************************************************************************/

#ifndef SWTBROWSERCONNECTIONOBSERVER_H

#define SWTBROWSERCONNECTIONOBSERVER_H

#include <es_sock.h>

/**

 * Cconnection stage observer

 */

class MConnectionStageObserver

{

public:

    virtual void ConnectionStageAchievedL() = 0;

};

/**

 * CSwtBrowserConnectionObserver

 * This is the notifier class which listens to connection stage changes.

 * @lib eswt

 */

NONSHARABLE_CLASS(CSwtBrowserConnectionObserver)

        : public CActive

{

public:

    /**

     * Constructor

     */

    CSwtBrowserConnectionObserver();

    /**

     * Destructor

     */

    virtual ~CSwtBrowserConnectionObserver();

    /**

     * Starts the notification service

     * after it has been started you can expect a notification

     * @param aConnName connection name returned by RConnection::Name()

     * @param aStageToObserve the stage you want to notified about

     * @param aObserver the observer you want to register for notification

     * @param aCompleteIfAlreadyAtStage if ETrue then you get a notification even

     * if the connection is in the stage you defined when you start the service

     */

    void StartNotificationL(TName* aConnName,

                            TInt aStageToObserve,

                            MConnectionStageObserver* aObserver,

                            TBool aCompleteIfAlreadyAtStage= ETrue);

protected:

    /**

     * Attach to connection, the name of which is the aConnName.

     * @param aConnName connection name returned by RConnection::Name()

     */

    void DoOpenAgentL(TName* aConnName);

    /**

     * Detach from connection.

     */

    void DoCloseAgent();

private:

// From CActive

    void DoCancel();

    void RunL();

private://Data

    /**

     * The socket server

     */

    RSocketServ iServer;

    /**

     * The connection on the question

     */

    RConnection iConnection;

    /**

     * The object that keeps connection stage info.

     */

    TNifProgressBuf iProgressBuf;

    /**

     * The connection stage observer

     */

    TInt iStageToObserve;

    /**

     * The connection stage observer

     */

    MConnectionStageObserver* iObserver;

};

#endif // SWTBROWSERCONNECTIONOBSERVER_H