org.cornutum.tcases.resolve

Class ResolverContext

java.lang.Object

org.cornutum.tcases.util.ExecutionContext<E>

org.cornutum.tcases.util.ExecutionNotifier<ResolverException>

org.cornutum.tcases.resolve.ResolverContext

public class ResolverContext
extends ExecutionNotifier<ResolverException>

Defines options used to resolve an executable API test case.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ResolverContext.Builder Builds a new ResolverContext instance.

Constructor Summary

Constructors

Constructor and Description
ResolverContext(String... startLocation) Creates a new ResolverContext instance.

Method Summary

Modifier and Type	Method and Description
static ResolverContext.Builder	builder(String... startLocation) Returns a new ResolverContext builder.
int	getMaxTries() Returns the maximum attempts to resolve an input value before reporting failure.
Random	getRandom() Returns the random number generator used to resolve test cases.
void	setMaxTries(int maxTries) Changes the maximum attempts to resolve an input value before reporting failure.
void	setRandom(Random random) Changes the random number generator used to resolve test cases.
<T> T	tryUntil(Stream<Optional<T>> results) Returns the first result that is present.
<T> T	tryUntil(Supplier<Optional<T>> valueSupplier) Repeats evaluation of the given valueSupplier until a result is present or until the maximum tries have been attempted.
protected ResolverException	whenFailure(Throwable e) Returns an exception to throw for the given failure.

Methods inherited from class org.cornutum.tcases.util.ExecutionNotifier

error, getNotifier, setNotifier, warn

Methods inherited from class org.cornutum.tcases.util.ExecutionContext

doFor, getLocation, resultFor, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ResolverContext

public ResolverContext(String... startLocation)

Creates a new ResolverContext instance.

Method Detail

whenFailure

protected ResolverException whenFailure(Throwable e)

Returns an exception to throw for the given failure.

Specified by:

whenFailure in class ExecutionContext<ResolverException>

setRandom

public void setRandom(Random random)

Changes the random number generator used to resolve test cases.

getRandom

public Random getRandom()

Returns the random number generator used to resolve test cases.

setMaxTries

public void setMaxTries(int maxTries)

Changes the maximum attempts to resolve an input value before reporting failure.

getMaxTries

public int getMaxTries()

Returns the maximum attempts to resolve an input value before reporting failure.

tryUntil

public <T> T tryUntil(Supplier<Optional<T>> valueSupplier)
               throws ResolverSkipException

Repeats evaluation of the given valueSupplier until a result is present or until the maximum tries have been attempted. If the no more attempts are possible, reports a failure. Otherwise, returns the supplied result.

Throws:

ResolverSkipException

tryUntil

public <T> T tryUntil(Stream<Optional<T>> results)
               throws ResolverSkipException

Returns the first result that is present. If the maximum tries have been attempted unsuccessfully reports a failure. Otherwise, returns the result.

Throws:

ResolverSkipException

builder

public static ResolverContext.Builder builder(String... startLocation)

Returns a new ResolverContext builder.