javauis/eswt_akn/org.eclipse.ercp.swt.s60/native/inc/swtbrowserconnectionobserver.h
branchRCL_3
changeset 14 04becd199f91
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/eswt_akn/org.eclipse.ercp.swt.s60/native/inc/swtbrowserconnectionobserver.h	Tue Apr 27 16:30:29 2010 +0300
@@ -0,0 +1,109 @@
+/*******************************************************************************
+ * 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