Матчер Мокито vs Матчер Хамкреста?

Методы сопоставления Hamcrest возвращают Matcher<T>, а сопоставители Mockito возвращают T. Так, например: org.hamcrest.Matchers.any(Integer.class) возвращает экземпляр org.hamcrest.Matcher<Integer>, а org.mockito.Matchers.any(Integer.class) возвращает экземпляр Integer.

Это означает, что вы можете использовать сопоставители Hamcrest только тогда, когда в подписи ожидается объект Matcher<?> - обычно в assertThat вызовах. При настройке ожиданий или проверок, когда вы вызываете методы фиктивного объекта, вы используете сопоставители Mockito.

Например (с полными именами для ясности):

@Test
public void testGetDelegatedBarByIndex() {
    Foo mockFoo = mock(Foo.class);
    // inject our mock
    objectUnderTest.setFoo(mockFoo);
    Bar mockBar = mock(Bar.class);
    when(mockFoo.getBarByIndex(org.mockito.Matchers.any(Integer.class))).
        thenReturn(mockBar);

    Bar actualBar = objectUnderTest.getDelegatedBarByIndex(1);

    assertThat(actualBar, org.hamcrest.Matchers.any(Bar.class));
    verify(mockFoo).getBarByIndex(org.mockito.Matchers.any(Integer.class));
}

Если вы хотите использовать сопоставитель Hamcrest в контексте, который требует сопоставления Mockito, вы можете использовать сопоставитель org.mockito.Matchers.argThat. Он преобразует сопоставитель Hamcrest в сопоставитель Mockito. Итак, предположим, вы хотите сопоставить двойное значение с некоторой точностью (но не очень). В этом случае вы можете:

when(mockFoo.getBarByDouble(argThat(is(closeTo(1.0, 0.001))))).
    thenReturn(mockBar);