org.perfidix

Class Perfidix

java.lang.Object

org.perfidix.Perfidix

public final class Perfidix
extends Object

This is the main class, consisting of all the factory methods needed in order to perform a benchmark run. Instead of running the bench with a Benchmark instance, this class just takes all classes as a String and gives less control over the Benchmark itself. The Classes to be given are either Benchmark-Classes or (one single) Config-Class. Additionaly, this class holds multiple utility-methods to get Bench-Classes and Config out of a set of Strings.

 
 public class MyBenchmark {
 
     public static void main(final String[] args) {
         final String classNames = {
             "Class1", "Class2", "Class3", "MyConfig1"
         };
 
         // either...
         final BenchmarkResult result = Perfidix.runBenchs(classNames);
         new TabularSummaryOutput.visitBenchmark(result);
 
         // ...or...
         Perfidix.main(classNames);
     }
 }
 
 

Author:

Sebastian Graf, University of Konstanz

See Also:

AbstractConfig, BenchmarkResult

Method Summary

Methods

Modifier and Type	Method and Description
static AbstractConfig	getConfiguration(String[] classes) Getting a configuration out of the class-files.
static void	main(String[] args) Main method for invoking benchs with classes as strings.
static BenchmarkResult	runBenchs(String[] benchs) Running one Benchmark.
static Benchmark	setUpBenchmark(String[] classes, Benchmark benchmark) Setting up an existing benchmark with the given number of class-files

Methods inherited from class java.lang.Object

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

Method Detail

runBenchs

public static BenchmarkResult runBenchs(String[] benchs)
                                 throws ClassNotFoundException,
                                        InstantiationException,
                                        IllegalAccessException

Running one Benchmark.

Parameters:

benchs - to be inserted

Returns:

one BenchmarkResult object with the results

Throws:

ClassNotFoundException - if class cannot be found

IllegalAccessException - if conf cannot be instantiated

InstantiationException - if conf cannot be instantiated

setUpBenchmark

public static Benchmark setUpBenchmark(String[] classes,
                       Benchmark benchmark)
                                throws ClassNotFoundException

Setting up an existing benchmark with the given number of class-files

Parameters:

classes - to be benched

benchmark - to be set up

Returns:

the same Benchmark object with the classes

Throws:

ClassNotFoundException - thrown if class was not found.

getConfiguration

public static AbstractConfig getConfiguration(String[] classes)
                                       throws ClassNotFoundException,
                                              InstantiationException,
                                              IllegalAccessException

Getting a configuration out of the class-files. If none is avaliable, the AbstractConfig.StandardConfig is given back. The AbstractConfig instance has to have a parameter-free constructor.

Parameters:

classes - to be examined. Only one instance of an AbstractConfig is allowed.

Returns:

the AbstractConfig instance or the AbstractConfig.StandardConfig if none was found.

Throws:

ClassNotFoundException - thrown if a class was not found.

InstantiationException - thrown if the AbstractConfig instance was not able to be instaniated

IllegalAccessException - thrown if the AbstractConfig instance was not able to be instaniated

main

public static void main(String[] args)
                 throws ClassNotFoundException,
                        InstantiationException,
                        IllegalAccessException

Main method for invoking benchs with classes as strings.

Parameters:

args - the classes

Throws:

ClassNotFoundException - if class cannot be found

IllegalAccessException - if conf cannot be instantiated

InstantiationException - if conf cannot be instantiated