com.formos.tapestry.testify.core

Class TapestryTester

java.lang.Object

org.apache.tapestry5.test.PageTester

com.formos.tapestry.testify.core.TapestryTester

public class TapestryTester
extends org.apache.tapestry5.test.PageTester

An extension of Tapestry's PageTester to add additional features.

Field Summary

Fields inherited from class org.apache.tapestry5.test.PageTester

DEFAULT_CONTEXT_PATH

Constructor Summary

Constructors

Constructor and Description
TapestryTester(String appPackage, Class<?>... moduleClasses)
TapestryTester(String appPackage, String appName, String contextPath, Class<?>... moduleClasses)

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	autobuild(Class<T> clazz) Autobuilds a class by finding the public constructor with the most parameters.
void	collectForComponentsFrom(Object object) Searches for fields in the object annotated with ForComponents and registers them in the component injection pipeline so that they will be the preferred objects to inject into components and pages during this test.
void	endTest() Call this method to mark the end of a test (for example in the test's tearDown() method).
<T> T	getService(String id, Class<T> serviceInterface) Obtains a service via its unique service id.
void	injectInto(Object object) Process the Inject annotation on fields in the given object - those fields will be given values found in this tester's IOC container.
org.apache.tapestry5.internal.test.TestableResponse	renderResponse(String path) Processes a request for the specified path and returns the response generated.

Methods inherited from class org.apache.tapestry5.test.PageTester

clickLink, clickLinkAndReturnResponse, clickSubmit, clickSubmitAndReturnResponse, getRegistry, getService, provideExtraModuleDefs, renderPage, renderPageAndReturnResponse, setPreferedLanguage, shutdown, submitForm, submitFormAndReturnResponse

Methods inherited from class java.lang.Object

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

Constructor Detail

TapestryTester

public TapestryTester(String appPackage,
              String appName,
              String contextPath,
              Class<?>... moduleClasses)

TapestryTester

public TapestryTester(String appPackage,
              Class<?>... moduleClasses)

Method Detail

getService

public <T> T getService(String id,
               Class<T> serviceInterface)

Obtains a service via its unique service id.

Type Parameters:

T -

Parameters:

id - unique Service id used to locate the service object (may contain symbols, which will be expanded), case is ignored (not null)

serviceInterface - the interface implemented by the service (or an interface extended by the service interface) (not null)

Returns:

the service found (not null)

Throws:

RuntimeException - if the service is not defined, or if an error occurs instantiating it

autobuild

public <T> T autobuild(Class<T> clazz)

Autobuilds a class by finding the public constructor with the most parameters. Services and resources will be injected into the parameters of the constructor.

Type Parameters:

T -

Parameters:

clazz - the type of object to instantiate (not null)

Returns:

the instantiated instance (not null)

Throws:

RuntimeException - if the autobuild fails

See Also:

MasterObjectProvider

endTest

public void endTest()

Call this method to mark the end of a test (for example in the test's tearDown() method). This is used to mark the end of the TestifyConstants.PERTEST scope.

injectInto

public void injectInto(Object object)

Process the Inject annotation on fields in the given object - those fields will be given values found in this tester's IOC container. Use Service on the field as well if you need to find a service by id.

Parameters:

object - the object to process (not null)

collectForComponentsFrom

public void collectForComponentsFrom(Object object)

Searches for fields in the object annotated with ForComponents and registers them in the component injection pipeline so that they will be the preferred objects to inject into components and pages during this test. These objects are removed from the pipeline when endTest() is called.

Parameters:

object - the object to process (not null)

renderResponse

public org.apache.tapestry5.internal.test.TestableResponse renderResponse(String path)

Processes a request for the specified path and returns the response generated. This is for low-level testing, most of the time PageTester.renderPage(String) is what you want. Note that unlike PageTester.renderPage(String), this does not follow redirects - instead the redirect response is returned.

Parameters:

path - the path for the request; must begin with a "/" character (not null)

Returns:

the response (not null)