org.mockito.hamcrest

Class MockitoHamcrest

java.lang.Object

org.mockito.hamcrest.MockitoHamcrest

public class MockitoHamcrest
extends Object

Allows matching arguments with hamcrest matchers. Requires hamcrest on classpath, Mockito does not depend on hamcrest!

Before implementing or reusing an existing hamcrest matcher please read how to deal with sophisticated argument matching in ArgumentMatcher.

Mockito 2.0 was decoupled from Hamcrest to avoid version incompatibilities that have impacted our users in past. Mockito offers a dedicated API to match arguments via ArgumentMatcher. Hamcrest integration is provided so that users can take advantage of existing Hamcrest matchers. Example:

     import static org.mockito.hamcrest.MockitoHamcrest.argThat;

     //stubbing
     when(mock.giveMe(argThat(new MyHamcrestMatcher())));

     //verification
     verify(mock).giveMe(argThat(new MyHamcrestMatcher()));
 

Since:

2.0

Constructor Summary

Constructors

Constructor and Description
MockitoHamcrest()

Method Summary

Methods

Modifier and Type	Method and Description
static <T> T	argThat(org.hamcrest.Matcher<T> matcher) Allows matching arguments with hamcrest matchers.

Methods inherited from class java.lang.Object

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

Constructor Detail

MockitoHamcrest

public MockitoHamcrest()

Method Detail

argThat

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

Allows matching arguments with hamcrest matchers.

See examples in javadoc for MockitoHamcrest class

Parameters:

matcher - decides whether argument matches

Returns:

null or default value for primitive (0, false, etc.)

Since:

2.0