X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=src%2Fjalview%2Futil%2Fdialogrunner%2FDialogRunnerI.java;h=0cb90c27b37373f58802ec6e7ed3c4240cfc69d8;hb=5443eb560cbf7baf3de56a918cab254c6dd329df;hp=758d421e11c516b3e208369778e3363c1585db52;hpb=2e02b14ba33c2cf4618f65c831a506f81e621589;p=jalview.git

diff --git a/src/jalview/util/dialogrunner/DialogRunnerI.java b/src/jalview/util/dialogrunner/DialogRunnerI.java
index 758d421..0cb90c2 100644
--- a/src/jalview/util/dialogrunner/DialogRunnerI.java
+++ b/src/jalview/util/dialogrunner/DialogRunnerI.java
@@ -21,23 +21,36 @@
 package jalview.util.dialogrunner;
 
 /**
- * functional pattern for blocking dialog response handling
+ * An interface for blocking dialog response handling. This is motivated by
+ * JalviewJS - when running as Javascript, there is only a single thread, and
+ * blocking dialogs have to be responsible for performing any actions required
+ * for user responses.
  * 
  * @author jprocter
  *
  */
-public interface DialogRunnerI<T extends DialogRunnerI>
-{
+public interface DialogRunnerI {
 
-  /**
-   * Adds a new response for this dialog, and returns the dialog (this), to allow chaining, eg.
-   * <pre>
-   * dialog.addResponse(newRunResponse(OK_PRessed) { run()...})
-   *     .addResponse(new RunResponse(CANCEL_PRESSED);
-   * </pre>
-   * 
-   * @param action
-   * @return the dialog
-   */
-  T addResponse(RunResponse action);
+	/**
+	 * Sets the action to be performed when the dialog returns the given response.
+	 * Note this also handles <code>int</code>-valued responses, which will be
+	 * converted to <code>Integer</code> when this method is invoked.
+	 * 
+	 * @param response
+	 * @param action
+	 * @return
+	 */
+	DialogRunnerI setResponseHandler(Object response, Runnable action);
+
+	/**
+	 * Runs the registered handler (if any) for the given response. The default
+	 * action is to do nothing. Typically an action will be need on 'OK' or other
+	 * positive selection in the dialog. An action might in some cases also be
+	 * needed for a 'Cancel' response.
+	 * 
+	 * @param response
+	 * @return
+	 */
+	default void handleResponse(Object response) {
+	}
 }