org.eclipse.ecf.core.util
Class AsyncResult

java.lang.Object
  org.eclipse.ecf.core.util.AsyncResult

All Implemented Interfaces:

IAsyncResult

public class AsyncResult
extends java.lang.Object
implements IAsyncResult

Class to represent asynchronous result (aka Future)

Field Summary

protected java.lang.reflect.InvocationTargetException	resultException
protected boolean	resultReady
protected java.lang.Object	resultValue

Constructor Summary

AsyncResult()

Method Summary

void	clear() Clear this AsyncResult.
protected java.lang.Object	doGet()
java.lang.Object	get() Get the underlying result.
java.lang.Object	get(long msecs) Get the underlying result with limited wait time.
java.lang.reflect.InvocationTargetException	getException() Get the InvocationTargetException that occured during invocation.
boolean	isReady()
java.lang.Object	peek()
void	set(java.lang.Object newValue) Set the result to a newValue.
void	setException(java.lang.Throwable ex) Set exception to ex
java.lang.Runnable	setter(ICallable function) Set the underlying function call that will return a result asynchronously

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

resultValue

protected java.lang.Object resultValue

resultReady

protected boolean resultReady

resultException

protected java.lang.reflect.InvocationTargetException resultException

Constructor Detail

AsyncResult

public AsyncResult()

Method Detail

setter

public java.lang.Runnable setter(ICallable function)

Set the underlying function call that will return a result asynchronously

Parameters:

function - the ICallable to be called

Returns:

Runnable to run

doGet

protected java.lang.Object doGet()
                          throws java.lang.reflect.InvocationTargetException

Throws:

java.lang.reflect.InvocationTargetException

get

public java.lang.Object get()
                     throws java.lang.InterruptedException,
                            java.lang.reflect.InvocationTargetException

Description copied from interface: IAsyncResult

Get the underlying result. Block until result is available.

Specified by:

get in interface IAsyncResult

Returns:

Object that is result

Throws:

java.lang.InterruptedException - thrown if waiting is interrupted

java.lang.reflect.InvocationTargetException - thrown if exception was thrown by execution

get

public java.lang.Object get(long msecs)
                     throws TimeoutException,
                            java.lang.InterruptedException,
                            java.lang.reflect.InvocationTargetException

Description copied from interface: IAsyncResult

Get the underlying result with limited wait time. Behaves similarly to Object.wait(), but only waits msecs (ms) before throwing TimeoutException

Specified by:

get in interface IAsyncResult

Parameters:

msecs - to wait before timing out

Returns:

Object that is result

Throws:

TimeoutException - thrown if msecs elapse before a result is available

java.lang.InterruptedException - thrown if waiting is interrupted

java.lang.reflect.InvocationTargetException - thrown if exception was thrown by execution

set

public void set(java.lang.Object newValue)

Set the result to a newValue.

Parameters:

newValue - to set the result to

setException

public void setException(java.lang.Throwable ex)

Set exception to ex

Parameters:

ex - the Throwable to set the exception to

getException

public java.lang.reflect.InvocationTargetException getException()

Description copied from interface: IAsyncResult

Get the InvocationTargetException that occured during invocation. If null, no exception was thrown

Specified by:

getException in interface IAsyncResult

Returns:

InvocationTargetException if an exception occurred. Null if no exception has occurred

isReady

public boolean isReady()

Specified by:

isReady in interface IAsyncResult

Returns:

true if result has been set or exception has occurred, false if not.

peek

public java.lang.Object peek()

Specified by:

peek in interface IAsyncResult

Returns:

Object result that has been set or null if has not been set

clear

public void clear()

Description copied from interface: IAsyncResult

Clear this AsyncResult. Clears both the result Object and the InvocationTargetException (if set)

Specified by:

clear in interface IAsyncResult