com.oracle.bedrock.matchers

Class RecordingMatcher<T>

java.lang.Object

org.hamcrest.BaseMatcher<T>

com.oracle.bedrock.matchers.RecordingMatcher<T>

Type Parameters:

T - the type of value being matched

All Implemented Interfaces:

org.hamcrest.Matcher<T>, org.hamcrest.SelfDescribing

public class RecordingMatcher<T>
extends org.hamcrest.BaseMatcher<T>

A Matcher that can be used to record the success and failures of another Matcher.

Typically this class is used for testing interaction with other Matchers.

Copyright (c) 2016. 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
RecordingMatcher(org.hamcrest.Matcher<? super T> matcher) Constructs a RecordingMatcher.

Method Summary

Modifier and Type	Method and Description
boolean	attempted() Determines if a match has been attempted with the Matcher.
void	describeTo(org.hamcrest.Description description)
int	getAttemptCount() Obtains the number of match attempts.
int	getFailureCount() Obtains the current number of failed matches.
int	getSuccessCount() Obtain the current number of successful matches.
boolean	hasFailed() Determines if one or more failures to match the Matcher has occurred.
boolean	hasSucceeded() Determines if one or more successful matches with the Matcher has occurred.
boolean	matches(Object o)
static <T> RecordingMatcher<T>	of(org.hamcrest.Matcher<? super T> matcher) Obtains a RecordingMatcher for a specified Matcher.

Methods inherited from class org.hamcrest.BaseMatcher

_dont_implement_Matcher___instead_extend_BaseMatcher_, describeMismatch, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

RecordingMatcher

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

Constructs a RecordingMatcher.

Parameters:

matcher - the Matcher being recorded

Method Detail

of

public static <T> RecordingMatcher<T> of(org.hamcrest.Matcher<? super T> matcher)

Obtains a RecordingMatcher for a specified Matcher.

Type Parameters:

T - the type of values being matched

Parameters:

matcher - the Matcher

Returns:

a RecordingMatcher

getSuccessCount

public int getSuccessCount()

Obtain the current number of successful matches.

Returns:

the successful match count

hasSucceeded

public boolean hasSucceeded()

Determines if one or more successful matches with the Matcher has occurred.

Returns:

true when one or more successful matches has occurred false otherwise

getFailureCount

public int getFailureCount()

Obtains the current number of failed matches.

Returns:

the failed match count

hasFailed

public boolean hasFailed()

Determines if one or more failures to match the Matcher has occurred.

Returns:

true when one or more failures have occurred false otherwise

getAttemptCount

public int getAttemptCount()

Obtains the number of match attempts.

Returns:

the match attempt count

attempted

public boolean attempted()

Determines if a match has been attempted with the Matcher.

Returns:

true when a match has been attempted, false otherwise

matches

public boolean matches(Object o)

describeTo

public void describeTo(org.hamcrest.Description description)