com.premiumminds.webapp.wicket.testing

Class ExtendedWicketTester

java.lang.Object

org.apache.wicket.util.tester.BaseWicketTester

org.apache.wicket.util.tester.WicketTester

com.premiumminds.webapp.wicket.testing.ExtendedWicketTester

public class ExtendedWicketTester
extends org.apache.wicket.util.tester.WicketTester

A helper class to ease unit testing of Wicket form components without the need for a servlet container. The class adds methods to start a component in a form, which have the same functionality as BaseWicketTester.startComponentInPage(Component) and variants.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ExtendedWicketTester.StartComponentInForm A page that is used as the automatically created page for startComponentInForm(Class, String) and the other variations.

Nested classes/interfaces inherited from class org.apache.wicket.util.tester.BaseWicketTester

org.apache.wicket.util.tester.BaseWicketTester.StartComponentInPage, org.apache.wicket.util.tester.BaseWicketTester.TestFilterConfig

Constructor Summary

Constructors

Constructor and Description
ExtendedWicketTester() Creates an ExtendedWicketTester and automatically creates a WebApplication, but the tester will have no home page.
ExtendedWicketTester(Class<? extends org.apache.wicket.Page> homePage) Creates an ExtendedWicketTester and automatically creates a WebApplication.
ExtendedWicketTester(org.apache.wicket.protocol.http.WebApplication application) Creates an ExtendedWicketTester.
ExtendedWicketTester(org.apache.wicket.protocol.http.WebApplication application, javax.servlet.ServletContext servletCtx) Creates an ExtendedWicketTester to help unit testing.
ExtendedWicketTester(org.apache.wicket.protocol.http.WebApplication application, String path) Creates an ExtendedWicketTester to help unit testing.

Method Summary

Modifier and Type	Method and Description
protected org.apache.wicket.Page	createFormPage() Creates a Page to test a component with startComponentInForm(Component, String, IMarkupFragment)
protected String	createFormPageMarkup(String componentId, String inputType) Creates the markup that will be used for the automatically created Page that will be used to test a component with BaseWicketTester.startComponentInPage(Class, IMarkupFragment)
<C extends org.apache.wicket.Component> C	startComponentInForm(Class<C> componentClass, String inputType) Process a component.
<C extends org.apache.wicket.Component> C	startComponentInForm(Class<C> componentClass, String inputType, org.apache.wicket.markup.IMarkupFragment pageMarkup) Process a component.
<C extends org.apache.wicket.Component> C	startComponentInForm(C component, String inputType) Process a component.
<C extends org.apache.wicket.Component> C	startComponentInForm(C component, String inputType, org.apache.wicket.markup.IMarkupFragment pageMarkup) Process a component.

Methods inherited from class org.apache.wicket.util.tester.WicketTester

assertAjaxLocation, assertBehavior, assertBookmarkablePageLink, assertComponent, assertComponentFeedbackMessage, assertComponentOnAjaxResponse, assertComponentOnAjaxResponse, assertContains, assertContainsNot, assertDisabled, assertEnabled, assertErrorMessages, assertFeedback, assertFeedbackMessages, assertInfoMessages, assertInvisible, assertLabel, assertListView, assertMarkupLocale, assertMarkupStyle, assertMarkupVariation, assertModelValue, assertNoErrorMessage, assertNoFeedbackMessage, assertNoInfoMessage, assertNotRequired, assertRedirectUrl, assertRenderedPage, assertRequired, assertResultPage, assertResultPage, assertUsability, assertVisible, clickLink, executeBehavior, executeListener, executeTest, executeTest, executeTest, executeTest, getBasedir

Methods inherited from class org.apache.wicket.util.tester.BaseWicketTester

addRequestHeader, applyRequest, assertExists, assertNotExists, checkUsability, cleanupFeedbackMessages, cleanupFeedbackMessages, clearFeedbackMessages, clickLink, clickLink, createOriginHeader, createPage, createPageMarkup, debugComponentTrees, debugComponentTrees, destroy, dumpPage, executeAjaxEvent, executeAjaxEvent, executeAjaxUrl, executeAllTimerBehaviors, executeBehavior, executeListener, executeUrl, getApplication, getComponentFromLastRenderedPage, getComponentFromLastRenderedPage, getComponentFromLastRenderedPage, getContentDispositionFromResponseHeader, getContentLengthFromResponseHeader, getContentTypeFromResponseHeader, getFeedbackMessages, getHttpSession, getLastModifiedFromResponseHeader, getLastRenderedPage, getLastRequest, getLastResponse, getLastResponseAsString, getMessages, getPreviousRequests, getPreviousResponses, getRequest, getRequestCycle, getResourcePollFrequency, getResponse, getServletContext, getSession, getTagById, getTagByWicketId, getTagsByWicketId, getWicketAjaxBaseUrlEncodedInLastResponse, hasLabel, hasNoErrorMessage, hasNoFeedbackMessage, hasNoInfoMessage, ifContains, ifContainsNot, invokeListener, invokeListener, isComponent, isComponentOnAjaxResponse, isDisabled, isEnabled, isEqual, isExposeExceptions, isFollowRedirects, isInvisible, isNotRequired, isNotRequired, isRenderedPage, isRequired, isRequired, isResultPage, isUseRequestUrlAsBase, isVisible, newFormTester, newFormTester, newServletWebResponse, newTestPageManagerProvider, processRequest, processRequest, processRequest, processRequest, processRequest, servletRequestLocale, setExposeExceptions, setFollowRedirects, setLastResponse, setRequest, setUseRequestUrlAsBase, startComponentInPage, startComponentInPage, startComponentInPage, startComponentInPage, startPage, startPage, startPage, startPage, startResource, startResourceReference, startResourceReference, submitForm, submitForm, urlFor, urlFor, urlFor

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtendedWicketTester

