com.samskivert.util

Interface IntResultListener

public interface IntResultListener

Provides access to an integer result, or the exception associated with failure. In the trying course of implementing a method, one is often left with no choice but to foist control off onto another thread or generally postpone things beyond the lifetime of the current call. In such circumstances, it is handy to have a general purpose mechanism for leting the caller know when things are done and whether or not the succeeded; this class serves that purpose.

The following contrived example will hopefully communicate its use more clearly than the previous paragraph of flowery prose:

 public void doSomeStuff (IntResultListener listener)
 {
     Runnable run = new Runnable () {
         public void run () {
             try {
                 // do our thing
                 listener.requestCompleted(42);
             } catch (Exception e) {
                 listener.requestFailed(e);
             }
         }
     };
     new Thread(run).start();
 }
 

This interface is a convenience-variation on the plain old ResultListener, which communicates the result back in the form of an Object rather than an integer.

Method Summary

Modifier and Type	Method and Description
void	requestCompleted(int result) Called to communicate that the request succeeded and that the result is available.
void	requestFailed(Exception cause) Called to communicate that the request failed and to provide the reason for failure.

Method Detail

requestCompleted

void requestCompleted(int result)

Called to communicate that the request succeeded and that the result is available.

requestFailed

void requestFailed(Exception cause)

Called to communicate that the request failed and to provide the reason for failure.