--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/web_plat/connection_manager_api/inc/ConnectionObservers.h Mon Mar 30 12:54:55 2009 +0300
@@ -0,0 +1,167 @@
+/*
+* 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>
+
+
+//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 );
+
+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