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
AssertWithRetrySupport(S retryingStrategy) Creates an assertion with a RetryingStrategy to satisfiy a condition.

Method Summary

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

AssertWithRetrySupport

public 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