X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Fws2%2FWebServiceWorkerListener.java;h=74eb144256c98184f1c5662e32843ca0c75f21e6;hb=2bbba7f7426314bfd6a1f206861542244b5f511a;hp=16ee7bd12a3e0dc2c16fe80a85f7220ae415b8ad;hpb=158e0595615ae4bfb13554f41f03b570642f6bb2;p=jalview.git

diff --git a/src/jalview/ws2/WebServiceWorkerListener.java b/src/jalview/ws2/WebServiceWorkerListener.java
index 16ee7bd..74eb144 100644
--- a/src/jalview/ws2/WebServiceWorkerListener.java
+++ b/src/jalview/ws2/WebServiceWorkerListener.java
@@ -1,16 +1,72 @@
 package jalview.ws2;
 
+/**
+ * The listener interface for receiving signals from the
+ * {@link WebServiceWorkerI} about the state changes or new sub-jobs spawned.
+ * 
+ * The {@link WebServiceWorkerListener} objects created from that interface are
+ * then registered with a worker objects using
+ * {@link WebServiceWorkerI#addListener} method. When an event occurs, a
+ * relevant method in the listener is invoked with the worker that emitted the
+ * signal as a first parameter and, optionally, followed by additional event
+ * details.
+ * 
+ * @author mmwarowny
+ *
+ */
 public interface WebServiceWorkerListener
 {
+  /**
+   * Called when the worker started successfully.
+   * 
+   * @param source
+   *          worker that emitted the signal
+   */
   void workerStarted(WebServiceWorkerI source);
-  
+
+  /**
+   * Called when the worker failed to start the jobs.
+   * 
+   * @param source
+   *          worker that emitted the signal
+   */
   void workerNotStarted(WebServiceWorkerI source);
-  
+
+  /**
+   * Called when the worker creates a new job
+   * 
+   * @param source
+   *          worker that emitted the signal
+   * @param job
+   *          newly created job
+   */
   void jobCreated(WebServiceWorkerI source, WSJob job);
-  
+
+  /**
+   * Called when polling the job results in an exception.
+   * 
+   * @param source
+   *          worker that emitted the signal
+   * @param job
+   *          polled job
+   * @param e
+   *          exception that occurred
+   */
   void pollException(WebServiceWorkerI source, WSJob job, Exception e);
-  
+
+  /**
+   * Called when the polling has finished and the finalization process begun.
+   * 
+   * @param source
+   *          worker that emitted the signal
+   */
   void workerCompleting(WebServiceWorkerI source);
-  
+
+  /**
+   * Called when the worker completes its work.
+   * 
+   * @param source
+   *          worker that emitted the signal
+   */
   void workerCompleted(WebServiceWorkerI source);
 }