Class ExecutionTimesReport

java.lang.Object

com.carrotsearch.ant.tasks.junit4.listeners.ExecutionTimesReport

All Implemented Interfaces:

AggregatedEventListener

public class ExecutionTimesReport
extends Object
implements AggregatedEventListener

A report listener that emits per-suite execution times information useful for load balancing tests across JVMs.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	DEFAULT_HISTORY_LENGTH
private Map<String, List<Long>>	hints	Execution time hints.
private File	hintsFile	The file where suite hints are stored/ updated.
private int	historyLength
private JUnit4	outer	Outer task.

Constructor Summary

Constructors

Constructor	Description
ExecutionTimesReport()

Method Summary

Modifier and Type	Method	Description
static void	mergeHints(InputStream is, Map<String, List<Long>> hints)	Read hints from a file and merge with the given hints map.
static Map<String, List<Long>>	mergeHints(Collection<org.apache.tools.ant.types.ResourceCollection> resources, Collection<String> suiteNames)	Read hints from all resources in a collection, retaining suiteNames.
void	onEnd(AggregatedQuitEvent e)	Write back to hints file.
void	onSuiteResult(AggregatedSuiteResultEvent e)	Remember execution time for all executed suites.
static Map<String, List<Long>>	readHints(File hints)	Read hints from a file.
void	setFile(File hintsFile)	Hints file (key-value pairs).
void	setHistoryLength(int length)	How many execution times to store per-suite? The history must be larger than 0.
void	setOuter(JUnit4 outer)	Link to the container.
static void	writeHints(File file, Map<String, List<Long>> hints)	Writes back hints file.

Methods inherited from class Object

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

Field Details

DEFAULT_HISTORY_LENGTH

public static final int DEFAULT_HISTORY_LENGTH

See Also:

• setHistoryLength(int)
• Constant Field Values

hintsFile

private File hintsFile

The file where suite hints are stored/ updated.

hints

private Map<String, List<Long>> hints

Execution time hints. Key: suite name, value: execution times.

historyLength

private int historyLength

See Also:

• setHistoryLength(int)

outer

private JUnit4 outer

Outer task.

Constructor Details

ExecutionTimesReport

public ExecutionTimesReport()

Method Details

setFile

public void setFile(File hintsFile)

Hints file (key-value pairs).

setHistoryLength

public void setHistoryLength(int length)

How many execution times to store per-suite? The history must be larger than 0.

onSuiteResult

public void onSuiteResult(AggregatedSuiteResultEvent e)

Remember execution time for all executed suites.

onEnd

public void onEnd(AggregatedQuitEvent e)

Write back to hints file.

setOuter

public void setOuter(JUnit4 outer)
              throws org.apache.tools.ant.BuildException

Description copied from interface: AggregatedEventListener

Link to the container. Listener can throw BuildException if parameter validation doesn't succeed, for example.

Specified by:

setOuter in interface AggregatedEventListener

Throws:

org.apache.tools.ant.BuildException

readHints

public static Map<String, List<Long>> readHints(File hints)
                                         throws IOException

Read hints from a file.

Throws:

IOException

mergeHints

public static void mergeHints(InputStream is,
 Map<String, List<Long>> hints)
                       throws IOException

Read hints from a file and merge with the given hints map.

Throws:

IOException

writeHints

public static void writeHints(File file,
 Map<String, List<Long>> hints)
                       throws IOException

Writes back hints file.

Throws:

IOException

mergeHints

public static Map<String, List<Long>> mergeHints(Collection<org.apache.tools.ant.types.ResourceCollection> resources,
 Collection<String> suiteNames)

Read hints from all resources in a collection, retaining suiteNames. If suiteNames is null, everything is retained.