org.echocat.jomon.testing

Class Assert.AssertWithRetrySupport<S extends RetryingStrategy<java.lang.Void>>

java.lang.Object

org.echocat.jomon.testing.Assert.AssertWithRetrySupport<S>

Direct Known Subclasses:

Assert.AssertWithRetry, Assert.AssertWithRetryRespectingException

Enclosing class:

Assert

public static class Assert.AssertWithRetrySupport<S extends RetryingStrategy<java.lang.Void>>
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Assert.AssertWithRetrySupport(S retryingStrategy) Creates an assertion with a RetryingStrategy to satisfiy a condition.

Method Summary

Methods

Modifier and Type	Method and Description
protected S	getRetryingStrategy()
<T> void	that(java.util.concurrent.Callable<T> fetchActual, org.hamcrest.Matcher<T> matcher)
<T> void	that(java.lang.String reason, java.util.concurrent.Callable<T> fetchActual, org.hamcrest.Matcher<T> matcher) Asserts that the return value of a Callable fetchActual satisfies the condition specified by the matcher.

Methods inherited from class java.lang.Object

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

Constructor Detail

Assert.AssertWithRetrySupport

public Assert.AssertWithRetrySupport(@Nonnull
                             S retryingStrategy)

Creates an assertion with a RetryingStrategy to satisfiy a condition. For better readability use Assert's factory methods assertWithTimeout or assertWithRetries.

Parameters:

retryingStrategy - the RetryingStrategy that will be used to satisfy a given condition

Method Detail

getRetryingStrategy

@Nonnull
protected S getRetryingStrategy()

that

public <T> void that(@Nonnull
            java.util.concurrent.Callable<T> fetchActual,
            @Nonnull
            org.hamcrest.Matcher<T> matcher)
          throws java.lang.Exception

Throws:

java.lang.Exception

that

public <T> void that(@Nullable
            java.lang.String reason,
            @Nonnull
            java.util.concurrent.Callable<T> fetchActual,
            @Nonnull
            org.hamcrest.Matcher<T> matcher)
          throws java.lang.Exception

Asserts that the return value of a Callable fetchActual satisfies the condition specified by the matcher. If it doesn't, the given RetryingStrategy is used to try to satisfy the condition. If it cannot succeed, an AssertionError is thrown. For instance, if we await an integer x to become 5 within five seconds, we could write:

     assertWithTimeout("5s").that("some reasons", new Callable() {
         @Override
         public Boolean call() throws Exception {
             return null;
         }
     }, equalTo(5));
 

With Java 1.8 or later, we can use the more straightforward lamba notation:

     assertWithTimeout("5s").that("some reasons", () -> x, equalTo(5));
 

Parameters:

reason - additional information about the error

fetchActual - a callable that return the value to be compared compile-time problems such as assertThat(1, is("a"))

matcher - an expression, built of Matchers, specifying allowed

Throws:

java.lang.Exception