org.powermock.api.mockito.internal.mockmaker

Class PowerMockMaker

java.lang.Object

org.powermock.api.mockito.internal.mockmaker.PowerMockMaker

All Implemented Interfaces:

org.mockito.plugins.MockMaker

public class PowerMockMaker
extends java.lang.Object
implements org.mockito.plugins.MockMaker

A PowerMock implementation of the MockMaker. Right now it simply delegates to the default Mockito MockMaker via Plugins.getMockMaker() but in the future we may use it more properly. The reason for its existence is that the current Mockito MockMaker throws exception when getting the name from of a mock that is created by PowerMock but not know for Mockito. This is triggered when by the MockUtil class. For more details see the ToStringGenerator.

Constructor Summary

Constructors

Constructor and Description
PowerMockMaker()

Method Summary

Modifier and Type	Method and Description
<T> T	createMock(org.mockito.mock.MockCreationSettings<T> settings, org.mockito.invocation.MockHandler handler) If you want to provide your own implementation of MockMaker this method should: Create a proxy object that implements settings.typeToMock and potentially also settings.extraInterfaces. You may use the information from settings to create/configure your proxy object. Your proxy object should carry the handler with it.
org.mockito.invocation.MockHandler	getHandler(java.lang.Object mock) Returns the handler for the mock.
void	resetMock(java.lang.Object mock, org.mockito.invocation.MockHandler newHandler, org.mockito.mock.MockCreationSettings settings) Replaces the existing handler on mock with newHandler.

Methods inherited from class java.lang.Object

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

Constructor Detail

PowerMockMaker

public PowerMockMaker()

Method Detail

createMock

public <T> T createMock(org.mockito.mock.MockCreationSettings<T> settings,
                        org.mockito.invocation.MockHandler handler)

Description copied from interface: org.mockito.plugins.MockMaker

If you want to provide your own implementation of MockMaker this method should:

• Create a proxy object that implements settings.typeToMock and potentially also settings.extraInterfaces.
• You may use the information from settings to create/configure your proxy object.
• Your proxy object should carry the handler with it. For example, if you generate byte code to create the proxy you could generate an extra field to keep the handler with the generated object. Your implementation of MockMaker is required to provide this instance of handler when MockMaker.getHandler(Object) is called.

Specified by:

createMock in interface org.mockito.plugins.MockMaker

Type Parameters:

T - Type of the mock to return, actually the settings.getTypeToMock.

Parameters:

settings - - mock creation settings like type to mock, extra interfaces and so on.

handler - See MockHandler. Do not provide your own implementation at this time. Make sure your implementation of MockMaker.getHandler(Object) will return this instance.

Returns:

The mock instance.

getHandler

public org.mockito.invocation.MockHandler getHandler(java.lang.Object mock)

Description copied from interface: org.mockito.plugins.MockMaker

Returns the handler for the mock. Do not provide your own implementations at this time because the work on the MockHandler api is not completed. Use the instance provided to you by Mockito at MockMaker.createMock(org.mockito.mock.MockCreationSettings<T>, org.mockito.invocation.MockHandler) or MockMaker.resetMock(java.lang.Object, org.mockito.invocation.MockHandler, org.mockito.mock.MockCreationSettings).

Specified by:

getHandler in interface org.mockito.plugins.MockMaker

Parameters:

mock - The mock instance.

Returns:

may return null - it means that there is no handler attached to provided object. This means the passed object is not really a Mockito mock.

resetMock

public void resetMock(java.lang.Object mock,
                      org.mockito.invocation.MockHandler newHandler,
                      org.mockito.mock.MockCreationSettings settings)

Description copied from interface: org.mockito.plugins.MockMaker

Replaces the existing handler on mock with newHandler.

The invocation handler actually store invocations to achieve stubbing and verification. In order to reset the mock, we pass a new instance of the invocation handler.

Your implementation should make sure the newHandler is correctly associated to passed mock

Specified by:

resetMock in interface org.mockito.plugins.MockMaker

Parameters:

mock - The mock instance whose invocation handler is to be replaced.

newHandler - The new invocation handler instance.

settings - The mock settings - should you need to access some of the mock creation details.