org.junit.internal.runners.statements

Class FailOnTimeout.Builder

java.lang.Object

org.junit.internal.runners.statements.FailOnTimeout.Builder

Enclosing class:

FailOnTimeout

public static final class FailOnTimeout.Builder
extends Object

Builder for FailOnTimeout.

Since:

4.12

Method Summary

Modifier and Type	Method and Description
FailOnTimeout	build(org.junit.runners.model.Statement statement) Builds a FailOnTimeout instance using the values in this builder, wrapping the given statement.
FailOnTimeout.Builder	withLookingForStuckThread(boolean enable) Specifies whether to look for a stuck thread.
FailOnTimeout.Builder	withTimeout(long timeout, TimeUnit unit) Specifies the time to wait before timing out the test.

Methods inherited from class java.lang.Object

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

Method Detail

withTimeout

public FailOnTimeout.Builder withTimeout(long timeout,
                                         TimeUnit unit)

Specifies the time to wait before timing out the test.

If this is not called, or is called with a timeout of 0, the returned Statement will wait forever for the test to complete, however the test will still launch from a separate thread. This can be useful for disabling timeouts in environments where they are dynamically set based on some property.

Parameters:

timeout - the maximum time to wait

unit - the time unit of the timeout argument

Returns:

this for method chaining.

withLookingForStuckThread

public FailOnTimeout.Builder withLookingForStuckThread(boolean enable)

Specifies whether to look for a stuck thread. If a timeout occurs and this feature is enabled, the test will look for a thread that appears to be stuck and dump its backtrace. This feature is experimental. Behavior may change after the 4.12 release in response to feedback.

Parameters:

enable - true to enable the feature

Returns:

this for method chaining.

build

public FailOnTimeout build(org.junit.runners.model.Statement statement)

Builds a FailOnTimeout instance using the values in this builder, wrapping the given statement.

Parameters:

statement -