randoop.util

Class ReflectionCode

java.lang.Object

randoop.util.ReflectionCode

Direct Known Subclasses:

ConstructorReflectionCode, MethodReflectionCode, ObjectContractReflectionCode

public abstract class ReflectionCode
extends java.lang.Object

Wraps a method or constructor together with its arguments. Can be run only once. hasRun() indicates whether it has been run.

Implemented by parts of Randoop that want to execute reflection code via ReflectionExecutor.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	ReflectionCode.ReflectionCodeException Indicates a bug in the ReflectionCode class.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Throwable	exceptionThrown The exception thrown by execution.
private boolean	hasRun Has this been executed already?
private boolean	hasStarted Has this started execution?
protected java.lang.Object	retval The value yielded by execution.

Constructor Summary

Constructors

Constructor and Description
ReflectionCode()

Method Summary

Modifier and Type	Method and Description
java.lang.Throwable	getExceptionThrown()
java.lang.Object	getReturnValue()
boolean	hasRun()
boolean	hasStarted()
void	runReflectionCode() Runs the reflection code that this object represents.
protected abstract void	runReflectionCodeRaw() Execute the reflection code.
protected void	setHasRun()
protected void	setHasStarted()
protected java.lang.String	status() A suffix to be called by toString().

Methods inherited from class java.lang.Object

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

Field Detail

hasStarted

private boolean hasStarted

Has this started execution?

hasRun

private boolean hasRun

Has this been executed already?

retval

protected java.lang.Object retval

The value yielded by execution.

exceptionThrown

protected java.lang.Throwable exceptionThrown

The exception thrown by execution.

Constructor Detail

ReflectionCode

public ReflectionCode()

Method Detail

hasStarted

public final boolean hasStarted()

hasRun

public final boolean hasRun()

setHasStarted

protected final void setHasStarted()

setHasRun

protected final void setHasRun()

runReflectionCode

public final void runReflectionCode()
                             throws ReflectionCode.ReflectionCodeException

Runs the reflection code that this object represents.

1. This method calls runReflectionCodeRaw() to perform the actual work. runReflectionCodeRaw() sets the retVal or exceptionThrown field, or throws an exception if there is a bug in Randoop.

Throws:

ReflectionCode.ReflectionCodeException - if execution results in conflicting error and success states; this results from a bug in Randoop

runReflectionCodeRaw

protected abstract void runReflectionCodeRaw()
                                      throws ReflectionCode.ReflectionCodeException

Execute the reflection code. All Randoop implementation errors must be thrown as ReflectionCodeException because everything else is caught.

Throws:

ReflectionCode.ReflectionCodeException - if execution results in conflicting error and success states; this results from a bug in Randoop

getReturnValue

public java.lang.Object getReturnValue()

getExceptionThrown

public java.lang.Throwable getExceptionThrown()

status

protected java.lang.String status()

A suffix to be called by toString().

Returns:

the status of the command