trace/traceviewer/com.nokia.traceviewer/src/com/nokia/traceviewer/api/ITraceConnClient.java
changeset 11 5b9d4d8641ce
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/trace/traceviewer/com.nokia.traceviewer/src/com/nokia/traceviewer/api/ITraceConnClient.java	Wed Jun 23 14:49:59 2010 +0300
@@ -0,0 +1,50 @@
+/*
+ * Copyright (c) 2007-2010 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:
+ *
+ */
+
+package com.nokia.traceviewer.api;
+
+/**
+ * This is interface that each client has to implement in order to get
+ * notifications about connection status changes
+ */
+public interface ITraceConnClient {
+
+	/**
+	 * Registered connection is re-established after connection break.
+	 * 
+	 * @param connectionInfo
+	 *            connection info for the newly connected connection
+	 */
+	void notifyConnection(ITraceConnInfo connectionInfo);
+
+	/**
+	 * Registered connection is disconnected.
+	 */
+	void notifyDisconnection();
+
+	/**
+	 * Connection preferences has been changed and the new settings will be
+	 * taken into use when trace connection is restarted next time i.e. in next
+	 * <code>notifyConnection()</code>. Interface implementor can already notify
+	 * user in this point if connection preferences are not acceptable ones.
+	 * 
+	 * @param connectionInfo
+	 *            connection info for the newly set connection preference
+	 */
+	void notifyConnPrefsChanged(ITraceConnInfo connectionInfo);
+
+}