org.cornutum.tcases.openapi.resolver

Class ResolverContext

java.lang.Object

org.cornutum.tcases.openapi.ExecutionContext<ResolverException>

org.cornutum.tcases.openapi.resolver.ResolverContext

public class ResolverContext
extends ExecutionContext<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(Random random) Creates a new ResolverContext instance.

Method Summary

Modifier and Type	Method and Description
static ResolverContext.Builder	builder(Random random) Returns a new ResolverContext builder.
void	error(String reason, String resolution) Reports an error that would have resulted in an inconsistent or infeasible test case.
int	getMaxTries() Returns the maximum attempts to resolve an input value before reporting failure.
Notifier	getNotifier() Returns the notifier that reports conditions that occur when resolving a test case.
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	setNotifier(Notifier notifier) Changes the notifier that reports conditions that occur when resolving a test case.
void	setRandom(Random random) Changes the random number generator used to resolve test cases.
<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.
void	warn(String reason) Reports a condition that will affect the expected test cat.
protected ResolverException	whenFailure(Exception e) Returns an exception to throw for the given failure.

Methods inherited from class org.cornutum.tcases.openapi.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(Random random)

Creates a new ResolverContext instance.

Method Detail

whenFailure

protected ResolverException whenFailure(Exception 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.

setNotifier

public void setNotifier(Notifier notifier)

Changes the notifier that reports conditions that occur when resolving a test case.

getNotifier

public Notifier getNotifier()

Returns the notifier that reports conditions that occur when resolving a test case.

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

warn

public void warn(String reason)

Reports a condition that will affect the expected test cat.

Parameters:

reason - A description of the condition

error

public void error(String reason,
                  String resolution)

Reports an error that would have resulted in an inconsistent or infeasible test case.

Parameters:

reason - A description of the problem

resolution - A description of how the problem was resolved

builder

public static ResolverContext.Builder builder(Random random)

Returns a new ResolverContext builder.