Interface Stubber

  • All Known Implementing Classes:
    StubberImpl

    public interface Stubber
    Allows to choose a method when stubbing in doThrow()|doAnswer()|doNothing()|doReturn() style

    Example:

    
       doThrow(new RuntimeException()).when(mockedList).clear();
       
       //following throws RuntimeException:
       mockedList.clear();
     
    Also useful when stubbing consecutive calls:
    
       doThrow(new RuntimeException("one")).
       doThrow(new RuntimeException("two"))
       .when(mock).someVoidMethod();
     
    Read more about those methods:

    Mockito.doThrow(Throwable)

    Mockito.doAnswer(Answer)

    Mockito.doNothing()

    Mockito.doReturn(Object)

    See examples in javadoc for Mockito

    • Method Detail

      • doThrow

        Stubber doThrow​(java.lang.Throwable toBeThrown)
        Use it for stubbing consecutive calls in Mockito.doThrow(Throwable) style:
        
           doThrow(new RuntimeException("one")).
           doThrow(new RuntimeException("two"))
           .when(mock).someVoidMethod();
         
        See javadoc for Mockito.doThrow(Throwable)
        Parameters:
        toBeThrown - to be thrown when the stubbed method is called
        Returns:
        stubber - to select a method for stubbing
      • doThrow

        Stubber doThrow​(java.lang.Class<? extends java.lang.Throwable> toBeThrown)
        Use it for stubbing consecutive calls in Mockito.doThrow(Class) style:
        
           doThrow(RuntimeException.class).
           doThrow(IllegalArgumentException.class)
           .when(mock).someVoidMethod();
         
        See javadoc for Mockito.doThrow(Class)
        Parameters:
        toBeThrown - exception class to be thrown when the stubbed method is called
        Returns:
        stubber - to select a method for stubbing
      • doAnswer

        Stubber doAnswer​(Answer answer)
        Use it for stubbing consecutive calls in Mockito.doAnswer(Answer) style:
        
           doAnswer(answerOne).
           doAnswer(answerTwo)
           .when(mock).someVoidMethod();
         
        See javadoc for Mockito.doAnswer(Answer)
        Parameters:
        answer - to answer when the stubbed method is called
        Returns:
        stubber - to select a method for stubbing
      • doNothing

        Stubber doNothing()
        Use it for stubbing consecutive calls in Mockito.doNothing() style:
        
           doNothing().
           doThrow(new RuntimeException("two"))
           .when(mock).someVoidMethod();
         
        See javadoc for Mockito.doNothing()
        Returns:
        stubber - to select a method for stubbing
      • doReturn

        Stubber doReturn​(java.lang.Object toBeReturned)
        Use it for stubbing consecutive calls in Mockito.doReturn(Object) style.

        See javadoc for Mockito.doReturn(Object)

        Parameters:
        toBeReturned - to be returned when the stubbed method is called
        Returns:
        stubber - to select a method for stubbing