org.easymock.internal
Class MocksControl

java.lang.Object
  org.easymock.internal.MocksControl

All Implemented Interfaces:

java.io.Serializable, IExpectationSetters<java.lang.Object>, IMocksControl

public class MocksControl
extends java.lang.Object
implements IMocksControl, IExpectationSetters<java.lang.Object>, java.io.Serializable

See Also:

Serialized Form

Nested Class Summary

static class

MocksControl.MockType

Field Summary

static Range	AT_LEAST_ONCE One or more calls.
static Range	ONCE Exactly one call.
static Range	ZERO_OR_MORE Zero or more calls.

Constructor Summary

MocksControl(MocksControl.MockType type)

Method Summary

IExpectationSetters<java.lang.Object>	andAnswer(IAnswer<? extends java.lang.Object> answer) Sets an object that will be used to calculate the answer for the expected invocation (either return a value, or throw an exception).
IExpectationSetters<java.lang.Object>	andReturn(java.lang.Object value) Sets a return value that will be returned for the expected invocation.
void	andStubAnswer(IAnswer<? extends java.lang.Object> answer) Sets a stub object that will be used to calculate the answer for the expected invocation (either return a value, or throw an exception).
void	andStubReturn(java.lang.Object value) Sets a stub return value that will be returned for the expected invocation.
void	andStubThrow(java.lang.Throwable throwable) Sets a stub throwable that will be thrown for the expected invocation.
IExpectationSetters<java.lang.Object>	andThrow(java.lang.Throwable throwable) Sets a throwable that will be thrown for the expected invocation.
IExpectationSetters<java.lang.Object>	anyTimes() Expect the last invocation any times.
void	asStub() Sets stub behavior for the expected invocation (this is needed for void methods).
IExpectationSetters<java.lang.Object>	atLeastOnce() Expect the last invocation at least once.
void	checkOrder(boolean value) Switches order checking on and off.
<T> T	createMock(java.lang.Class<T> toMock) Creates a mock object that implements the given interface.
<T> T	createMock(java.lang.String name, java.lang.Class<T> toMock) Creates a mock object that implements the given interface.
protected <T> IProxyFactory<T>	createProxyFactory(java.lang.Class<T> toMock)
IMocksControlState	getState()
void	makeThreadSafe(boolean threadSafe) Makes the mock thread safe.
IExpectationSetters<java.lang.Object>	once() Expect the last invocation once.
void	replay() Switches the control from record mode to replay mode.
void	reset() Removes all expectations for the mock objects of this control.
void	resetToDefault() Removes all expectations for the mock objects of this control and turn them to default mocks.
void	resetToNice() Removes all expectations for the mock objects of this control and turn them to nice mocks.
void	resetToStrict() Removes all expectations for the mock objects of this control and turn them to strict mocks.
void	setLegacyDefaultMatcher(ArgumentsMatcher matcher)
void	setLegacyDefaultReturnValue(java.lang.Object value)
void	setLegacyDefaultThrowable(java.lang.Throwable throwable)
void	setLegacyDefaultVoidCallable()
void	setLegacyMatcher(ArgumentsMatcher matcher)
IExpectationSetters<java.lang.Object>	times(int times) Expect the last invocation count times.
IExpectationSetters<java.lang.Object>	times(int min, int max) Expect the last invocation between min and max times.
void	verify() Verifies that all expectations were met.

Methods inherited from class java.lang.Object

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

Field Detail

ONCE

public static final Range ONCE

Exactly one call.

AT_LEAST_ONCE

public static final Range AT_LEAST_ONCE

One or more calls.

ZERO_OR_MORE

public static final Range ZERO_OR_MORE

Zero or more calls.

Constructor Detail

MocksControl

public MocksControl(MocksControl.MockType type)

Method Detail

getState

public IMocksControlState getState()

createMock

public <T> T createMock(java.lang.Class<T> toMock)

Description copied from interface: IMocksControl

Creates a mock object that implements the given interface.

Specified by:

createMock in interface IMocksControl

Type Parameters:

T - the interface that the mock object should implement.

Parameters:

toMock - the class of the interface that the mock object should implement.

Returns:

the mock object.

createMock

public <T> T createMock(java.lang.String name,
                        java.lang.Class<T> toMock)

Description copied from interface: IMocksControl

Creates a mock object that implements the given interface.

Specified by:

createMock in interface IMocksControl

Type Parameters:

T - the interface that the mock object should implement.

Parameters:

name - the name of the mock object .

toMock - the class of the interface that the mock object should implement.

Returns:

the mock object.

createProxyFactory

protected <T> IProxyFactory<T> createProxyFactory(java.lang.Class<T> toMock)

reset

public final void reset()

Description copied from interface: IMocksControl

Removes all expectations for the mock objects of this control.

Specified by:

reset in interface IMocksControl

resetToNice

public void resetToNice()

Description copied from interface: IMocksControl

Removes all expectations for the mock objects of this control and turn them to nice mocks.

Specified by:

resetToNice in interface IMocksControl

resetToDefault

public void resetToDefault()

Description copied from interface: IMocksControl

Removes all expectations for the mock objects of this control and turn them to default mocks.

Specified by:

resetToDefault in interface IMocksControl

resetToStrict

public void resetToStrict()

