org.perfidix.element

Class BenchmarkExecutor

java.lang.Object

org.perfidix.element.BenchmarkExecutor

public final class BenchmarkExecutor
extends Object

Corresponding to each method, an executor is launched to execute BeforeFirstRun, BeforeEachRun, AfterEachRun and AfterLastRun classes. To store the data if the single-execute before classes have been executed, this class is implemented as a singleton to store this information related to the method. All the data comes from the BenchmarkMethod class.

Author:

Sebastian Graf, University of Konstanz

Method Summary

Methods

Modifier and Type	Method and Description
static PerfidixMethodCheckException	checkMethod(Object obj, Class<? extends Annotation> anno, Method... meths) Checking a method if it is reflective executable and if the mapping to the object fits.
void	executeAfterMethods(Object obj) Executing the AfterLastRun-annotated methods (if still wasn't) and the AfterEachRun methods.
void	executeBeforeMethods(Object obj) Executing the BeforeFirstRun-annotated methods (if still wasn't) and the BeforeEachRun methods.
void	executeBench(Object objToExecute) Execution of bench method.
static BenchmarkExecutor	getExecutor(BenchmarkElement meth) Getting the executor corresponding to a BenchmarkElement.
static void	initialize(AbstractConfig config, BenchmarkResult result) Initializing the executor.
static PerfidixMethodInvocationException	invokeMethod(Object obj, Class<? extends Annotation> relatedAnno, Method... meths) Method to invoke a reflective invokable method.

Methods inherited from class java.lang.Object

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

Method Detail

getExecutor

public static BenchmarkExecutor getExecutor(BenchmarkElement meth)

Getting the executor corresponding to a BenchmarkElement.

Parameters:

meth - for the executor. If the underlaying Method was not registered, a new mapping-entry will be created.

Returns:

the BenchmarkExecutor corresponding to the Method of the BenchmarkElement

initialize

public static void initialize(AbstractConfig config,
              BenchmarkResult result)

Initializing the executor.

Parameters:

config - to be benched

result - to be stored to

executeBeforeMethods

public void executeBeforeMethods(Object obj)

Executing the BeforeFirstRun-annotated methods (if still wasn't) and the BeforeEachRun methods.

Parameters:

obj - the object of the class where the bench runs currently in.

executeBench

public void executeBench(Object objToExecute)

Execution of bench method. All data is stored corresponding to the meters.

Parameters:

objToExecute - the instance of the benchclass where the method should be executed with.

executeAfterMethods

public void executeAfterMethods(Object obj)

Executing the AfterLastRun-annotated methods (if still wasn't) and the AfterEachRun methods.

Parameters:

obj - the object of the class where the bench runs currently in.

invokeMethod

public static PerfidixMethodInvocationException invokeMethod(Object obj,
                                             Class<? extends Annotation> relatedAnno,
                                             Method... meths)

Method to invoke a reflective invokable method.

Parameters:

obj - on which the execution takes place

meth - to be executed

relatedAnno - related annotation for the execution

Returns:

PerfidixMethodInvocationException if invocation fails, null otherwise.

checkMethod

public static PerfidixMethodCheckException checkMethod(Object obj,
                                       Class<? extends Annotation> anno,
                                       Method... meths)

Checking a method if it is reflective executable and if the mapping to the object fits.

Parameters:

obj - on which the execution takes place

meths - to be checked

anno - the related annotation for the check

Returns:

PerfidixMethodCheckException if something is wrong in the mapping, null otherwise.