com.oracle.bedrock.deferred

Class FutureMatcher<T>

java.lang.Object

org.hamcrest.BaseMatcher<T>

org.hamcrest.TypeSafeDiagnosingMatcher<CompletableFuture<? super T>>

com.oracle.bedrock.deferred.FutureMatcher<T>

Type Parameters:

T - the type of value to match

All Implemented Interfaces:

org.hamcrest.Matcher<CompletableFuture<? super T>>, org.hamcrest.SelfDescribing

public class FutureMatcher<T>
extends org.hamcrest.TypeSafeDiagnosingMatcher<CompletableFuture<? super T>>

A Matcher for values provided by CompletableFutures.

Copyright (c) 2016. All Rights Reserved. Oracle Corporation.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates.

Author:

Jonathan Knight

Constructor Summary

Constructors

Constructor and Description
FutureMatcher(org.hamcrest.Matcher<? super T> matcher) Constructs a FutureMatcher

Method Summary

Modifier and Type	Method and Description
void	describeTo(org.hamcrest.Description description)
static <T> org.hamcrest.Matcher<T>	futureOf(org.hamcrest.Matcher<T> matcher) Decorates another Matcher, retaining its behaviour, but allowing tests to be slightly more expressive.
static <T> org.hamcrest.Matcher<T>	futureOf(T value) A shortcut to the frequently used is(equalTo(x)).
protected boolean	matchesSafely(CompletableFuture<? super T> item, org.hamcrest.Description mismatchDescription)

Methods inherited from class org.hamcrest.TypeSafeDiagnosingMatcher

describeMismatch, matches

Methods inherited from class org.hamcrest.BaseMatcher

_dont_implement_Matcher___instead_extend_BaseMatcher_, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

FutureMatcher

public FutureMatcher(org.hamcrest.Matcher<? super T> matcher)

Constructs a FutureMatcher

Parameters:

matcher - the Matcher of a future value

Method Detail

matchesSafely

protected boolean matchesSafely(CompletableFuture<? super T> item,
                                org.hamcrest.Description mismatchDescription)

Specified by:

matchesSafely in class org.hamcrest.TypeSafeDiagnosingMatcher<CompletableFuture<? super T>>

describeTo

public void describeTo(org.hamcrest.Description description)

futureOf

public static <T> org.hamcrest.Matcher<T> futureOf(org.hamcrest.Matcher<T> matcher)

Decorates another Matcher, retaining its behaviour, but allowing tests to be slightly more expressive.

For example:

assertThat(cheese, is(equalTo(smelly)))

instead of:

assertThat(cheese, equalTo(smelly))

Type Parameters:

T - the type of the value

Parameters:

matcher - the value Matcher

Returns:

the Matcher

futureOf

public static <T> org.hamcrest.Matcher<T> futureOf(T value)

A shortcut to the frequently used is(equalTo(x)).

For example:

assertThat(cheese, is(smelly))

instead of:

assertThat(cheese, is(equalTo(smelly)))

Type Parameters:

T - the type of the value

Parameters:

value - the value

Returns:

the Matcher