io.snappydata.test.dunit

Class AsyncInvocation

java.lang.Object

java.lang.Thread

io.snappydata.test.dunit.AsyncInvocation

All Implemented Interfaces:

java.lang.Runnable

public class AsyncInvocation
extends java.lang.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

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Throwable	exception An exception thrown while this async invocation ran
java.lang.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(java.lang.Object receiver, java.lang.String methodName, java.lang.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.
java.lang.Throwable	getException() Returns the exception that was thrown during this async method invocation.
java.lang.String	getMethodName() Returns the name of the method being invoked remotely
java.lang.Object	getReceiver() Returns the receiver of this async method invocation
java.lang.Object	getResult()
java.lang.Object	getResult(long waitTime)
java.lang.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 java.lang.Throwable exception

An exception thrown while this async invocation ran

returnedObj

public volatile java.lang.Object returnedObj

The returned object if any

Constructor Detail

AsyncInvocation

public AsyncInvocation(java.lang.Object receiver,
                       java.lang.String methodName,
                       java.lang.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 java.lang.Object getReceiver()

Returns the receiver of this async method invocation

getMethodName

public java.lang.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 java.lang.Throwable getException()

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

getResult

public java.lang.Object getResult()
                           throws java.lang.Throwable

Throws:

java.lang.Throwable

getResult

public java.lang.Object getResult(long waitTime)
                           throws java.lang.Throwable

Throws:

java.lang.Throwable

getReturnValue

public java.lang.Object getReturnValue()

run

public void run()

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread