1. 概要

このクックブックは、さまざまな例とユースケースでMockitoを使用して動作を構成する方法を示しています。

クックブックの形式は、例に焦点を合わせたで実用的であり、余分な詳細や説明は必要ありません。

そしてもちろん、Mockitoを使ったテストについてもっと知りたい場合は、他のMockitoの記事をご覧ください。

単純なリストの実装をモックアップします。これは、前のクックブックで使用したのと同じ実装です。

public class MyList extends AbstractList<String> {

    @Override
    public String get(final int index) {
        return null;
    }
    @Override
    public int size() {
        return 1;
    }
}

2. クックブック

モックの単純な戻り動作を構成します。

MyList listMock = Mockito.mock(MyList.class);
when(listMock.add(anyString())).thenReturn(false);

boolean added = listMock.add(randomAlphabetic(6));
assertThat(added, is(false));

別の方法でモックの戻り動作を構成します。

MyList listMock = Mockito.mock(MyList.class);
doReturn(false).when(listMock).add(anyString());

boolean added = listMock.add(randomAlphabetic(6));
assertThat(added, is(false));

メソッド呼び出しで例外をスローするようにモックを構成します。

@Test(expected = IllegalStateException.class)
public void givenMethodIsConfiguredToThrowException_whenCallingMethod_thenExceptionIsThrown() {
    MyList listMock = Mockito.mock(MyList.class);
    when(listMock.add(anyString())).thenThrow(IllegalStateException.class);

    listMock.add(randomAlphabetic(6));
}

void return typeを使用してメソッドの動作を構成します—例外をスローするには:

MyList listMock = Mockito.mock(MyList.class);
doThrow(NullPointerException.class).when(listMock).clear();

listMock.clear();

複数の呼び出しの動作を構成します。

MyList listMock = Mockito.mock(MyList.class);
when(listMock.add(anyString()))
  .thenReturn(false)
  .thenThrow(IllegalStateException.class);

listMock.add(randomAlphabetic(6));
listMock.add(randomAlphabetic(6)); // will throw the exception

スパイの動作を構成します。

MyList instance = new MyList();
MyList spy = Mockito.spy(instance);

doThrow(NullPointerException.class).when(spy).size();
spy.size(); // will throw the exception

モックで実際の基礎となるメソッドを呼び出すようにメソッドを構成します。

MyList listMock = Mockito.mock(MyList.class);
when(listMock.size()).thenCallRealMethod();

assertThat(listMock.size(), equalTo(1));

カスタム回答を使用して模擬メソッド呼び出しを構成します。

MyList listMock = Mockito.mock(MyList.class);
doAnswer(invocation -> "Always the same").when(listMock).get(anyInt());

String element = listMock.get(1);
assertThat(element, is(equalTo("Always the same")));

3. 結論

このガイドの目的は、この情報をオンラインですぐに利用できるようにすることです。 GoogleGuavaHamcrestnowMockitoで同様の開発クックブックをいくつか公開しました。

これらすべての例とコードスニペットの実装は、GitHubにあります。 これはMavenベースのプロジェクトであるため、そのままインポートして実行するのは簡単です。