com.atlassian.clover.api.optimization

Class TestOptimizer

java.lang.Object

com.atlassian.clover.api.optimization.TestOptimizer

public class TestOptimizer
extends Object

A TestOptimizer allows you to optimize a Collection of classes (that are Tests) programatically.

Typically, this is to be done if your tests in are defined in a junit.framework.TestSuite.

• The optimize(java.util.List<T>) method will take a list of Optimizables and return an optimized list of Optimizables.
• The optimizeTestClasses(java.util.Collection<java.lang.Class>) method is a convenience method for optimizing a list of Test Classes.

Constructor Summary

Constructors

Constructor and Description
TestOptimizer(OptimizationOptions options)
TestOptimizer(String initString, File snapshotFile)

Method Summary

Modifier and Type	Method and Description
<T extends Optimizable> List<T>	optimize(List<T> optimizables) Optimize a collection of any Optimizable.
List<Optimizable>	optimizeObjects(List objectList) Optimizes a collection of unknown objects.
Collection<Class>	optimizeTestClasses(Collection<Class> testClasses) Optimize a collection of Test classes.

Methods inherited from class java.lang.Object

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

Constructor Detail

TestOptimizer

public TestOptimizer(OptimizationOptions options)

TestOptimizer

public TestOptimizer(String initString,
                     File snapshotFile)

Method Detail

optimizeTestClasses

public Collection<Class> optimizeTestClasses(Collection<Class> testClasses)

Optimize a collection of Test classes.

Parameters:

testClasses - classes to be optimized

Returns:

an optimized list of Classes

optimize

public <T extends Optimizable> List<T> optimize(List<T> optimizables)

Optimize a collection of any Optimizable.

Type Parameters:

T - Optimizable

Parameters:

optimizables - a list of objects, denoting tests, to optimize

Returns:

an optimized list of optimizable objects

optimizeObjects

public List<Optimizable> optimizeObjects(List objectList)
                                  throws NoSuchMethodException,
                                         InvocationTargetException,
                                         IllegalAccessException

Optimizes a collection of unknown objects. It tries to call 'getName()' method on each element from objectList using reflections. It returns a List where each element is an Optimizable which getName() method returns a value of corresponding objectList.get(x).getName().

This is a workaround for Clover-for-Grails plugin, where FileOptimizable class cannot implement Optimizable interface due to problems with dependency resolution in Grails via 'install-plugin' command. We're using Object and reflections to pass the necessary information.

Parameters:

objectList - list of objects having the 'String getName()' method returning name of optimizable resource

Returns:

List<Optimizable> optimized resource set

Throws:

NoSuchMethodException - if getName() method does not exist

InvocationTargetException - if getName() call fails

IllegalAccessException - if getName() call fails