/*
* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "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: 
*     This class provides connection/session related information.
*	  Both the requested and the stored AP's are here.
*
*
*/


#ifndef Connection_Observers_H
#define Connection_Observers_H

//System includes
#include <es_sock.h>
#include <es_enum.h>
#include <cdbcols.h>

//You should inherit from this if you want to observe connection stages
class MConnectionStageObserver
	{
	public:

		virtual void ConnectionStageAchievedL() = 0;
	};


//You should inherit from this if you want to observe multiple connection stages
class MConnectionMultiStageObserver
	{
	public:

		virtual void ConnectionStageAchievedL( TInt aStage ) = 0;
	};

//This is the notifier class which listens to connection stage changes
NONSHARABLE_CLASS(  CConnectionStageNotifierWCB ) : public CActive
	{
public:

	/**
	*Symbian OS 2 phased constructor
	*@param aPriority the active objects priority
	*/
	IMPORT_C static CConnectionStageNotifierWCB* NewL( TInt aPriority = EPriorityStandard);
	
	/**
	*Symbian OS 2 phased constructor
	*@param aPriority the active objects priority
	*/
	IMPORT_C static CConnectionStageNotifierWCB* NewLC( TInt aPriority = EPriorityStandard );

public:

	/**
    *
    *DEPRECATED since Averell2.0
    *
	*Starts the notification service
	*after it has been started you can expect a notification
	*@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
	*/
	IMPORT_C void StartNotificationL( TInt aStageToObserve, MConnectionStageObserver* aObserver, TBool aCompleteIfAlreadyAtStage= ETrue  );

public:

	/**
	*Destructor
	*/
	IMPORT_C virtual ~CConnectionStageNotifierWCB();

protected:

	/**
	*Constructor
	*@param aPriority the priority of the active object
	*/
	CConnectionStageNotifierWCB( TInt aPriority );

private://from CActive		

        void DoCancel();		
		void RunL();	

public:

    /**
	*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
	*/
	IMPORT_C void StartNotificationL( TName* aConnName, 
                                      TInt aStageToObserve, 
                                      MConnectionStageObserver* aObserver, 
                                      TBool aCompleteIfAlreadyAtStage= ETrue  );

    /**
	*Starts the notification service
	*after it has been started you can expect a notification
    *@param aConnName connection name returned by RConnection::Name()
	*@param aStagesToObserve array that contains the stages 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
	*/
    IMPORT_C void StartNotificationL( TName* aConnName, 
                                      TInt* aStages, 
                                      TInt aNumOfStages,
                                      MConnectionMultiStageObserver* aObserver,
                                      TBool aCompleteIfAlreadyAtStage = ETrue );

    IMPORT_C TNifProgressBuf GetProgressBuffer();

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

    /**
    *Checks if any of the stage passed in StartNotificationL() is reached.
    *Doesn't stop for waiting for another state.
    */
    TBool IsAnyStageReached( TInt aCurrentStage );

private:

    RSocketServ     iServer;
    RConnection     iConnection;
	TNifProgressBuf iProgressBuf;		
	TBool iCompleteIfAlreadyAtStage;	
	TInt iStageToObserve;
	MConnectionStageObserver* iObserver;
    MConnectionMultiStageObserver* iMultiObserver;
    TInt*   iStages;
    TInt    iNumOfStages;
	};






#endif
// End of File