org.axonframework.test.matchers
Class SequenceMatcher

java.lang.Object
  extended by org.hamcrest.BaseMatcher<List<?>>
      extended by org.axonframework.test.matchers.ListMatcher
          extended by org.axonframework.test.matchers.SequenceMatcher
All Implemented Interfaces:
org.hamcrest.Matcher<List<?>>, org.hamcrest.SelfDescribing

public class SequenceMatcher
extends ListMatcher

A matcher that will match if all the given matchers each match against an item that the previous matcher matched against. That means the second matcher should match an item that follow the item that the first matcher matched.

If the number of items is larger than the number of matchers, the excess items are not evaluated. Use Matchers.exactSequenceOf(org.hamcrest.Matcher[]) to match the sequence exactly. If the last item of the list has been evaluated, and Matchers still remain, they are evaluated against a null value.

Since:
1.1
Author:
Allard Buijze

Constructor Summary
SequenceMatcher(org.hamcrest.Matcher<?>... matchers)
          Construct a matcher that will return true if all the given matchers match against an item positioned after the item that the previous matcher matched against.
 
Method Summary
protected  void describeCollectionType(org.hamcrest.Description description)
          Describes the type of collection expected.
 boolean matchesList(List<?> items)
          Evaluates the matcher for argument item.
 
Methods inherited from class org.axonframework.test.matchers.ListMatcher
describeTo, failedMatcherMessage, getLastSeparator, getMatchers, matches, matchRemainder, reportFailed
 
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

SequenceMatcher

public SequenceMatcher(org.hamcrest.Matcher<?>... matchers)
Construct a matcher that will return true if all the given matchers match against an item positioned after the item that the previous matcher matched against.

Parameters:
matchers - The matchers that must match against at least one item in the list.
Method Detail

matchesList

public boolean matchesList(List<?> items)
Description copied from class: ListMatcher
Evaluates the matcher for argument item. The item has been verified to be a list, but the exact type of contents of a list cannot be verified, due to Erasure of Generic Types.

Specified by:
matchesList in class ListMatcher
Parameters:
items - the object against which the matcher is evaluated.
Returns:
true if item matches, otherwise false.
See Also:
BaseMatcher

describeCollectionType

protected void describeCollectionType(org.hamcrest.Description description)
Description copied from class: ListMatcher
Describes the type of collection expected. To be used in the sentence: "list with ... of: ". E.g. "all" or "sequence".

Specified by:
describeCollectionType in class ListMatcher
Parameters:
description - the description to append the collection type to


Copyright © 2010-2016. All Rights Reserved.