Package org.mockito

Interface InOrder

public interface InOrder
Allows verification in order. E.g: 

 // Given
 First firstMock = mock(First.class);
 Second secondMock = mock(Second.class);
 InOrder inOrder = inOrder(firstMock, secondMock);

 // When
 firstMock.add("was called first");
 secondMock.add("was called second");

 // Then
 inOrder.verify(firstMock).add("was called first");
 inOrder.verify(secondMock).add("was called second");
 inOrder.verifyNoMoreInteractions();
Static mocks can be verified alongside non-static mocks. E.g: 

 // Given
 First firstMock = mock(First.class);
 MockedStatic staticSecondMock = mockStatic(StaticSecond.class);
 InOrder inOrder = inOrder(firstMock, StaticSecond.class);

 // When
 firstMock.add("was called first");
 StaticSecond.doSomething("foobar");

 // Then
 inOrder.verify(firstMock).add("was called first");
 inOrder.verify(staticSecondMock, () -> StaticSecond.doSomething("foobar"));
 inOrder.verifyNoMoreInteractions();
As of Mockito 1.8.4 you can verifyNoMoreInteractions() in order-sensitive way. Read more: verifyNoMoreInteractions().

See examples in javadoc for Mockito class

  • Method Details

    • verify

      <T> T verify(T mock)
      Verifies interaction happened once in order.

      Alias to inOrder.verify(mock, times(1))

      Example: 

      
 InOrder inOrder = inOrder(firstMock, secondMock);

 inOrder.verify(firstMock).someMethod("was called first");
 inOrder.verify(secondMock).someMethod("was called second");
      See examples in javadoc for Mockito class
      Parameters:
      mock - to be verified
      Returns:
      mock object itself

    • verify

      <T> T verify(T mock, VerificationMode mode)
      Verifies interaction in order. E.g: 
      
 InOrder inOrder = inOrder(firstMock, secondMock);

 inOrder.verify(firstMock, times(2)).someMethod("was called first two times");
 inOrder.verify(secondMock, atLeastOnce()).someMethod("was called second at least once");
      See examples in javadoc for Mockito class
      Parameters:
      mock - to be verified
      mode - for example times(x) or atLeastOnce()
      Returns:
      mock object itself

    • verify

      default void verify(MockedStatic<?> mockedStatic, MockedStatic.Verification verification)
      Verifies static interaction in order, with exactly one number of invocations.
      See Also:

    • verify

      void verify(MockedStatic<?> mockedStatic, MockedStatic.Verification verification, VerificationMode mode)
      Verifies static interaction in order. E.g: 
      
 try (MockedStatic mocked = mockStatic(Foo.class)) {
   InOrder inOrder = inOrder(Foo.class);

   mocked.when(Foo::firstMethod).thenReturn("first");
   mocked.when(Foo::secondMethod).thenReturn("second");

   assertEquals("first", Foo.firstMethod());
   assertEquals("second", Foo.secondMethod());

   inOrder.verify(mocked, Foo::firstMethod, times(1));
   inOrder.verify(mocked, Foo::secondMethod, atLeastOnce());
 }
      Parameters:
      mockedStatic - static mock to be verified
      verification - verification to be verified
      mode - for example times(x) or atLeastOnce()

    • verifyNoMoreInteractions

      void verifyNoMoreInteractions()
      Verifies that no more interactions happened in order. Different from Mockito.verifyNoMoreInteractions(Object...) because the order of verification matters.

      Example: 

      
 mock.foo(); //1st
 mock.bar(); //2nd
 mock.baz(); //3rd

 InOrder inOrder = inOrder(mock);

 inOrder.verify(mock).bar(); //2n
 inOrder.verify(mock).baz(); //3rd (last method)

 //passes because there are no more interactions after last method:
 inOrder.verifyNoMoreInteractions();

 //however this fails because 1st method was not verified:
 Mockito.verifyNoMoreInteractions(mock);