Skip to main content
aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorslewis2007-04-17 10:32:05 -0400
committerslewis2007-04-17 10:32:05 -0400
commitcfc95501ff66dafb9f4a01e184bd74fdec98199d (patch)
tree02ec5c232cfddea05874ecc0d9dee3f5979ad857 /framework/bundles/org.eclipse.ecf.presence
parent7d7953984dce796cc1c240eeaf88a94d32330019 (diff)
downloadorg.eclipse.ecf-cfc95501ff66dafb9f4a01e184bd74fdec98199d.tar.gz
org.eclipse.ecf-cfc95501ff66dafb9f4a01e184bd74fdec98199d.tar.xz
org.eclipse.ecf-cfc95501ff66dafb9f4a01e184bd74fdec98199d.zip
Added javadocs
Diffstat (limited to 'framework/bundles/org.eclipse.ecf.presence')
-rw-r--r--framework/bundles/org.eclipse.ecf.presence/src/org/eclipse/ecf/presence/IPresenceListener.java25
1 files changed, 23 insertions, 2 deletions
diff --git a/framework/bundles/org.eclipse.ecf.presence/src/org/eclipse/ecf/presence/IPresenceListener.java b/framework/bundles/org.eclipse.ecf.presence/src/org/eclipse/ecf/presence/IPresenceListener.java
index 4f1e0309d..a9c18c300 100644
--- a/framework/bundles/org.eclipse.ecf.presence/src/org/eclipse/ecf/presence/IPresenceListener.java
+++ b/framework/bundles/org.eclipse.ecf.presence/src/org/eclipse/ecf/presence/IPresenceListener.java
@@ -12,8 +12,29 @@
package org.eclipse.ecf.presence;
/**
- *
- */
+ * Listener for user presence changes.
+ * <p></p>
+ * Note these methods will be called asynchronously when notifications of remote
+ * changes are received by the provider implementation code. The provider is
+ * free to call the methods below with an arbitrary thread, so the
+ * implementation of these methods must be appropriately prepared.
+ * <p>
+ * </p>
+ * For example, if the code implementing any of these methods must interact with
+ * user interface code, then it should use code such as the following to execute
+ * on the SWT UI thread:
+ *
+ * <pre>
+ * Display.getDefault().asyncExec(new Runnable() {
+ * public void run() {
+ * ... UI code here
+ * }
+ * });
+ * </pre>
+ *
+ * Further, the code in the implementations of these methods should <b>not block</b> via
+ * I/O operations or blocking UI calls.
+*/
public interface IPresenceListener extends IParticipantListener {
}

Back to the top