org.apache.tapestry5.ioc.test
Class TestBase

java.lang.Object
  extended by org.testng.Assert
      extended by org.apache.tapestry5.ioc.test.TestUtils
          extended by org.apache.tapestry5.ioc.test.TestBase
Direct Known Subclasses:
IOCTestCase

public class TestBase
extends TestUtils

Manages a set of EasyMock mock objects. Used as a base class for test cases.

Extends from Assert to bring in all the public static assert methods without requiring extra imports.

Provides a common mock factory method, newMock(Class). A single standard mock control is used for all mock objects. Standard mocks do not care about the exact order in which methods are invoked, though they are as rigorous as strict mocks when checking that parameters are the correct values.

This base class is created with the intention of use within a TestNG test suite; if using JUnit, you can get the same functionality using MockTester.

This class is thread safe (it uses a thread local to store the mock control). In theory, this should allow TestNG to execute tests in parallel.

This class was originally in the tapestry-ioc module as was moved to tapestry-test; the package name was not changed to ensure backwards compatibility.

See Also:
EasyMock.createControl(), MockTester

Constructor Summary
TestBase()
           
 
Method Summary
 void discardMockControl()
          Discards any mock objects created during the test.
protected static
<T> org.easymock.IExpectationSetters<T>
expect(T value)
          Convenience for EasyMock.expect(Object).
protected  org.easymock.IMocksControl getMocksControl()
           
protected static
<T> org.easymock.Capture<T>
newCapture()
          A factory method to create EasyMock Capture objects.
protected
<T> T
newMock(Class<T> mockClass)
          Creates a new mock object of the indicated type.
protected  void replay()
          Switches each mock object created by newMock(Class) into replay mode (out of the initial training mode).
protected static void setAnswer(org.easymock.IAnswer<?> answer)
          Convienience for EasyMock.expectLastCall() with IExpectationSetters.andAnswer(org.easymock.IAnswer).
protected static void setThrowable(Throwable throwable)
          Convienience for EasyMock.expectLastCall() with IExpectationSetters.andThrow(Throwable).
protected  void verify()
          Verifies that all trained methods have been invoked on all mock objects (created by newMock(Class), then switches each mock object back to training mode.
 
Methods inherited from class org.apache.tapestry5.ioc.test.TestUtils
assertArraysEqual, assertListsEquals, assertListsEquals, assertMessageContains, create, get, set, showLists, unreachable
 
Methods inherited from class org.testng.Assert
assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEqualsNoOrder, assertEqualsNoOrder, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, fail, fail, fail
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

TestBase

public TestBase()
Method Detail

getMocksControl

protected final org.easymock.IMocksControl getMocksControl()
Returns:
the IMocksControl for this thread.

discardMockControl

public final void discardMockControl()
Discards any mock objects created during the test.


newMock

protected final <T> T newMock(Class<T> mockClass)
Creates a new mock object of the indicated type. The shared mock control does not check order, but does fail on any unexpected method invocations.

Type Parameters:
T - the type of the mock object
Parameters:
mockClass - the class to mock
Returns:
the mock object, ready for training

replay

protected final void replay()
Switches each mock object created by newMock(Class) into replay mode (out of the initial training mode).


verify

protected final void verify()
Verifies that all trained methods have been invoked on all mock objects (created by newMock(Class), then switches each mock object back to training mode.


setThrowable

protected static void setThrowable(Throwable throwable)
Convienience for EasyMock.expectLastCall() with IExpectationSetters.andThrow(Throwable).

Parameters:
throwable - the exception to be thrown by the most recent method call on any mock

setAnswer

protected static void setAnswer(org.easymock.IAnswer<?> answer)
Convienience for EasyMock.expectLastCall() with IExpectationSetters.andAnswer(org.easymock.IAnswer).

Parameters:
answer - callback for the most recent method invocation

expect

protected static <T> org.easymock.IExpectationSetters<T> expect(T value)
Convenience for EasyMock.expect(Object).

Parameters:
value - to expect
Returns:
expectation setter, for setting return value, etc.

newCapture

protected static <T> org.easymock.Capture<T> newCapture()
A factory method to create EasyMock Capture objects.

Returns:
new Capture


Copyright © 2003-2012 The Apache Software Foundation.