com.oracle.bedrock.deferred

Class DeferredMatch<T>

java.lang.Object

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

All Implemented Interfaces:

com.oracle.bedrock.deferred.Deferred<Boolean>

public class DeferredMatch<T>
extends Object
implements com.oracle.bedrock.deferred.Deferred<Boolean>

A DeferredMatch is a Deferred that represents a Hamcrest Matcher, that of which must be satisfied for a specified Deferred object at some point in the future.

A DeferredMatch will only return true when the match is successful, otherwise null will be returned.

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

Author:

Brian Oliver

Constructor Summary

Constructors

Constructor and Description
DeferredMatch(com.oracle.bedrock.deferred.Deferred<T> deferred, org.hamcrest.Matcher<? super T> matcher) Constructs a DeferredMatch for the Deferred with the specified Matcher.

Method Summary

Modifier and Type	Method and Description
Boolean	get()
com.oracle.bedrock.deferred.Deferred<T>	getDeferred() Obtains the adapted Deferred.
Class<Boolean>	getDeferredClass()
T	getLastUsedMatchValue() Obtains the value used when attempting to perform a match.
org.hamcrest.Matcher<? super T>	getMatcher() Obtains the Matcher to apply.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

DeferredMatch

public DeferredMatch(com.oracle.bedrock.deferred.Deferred<T> deferred,
                     org.hamcrest.Matcher<? super T> matcher)

Constructs a DeferredMatch for the Deferred with the specified Matcher.

Parameters:

deferred - the Deferred to match against

matcher - the Matcher

Method Detail

getDeferred

public com.oracle.bedrock.deferred.Deferred<T> getDeferred()

Obtains the adapted Deferred.

Returns:

the adapted Deferred

getMatcher

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

Obtains the Matcher to apply.

Returns:

the Matcher

getLastUsedMatchValue

public T getLastUsedMatchValue()

Obtains the value used when attempting to perform a match. This is useful for determining why a match may have failed.

Returns:

the last value (obtained from getDeferred()) that was used for matching

get

public Boolean get()
            throws com.oracle.bedrock.deferred.TemporarilyUnavailableException,
                   com.oracle.bedrock.deferred.PermanentlyUnavailableException

Specified by:

get in interface com.oracle.bedrock.deferred.Deferred<Boolean>

Throws:

com.oracle.bedrock.deferred.TemporarilyUnavailableException

com.oracle.bedrock.deferred.PermanentlyUnavailableException

getDeferredClass

public Class<Boolean> getDeferredClass()

Specified by:

getDeferredClass in interface com.oracle.bedrock.deferred.Deferred<Boolean>

toString

public String toString()

Overrides:

toString in class Object