dunit

Class AsyncInvocation

java.lang.Object

java.lang.Thread

dunit.AsyncInvocation

All Implemented Interfaces:

Runnable

public class AsyncInvocation
extends Thread

An AsyncInvocation represents the invocation of a remote invocation that executes asynchronously from its caller. An instanceof AsyncInvocation provides information about the invocation such as any exception that it may have thrown.

Because it is a Thread, an AsyncInvocation can be used as follows:

   AsyncInvocation ai1 = vm.invokeAsync(Test.class, "method1");
   AsyncInvocation ai2 = vm.invokeAsync(Test.class, "method2");

   ai1.join();
   ai2.join();

   assertTrue("Exception occurred while invoking " + ai1,
              !ai1.exceptionOccurred());
   if (ai2.exceptionOccurred()) {
     throw ai2.getException();
   }
 

See Also:

VM.invokeAsync(Class, String)

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected Throwable	exception An exception thrown while this async invocation ran
Object	returnedObj The returned object if any

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

Constructors

Constructor and Description
AsyncInvocation(Object receiver, String methodName, Runnable work) Creates a new AsyncInvocation

Method Summary

Modifier and Type	Method and Description
boolean	exceptionOccurred() Returns whether or not an exception occurred during this async method invocation.
Throwable	getException() Returns the exception that was thrown during this async method invocation.
String	getMethodName() Returns the name of the method being invoked remotely
Object	getReceiver() Returns the receiver of this async method invocation
Object	getResult()
Object	getResult(long waitTime)
Object	getReturnValue()
void	run()

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

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

Field Detail

exception

protected volatile Throwable exception

An exception thrown while this async invocation ran

returnedObj

public volatile Object returnedObj

The returned object if any

Constructor Detail

AsyncInvocation

public AsyncInvocation(Object receiver,
                       String methodName,
                       Runnable work)

Creates a new AsyncInvocation

Parameters:

receiver - The object or Class on which the remote method was invoked

methodName - The name of the method being invoked

work - The actual invocation of the method

Method Detail

getReceiver

public Object getReceiver()

Returns the receiver of this async method invocation

getMethodName

public String getMethodName()

Returns the name of the method being invoked remotely

exceptionOccurred

public boolean exceptionOccurred()

Returns whether or not an exception occurred during this async method invocation.

getException

public Throwable getException()

Returns the exception that was thrown during this async method invocation.

getResult

public Object getResult()
                 throws Throwable

Throws:

Throwable

getResult

public Object getResult(long waitTime)
                 throws Throwable

Throws:

Throwable

getReturnValue

public Object getReturnValue()

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread