Package org.mockito.internal.stubbing.defaultanswers

Class ReturnsDeepStubs

java.lang.Object

org.mockito.internal.stubbing.defaultanswers.ReturnsDeepStubs

All Implemented Interfaces:

java.io.Serializable, Answer<java.lang.Object>

Direct Known Subclasses:

ReturnsDeepStubs.ReturnsDeepStubsSerializationFallback

public class ReturnsDeepStubs
extends java.lang.Object
implements Answer<java.lang.Object>, java.io.Serializable

Returning deep stub implementation.

Will return previously created mock if the invocation matches.

Supports nested generic information, with this answer you can write code like this :

     interface GenericsNest<K extends Comparable<K> & Cloneable> extends Map<K, Set<Number>> {}

     GenericsNest<?> mock = mock(GenericsNest.class, new ReturnsGenericDeepStubs());
     Number number = mock.entrySet().iterator().next().getValue().iterator().next();
 

However this answer does not support generics information when the mock has been deserialized.

See Also:

Mockito.RETURNS_DEEP_STUBS, Answers.RETURNS_DEEP_STUBS, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	ReturnsDeepStubs.DeeplyStubbedAnswer
private static class	ReturnsDeepStubs.LazyHolder
private static class	ReturnsDeepStubs.ReturnsDeepStubsSerializationFallback

Field Summary

Fields

Modifier and Type	Field	Description
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor	Description
ReturnsDeepStubs()

Method Summary

Modifier and Type	Method	Description
protected GenericMetadataSupport	actualParameterizedType(java.lang.Object mock)
java.lang.Object	answer(InvocationOnMock invocation)
private java.lang.Object	deepStub(InvocationOnMock invocation, GenericMetadataSupport returnTypeGenericMetadata)
private static ReturnsEmptyValues	delegate()
private static MockitoCore	mockitoCore()
private java.lang.Object	newDeepStubMock(GenericMetadataSupport returnTypeGenericMetadata, java.lang.Object parentMock)	Creates a mock using the Generics Metadata.
private MockSettings	propagateSerializationSettings(MockSettings mockSettings, MockCreationSettings parentMockSettings)
private StubbedInvocationMatcher	recordDeepStubAnswer(java.lang.Object mock, InvocationContainerImpl container)
private ReturnsDeepStubs	returnsDeepStubsAnswerUsing(GenericMetadataSupport returnTypeGenericMetadata)
private MockSettings	withSettingsUsing(GenericMetadataSupport returnTypeGenericMetadata, MockCreationSettings<?> parentMockSettings)

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

Constructor Detail

ReturnsDeepStubs

public ReturnsDeepStubs()

Method Detail

answer

public java.lang.Object answer(InvocationOnMock invocation)
                        throws java.lang.Throwable

Specified by:

answer in interface Answer<java.lang.Object>

Parameters:

invocation - the invocation on the mock.

Returns:

the value to be returned

Throws:

java.lang.Throwable - the throwable to be thrown

deepStub

private java.lang.Object deepStub(InvocationOnMock invocation,
                                  GenericMetadataSupport returnTypeGenericMetadata)
                           throws java.lang.Throwable

Throws:

java.lang.Throwable

newDeepStubMock

private java.lang.Object newDeepStubMock(GenericMetadataSupport returnTypeGenericMetadata,
                                         java.lang.Object parentMock)

Creates a mock using the Generics Metadata.

Finally as we want to mock the actual type, but we want to pass along the contextual generics meta-data that was resolved for the current return type, for this to happen we associate to the mock an new instance of ReturnsDeepStubs answer in which we will store the returned type generic metadata.

Parameters:

returnTypeGenericMetadata - The metadata to use to create the new mock.

parentMock - The parent of the current deep stub mock.

Returns:

The mock

withSettingsUsing

private MockSettings withSettingsUsing(GenericMetadataSupport returnTypeGenericMetadata,
                                       MockCreationSettings<?> parentMockSettings)

propagateSerializationSettings

private MockSettings propagateSerializationSettings(MockSettings mockSettings,
                                                    MockCreationSettings parentMockSettings)

returnsDeepStubsAnswerUsing

private ReturnsDeepStubs returnsDeepStubsAnswerUsing(GenericMetadataSupport returnTypeGenericMetadata)

recordDeepStubAnswer

private StubbedInvocationMatcher recordDeepStubAnswer(java.lang.Object mock,
                                                      InvocationContainerImpl container)

actualParameterizedType

protected GenericMetadataSupport actualParameterizedType(java.lang.Object mock)

mockitoCore

private static MockitoCore mockitoCore()

delegate

private static ReturnsEmptyValues delegate()