Package org.mockito.internal.stubbing

Class StubberImpl

java.lang.Object

org.mockito.internal.stubbing.StubberImpl

All Implemented Interfaces:

BaseStubber, Stubber

public class StubberImpl
extends java.lang.Object
implements Stubber

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.List<Answer<?>>	answers
private Strictness	strictness

Constructor Summary

Constructors

Constructor	Description
StubberImpl(Strictness strictness)

Method Summary

Modifier and Type	Method	Description
Stubber	doAnswer(Answer answer)	Use it for stubbing consecutive calls in Mockito.doAnswer(Answer) style:
Stubber	doCallRealMethod()	Use it for stubbing consecutive calls in Mockito.doCallRealMethod() style.
Stubber	doNothing()	Use it for stubbing consecutive calls in Mockito.doNothing() style:
Stubber	doReturn(java.lang.Object toBeReturned)	Use it for stubbing consecutive calls in Mockito.doReturn(Object) style.
Stubber	doReturn(java.lang.Object toBeReturned, java.lang.Object... nextToBeReturned)	Use it for stubbing consecutive calls in Mockito.doReturn(Object) style.
private StubberImpl	doReturnValues(java.lang.Object... toBeReturned)
Stubber	doThrow(java.lang.Class<? extends java.lang.Throwable> toBeThrown)	Use it for stubbing consecutive calls in Mockito.doThrow(Class) style:
Stubber	doThrow(java.lang.Class<? extends java.lang.Throwable> toBeThrown, java.lang.Class<? extends java.lang.Throwable>... nextToBeThrown)	Use it for stubbing consecutive calls in Mockito.doThrow(Class) style:
Stubber	doThrow(java.lang.Throwable... toBeThrown)	Use it for stubbing consecutive calls in Mockito.doThrow(Throwable[]) style:
<T> T	when(T mock)	Allows to choose a method when stubbing in doThrow()|doAnswer()|doNothing()|doReturn() style

Methods inherited from class java.lang.Object

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

Field Detail

strictness

private final Strictness strictness

answers

private final java.util.List<Answer<?>> answers

Constructor Detail

StubberImpl

public StubberImpl(Strictness strictness)

Method Detail

when

public <T> T when(T mock)

Description copied from 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();
 

Read more about those methods:

Mockito.doThrow(Throwable[])

Mockito.doAnswer(Answer)

Mockito.doNothing()

Mockito.doReturn(Object)

See examples in javadoc for Mockito

Specified by:

when in interface Stubber

Parameters:

mock - The mock

Returns:

select method for stubbing

doReturn

public Stubber doReturn(java.lang.Object toBeReturned)

Description copied from interface: BaseStubber

Use it for stubbing consecutive calls in Mockito.doReturn(Object) style.

See javadoc for Mockito.doReturn(Object)

Specified by:

doReturn in interface BaseStubber

Parameters:

toBeReturned - to be returned when the stubbed method is called

Returns:

stubber - to select a method for stubbing

doReturn

public Stubber doReturn(java.lang.Object toBeReturned,
                        java.lang.Object... nextToBeReturned)

Description copied from interface: BaseStubber

Use it for stubbing consecutive calls in Mockito.doReturn(Object) style.

See javadoc for Mockito.doReturn(Object, Object...)

Specified by:

doReturn in interface BaseStubber

Parameters:

toBeReturned - to be returned when the stubbed method is called

nextToBeReturned - to be returned in consecutive calls when the stubbed method is called

Returns:

stubber - to select a method for stubbing

doReturnValues

private StubberImpl doReturnValues(java.lang.Object... toBeReturned)

doThrow

public Stubber doThrow(java.lang.Throwable... toBeThrown)

Description copied from interface: BaseStubber

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[])

Specified by:

doThrow in interface BaseStubber

Parameters:

toBeThrown - to be thrown when the stubbed method is called

Returns:

stubber - to select a method for stubbing

doThrow

public Stubber doThrow(java.lang.Class<? extends java.lang.Throwable> toBeThrown)

Description copied from interface: BaseStubber

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)

Specified by:

doThrow in interface BaseStubber

Parameters:

toBeThrown - exception class to be thrown when the stubbed method is called

Returns:

stubber - to select a method for stubbing

doThrow

public Stubber doThrow(java.lang.Class<? extends java.lang.Throwable> toBeThrown,
                       java.lang.Class<? extends java.lang.Throwable>... nextToBeThrown)

Description copied from interface: BaseStubber

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)

Specified by:

doThrow in interface BaseStubber

Parameters:

toBeThrown - exception class to be thrown when the stubbed method is called

nextToBeThrown - exception class next to be thrown when the stubbed method is called

Returns:

stubber - to select a method for stubbing

doNothing

public Stubber doNothing()

Description copied from interface: BaseStubber

Use it for stubbing consecutive calls in Mockito.doNothing() style:

   doNothing().
   doThrow(new RuntimeException("two"))
       .when(mock).someVoidMethod();
 

See javadoc for Mockito.doNothing()

Specified by:

doNothing in interface BaseStubber

Returns:

stubber - to select a method for stubbing

doAnswer

public Stubber doAnswer(Answer answer)

Description copied from interface: BaseStubber

Use it for stubbing consecutive calls in Mockito.doAnswer(Answer) style:

   doAnswer(answerOne).
   doAnswer(answerTwo)
       .when(mock).someVoidMethod();
 

See javadoc for Mockito.doAnswer(Answer)

Specified by:

doAnswer in interface BaseStubber

Parameters:

answer - to answer when the stubbed method is called

Returns:

stubber - to select a method for stubbing

doCallRealMethod

public Stubber doCallRealMethod()

Description copied from interface: BaseStubber

Use it for stubbing consecutive calls in Mockito.doCallRealMethod() style.

See javadoc for Mockito.doCallRealMethod()

Specified by:

doCallRealMethod in interface BaseStubber

Returns:

stubber - to select a method for stubbing