org.jvnet.hudson.test

Class RunLoadCounter

java.lang.Object

org.jvnet.hudson.test.RunLoadCounter

public final class RunLoadCounter
extends Object

Utility to determine when a build record is loaded.

Since:

1.517

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RunLoadCounter.Marker Used internally.
static class	RunLoadCounter.MarkerAdder Used internally.

Method Summary

Modifier and Type	Method and Description
static <T> T	assertMaxLoads(jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<?,?> project, int max, Callable<T> thunk) Asserts that at most a certain number of build records are loaded as a result of some task.
static int	countLoads(jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<?,?> project, Runnable thunk) Counts how many build records are loaded as a result of some task.
static void	prepare(jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<?,?> project) Prepares a new project to be measured.

Methods inherited from class java.lang.Object

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

Method Detail

prepare

public static void prepare(jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<?,?> project)
                    throws IOException

Prepares a new project to be measured. Usually called before starting builds, but may also be called retroactively.

Parameters:

project - a project of any kind

Throws:

IOException - if preparations fail

countLoads

public static int countLoads(jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<?,?> project,
                             Runnable thunk)

Counts how many build records are loaded as a result of some task.

Parameters:

project - a project on which prepare(jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<?, ?>) was called prior to creating builds

thunk - a task which is expected to load some build records

Returns:

how many build records were actually loaded as a result

assertMaxLoads

public static <T> T assertMaxLoads(jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<?,?> project,
                                   int max,
                                   Callable<T> thunk)
                            throws Exception

Asserts that at most a certain number of build records are loaded as a result of some task.

Type Parameters:

T - the return value type

Parameters:

project - a project on which prepare(jenkins.model.lazy.LazyBuildMixIn.LazyLoadingJob<?, ?>) was called prior to creating builds

max - the maximum number of build records we expect to load

thunk - a task which is expected to load some build records

Returns:

the result of the task, if any

Throws:

Exception - if the task failed

AssertionError - if one more than max build record is loaded