public ExtendedWicketTester()

Creates an ExtendedWicketTester and automatically creates a WebApplication, but the tester will have no home page.

ExtendedWicketTester

public ExtendedWicketTester(Class<? extends org.apache.wicket.Page> homePage)

Creates an ExtendedWicketTester and automatically creates a WebApplication.

Parameters:

homePage - a home page Class

ExtendedWicketTester

public ExtendedWicketTester(org.apache.wicket.protocol.http.WebApplication application)

Creates an ExtendedWicketTester.

Parameters:

application - a WicketTester WebApplication object

ExtendedWicketTester

public ExtendedWicketTester(org.apache.wicket.protocol.http.WebApplication application,
                            String path)

Creates an ExtendedWicketTester to help unit testing.

Parameters:

application - a WicketTester WebApplication object

path - the absolute path on disk to the web application's contents (e.g. war root) - may be null

See Also:

org.apache.wicket.mock.MockApplication#MockApplication()

ExtendedWicketTester

public ExtendedWicketTester(org.apache.wicket.protocol.http.WebApplication application,
                            javax.servlet.ServletContext servletCtx)

Creates an ExtendedWicketTester to help unit testing.

Parameters:

application - a WicketTester WebApplication object

servletCtx - the servlet context used as backend

Method Detail

startComponentInForm

public final <C extends org.apache.wicket.Component> C startComponentInForm(Class<C> componentClass,
                                                                            String inputType)

Process a component. A web page will be automatically created with the markup created in BaseWicketTester.createPageMarkup(String).

Note: the instantiated component will have an auto-generated id. To reach any of its children use their relative path to the component itself. For example if the started component has a child a Link component with id "link" then after starting the component you can click it with: tester.clickLink("link")

Type Parameters:

C - the type of the component

Parameters:

componentClass - the class of the component to be tested

inputType - the type of HTML input to be associated with the component to be tested

Returns:

The component processed

See Also:

BaseWicketTester.startComponentInPage(org.apache.wicket.Component)

startComponentInForm

public final <C extends org.apache.wicket.Component> C startComponentInForm(Class<C> componentClass,
                                                                            String inputType,
                                                                            org.apache.wicket.markup.IMarkupFragment pageMarkup)

Process a component. A web page will be automatically created with the pageMarkup provided. In case pageMarkup is null, the markup will be automatically created with createFormPageMarkup(String, String).

Note: the instantiated component will have an auto-generated id. To reach any of its children use their relative path to the component itself. For example if the started component has a child a Link component with id "link" then after starting the component you can click it with: tester.clickLink("link")

Type Parameters:

C - the type of the component

Parameters:

componentClass - the class of the component to be tested

inputType - the type of HTML input to be associated with the component to be tested

pageMarkup - the markup for the Page that will be automatically created. May be null.

Returns:

The component processed

startComponentInForm

public final <C extends org.apache.wicket.Component> C startComponentInForm(C component,
                                                                            String inputType)

Process a component. A web page will be automatically created with markup created by the createFormPageMarkup(String, String).

Note: the component id is set by the user. To reach any of its children use this id + their relative path to the component itself. For example if the started component has id compId and a Link child component component with id "link" then after starting the component you can click it with: tester.clickLink("compId:link")

Type Parameters:

C - the type of the component

Parameters:

component - the component to be tested

inputType - the type of HTML input to be associated with the component to be tested

Returns:

The component processed

See Also:

BaseWicketTester.startComponentInPage(Class)

startComponentInForm

public final <C extends org.apache.wicket.Component> C startComponentInForm(C component,
                                                                            String inputType,
                                                                            org.apache.wicket.markup.IMarkupFragment pageMarkup)

Process a component. A web page will be automatically created with the pageMarkup provided. In case pageMarkup is null, the markup will be automatically created with createFormPageMarkup(String, String).

Note: the component id is set by the user. To reach any of its children use this id + their relative path to the component itself. For example if the started component has id compId and a Link child component component with id "link" then after starting the component you can click it with: tester.clickLink("compId:link")

Type Parameters:

C - the type of the component

Parameters:

component - the component to be tested

inputType - the type of HTML input to be associated with the component to be tested

pageMarkup - the markup for the Page that will be automatically created. May be null.

Returns:

The component processed

createFormPageMarkup

protected String createFormPageMarkup(String componentId,
                                      String inputType)

Creates the markup that will be used for the automatically created Page that will be used to test a component with BaseWicketTester.startComponentInPage(Class, IMarkupFragment)

Parameters:

componentId - the id of the component to be tested

inputType - the form input type ('text', 'checkbox', 'password', etc)

Returns:

the markup for the Page as String. Cannot be null.

createFormPage

protected org.apache.wicket.Page createFormPage()

Creates a Page to test a component with startComponentInForm(Component, String, IMarkupFragment)

Returns:

a Page which will contain a form as a single child with the component under test as a single input