Description copied from interface: IMocksControl

Removes all expectations for the mock objects of this control and turn them to strict mocks.

Specified by:

resetToStrict in interface IMocksControl

replay

public void replay()

Description copied from interface: IMocksControl

Switches the control from record mode to replay mode.

Specified by:

replay in interface IMocksControl

verify

public void verify()

Description copied from interface: IMocksControl

Verifies that all expectations were met.

Specified by:

verify in interface IMocksControl

checkOrder

public void checkOrder(boolean value)

Description copied from interface: IMocksControl

Switches order checking on and off.

Specified by:

checkOrder in interface IMocksControl

Parameters:

value - true switches order checking on, false switches it off.

makeThreadSafe

public void makeThreadSafe(boolean threadSafe)

Description copied from interface: IMocksControl

Makes the mock thread safe.

Specified by:

makeThreadSafe in interface IMocksControl

Parameters:

threadSafe - If the mock should be thread safe or not

andReturn

public IExpectationSetters<java.lang.Object> andReturn(java.lang.Object value)

Description copied from interface: IExpectationSetters

Sets a return value that will be returned for the expected invocation.

Specified by:

andReturn in interface IExpectationSetters<java.lang.Object>

Parameters:

value - the value to return.

Returns:

this object to allow method call chaining.

andThrow

public IExpectationSetters<java.lang.Object> andThrow(java.lang.Throwable throwable)

Description copied from interface: IExpectationSetters

Sets a throwable that will be thrown for the expected invocation.

Specified by:

andThrow in interface IExpectationSetters<java.lang.Object>

Parameters:

throwable - the throwable to throw.

Returns:

this object to allow method call chaining.

andAnswer

public IExpectationSetters<java.lang.Object> andAnswer(IAnswer<? extends java.lang.Object> answer)

Description copied from interface: IExpectationSetters

Sets an object that will be used to calculate the answer for the expected invocation (either return a value, or throw an exception).

Specified by:

andAnswer in interface IExpectationSetters<java.lang.Object>

Parameters:

answer - the object used to answer the invocation.

Returns:

this object to allow method call chaining.

andStubReturn

public void andStubReturn(java.lang.Object value)

Description copied from interface: IExpectationSetters

Sets a stub return value that will be returned for the expected invocation.

Specified by:

andStubReturn in interface IExpectationSetters<java.lang.Object>

Parameters:

value - the value to return.

andStubThrow

public void andStubThrow(java.lang.Throwable throwable)

Description copied from interface: IExpectationSetters

Sets a stub throwable that will be thrown for the expected invocation.

Specified by:

andStubThrow in interface IExpectationSetters<java.lang.Object>

Parameters:

throwable - the throwable to throw.

andStubAnswer

public void andStubAnswer(IAnswer<? extends java.lang.Object> answer)

Description copied from interface: IExpectationSetters

Sets a stub object that will be used to calculate the answer for the expected invocation (either return a value, or throw an exception).

Specified by:

andStubAnswer in interface IExpectationSetters<java.lang.Object>

Parameters:

answer - the object used to answer the invocation.

asStub

public void asStub()

Description copied from interface: IExpectationSetters

Sets stub behavior for the expected invocation (this is needed for void methods).

Specified by:

asStub in interface IExpectationSetters<java.lang.Object>

times

public IExpectationSetters<java.lang.Object> times(int times)

Description copied from interface: IExpectationSetters

Expect the last invocation count times.

Specified by:

times in interface IExpectationSetters<java.lang.Object>

Parameters:

times - the number of invocations expected.

Returns:

this object to allow method call chaining.

times

public IExpectationSetters<java.lang.Object> times(int min,
                                                   int max)

Description copied from interface: IExpectationSetters

Expect the last invocation between min and max times.

Specified by:

times in interface IExpectationSetters<java.lang.Object>

Parameters:

min - the minimum number of invocations expected.

max - the maximum number of invocations expected.

Returns:

this object to allow method call chaining.

once

public IExpectationSetters<java.lang.Object> once()

Description copied from interface: IExpectationSetters

Expect the last invocation once. This is default in EasyMock.

Specified by:

once in interface IExpectationSetters<java.lang.Object>

Returns:

this object to allow method call chaining.

atLeastOnce

public IExpectationSetters<java.lang.Object> atLeastOnce()

Description copied from interface: IExpectationSetters

Expect the last invocation at least once.

Specified by:

atLeastOnce in interface IExpectationSetters<java.lang.Object>

Returns:

this object to allow method call chaining.

anyTimes

public IExpectationSetters<java.lang.Object> anyTimes()

Description copied from interface: IExpectationSetters

Expect the last invocation any times.

Specified by:

anyTimes in interface IExpectationSetters<java.lang.Object>

Returns:

this object to allow method call chaining.

setLegacyDefaultMatcher

public void setLegacyDefaultMatcher(ArgumentsMatcher matcher)

setLegacyMatcher

public void setLegacyMatcher(ArgumentsMatcher matcher)

setLegacyDefaultReturnValue

public void setLegacyDefaultReturnValue(java.lang.Object value)

setLegacyDefaultVoidCallable

public void setLegacyDefaultVoidCallable()

setLegacyDefaultThrowable

public void setLegacyDefaultThrowable(java.lang.Throwable throwable)