dunit

Class RMIException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.gemstone.gemfire.GemFireException

dunit.RMIException

All Implemented Interfaces:

Serializable

public class RMIException
extends com.gemstone.gemfire.GemFireException

This exception is thrown when an exception occurs during a remote method invocation. This RuntimeException wraps the actual exception. It allows distributed unit tests to verify that an exception was thrown in a different VM.

     VM vm0 = host0.getVM(0);
     try {
       vm.invoke(this.getClass(), "getUnknownObject");

     } catch (RMIException ex) {
       assertEquals(ex.getCause() instanceof ObjectException);
     }
 

Note that special steps are taken so that the stack trace of the cause exception reflects the call stack on the remote machine. The stack trace of the exception returned by getCause() may not be available.

See Also:

RemoteTestModuleIF, Serialized Form

Constructor Summary

Constructors

Constructor and Description
RMIException(VM vm, String className, String methodName, Throwable cause) Creates a new RMIException that was caused by a given Throwable while invoking a given method.
RMIException(VM vm, String className, String methodName, Throwable cause, String stackTrace) Creates a new RMIException to indicate that an exception of a given type was thrown while invoking a given method.

Method Summary

Modifier and Type	Method and Description
Throwable	getCause() Returns the cause of this exception.
String	getExceptionClassName() Returns the class name of the exception that was thrown in a remote method invocation.
VM	getVM() Returns the VM in which the remote method was invoked

Methods inherited from class com.gemstone.gemfire.GemFireException

getOrigin, getRootCause, setOrigin

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

RMIException

public RMIException(VM vm,
                    String className,
                    String methodName,
                    Throwable cause)

Creates a new RMIException that was caused by a given Throwable while invoking a given method.

RMIException

public RMIException(VM vm,
                    String className,
                    String methodName,
                    Throwable cause,
                    String stackTrace)

Creates a new RMIException to indicate that an exception of a given type was thrown while invoking a given method.

Parameters:

vm - The VM in which the method was executing

className - The name of the class whose method was being invoked remotely

methodName - The name of the method that was being invoked remotely

cause - The type of exception that was thrown in the remote VM

stackTrace - The stack trace of the exception from the remote VM

Method Detail

getExceptionClassName

public String getExceptionClassName()

Returns the class name of the exception that was thrown in a remote method invocation.

getCause

public Throwable getCause()

Returns the cause of this exception. Note that this is not necessarily the exception that gets printed out with the stack trace.

Overrides:

getCause in class Throwable

getVM

public VM getVM()

Returns the VM in which the remote method was invoked