Java Doc for WicketTester.java in  » J2EE » wicket » wicket » util » tester » Java Source Code / Java DocumentationJava Source Code and Java Documentation

 // production page  
 public class MyPage extends WebPage
 {
 public MyPage()
 {
 add(new Label("myMessage", "Hello!"));
 add(new Link("toYourPage")
 {
 public void onClick()
 {
 setResponsePage(new YourPage("Hi!"));
 }
 });
 }
 }
 

 // test code
 private WicketTester tester;
 public void setUp()
 {
 tester = new WicketTester();
 }
 public void testRenderMyPage()
 {
 //start and render the test page
 tester.startPage(MyPage.class);
 //assert rendered page class
 tester.assertRenderedPage(MyPage.class);
 //assert rendered label component 
 tester.assertLabel("myMessage", "Hello!");
 }
 

 // production page  
 public class YourPage extends WebPage
 {
 public YourPage(String message)
 {
 add(new Label("yourMessage", message));
 info("Wicket Rocks ;-)");
 }
 }
 //test code
 public void testLinkToYourPage()
 {
 tester.startPage(MyPage.class);
 //click link and render
 tester.clickLink("toYourPage");
 tester.assertRenderedPage(YourPage.class);
 tester.assertLabel("yourMessage", "Hi!");
 }
 

 //test code
 public void testRenderYourPage()
 {
 // provide page instance source for WicketTester
 tester.startPage(new TestPageSource()
 {
 public Page getTestPage()
 {
 return new YourPage("mock message");
 }
 });
 tester.assertRenderedPage(YourPage.class);
 tester.assertLabel("yourMessage", "mock message");
 // assert feedback messages in INFO Level 
 tester.assertInfoMessages(new String[] { "Wicket Rocks ;-)" });
 }
 

This method also works for AjaxLink , AjaxFallbackLink and AjaxSubmitLink .

On AjaxLinks and AjaxFallbackLinks the onClick method is invoked with a valid AjaxRequestTarget.

PLEASE NOTE! This method doesn't actually insert the component in the client DOM tree, using javascript. But it shouldn't be needed because you have to trust that the Wicket Ajax Javascript just works.
Parameters:
  component - The component to test whether it's on the response.

Simulate that AJAX is enabled.
See Also:   WicketTester.clickLink(Stringboolean)
Parameters:
  path - Click the Link in the last rendered Page.

This method also works for AjaxLink , AjaxFallbackLink and AjaxSubmitLink .

On AjaxLinks and AjaxFallbackLinks the onClick method is invoked with a valid AjaxRequestTarget. In that way you can test the flow of your application when using AJAX.

When clicking an AjaxSubmitLink the form, which the AjaxSubmitLink is attached to is first submitted, and then the onSubmit method on AjaxSubmitLink is invoked. If you have changed some values in the form during your test, these will also be submitted. This should not be used as a replacement for the FormTester to test your forms. It should be used to test that the code in your onSubmit method in AjaxSubmitLink actually works.

This method is also able to simulate that AJAX (javascript) is disabled on the client. This is done by setting the isAjax parameter to false. If you have an AjaxFallbackLink you can then check that it doesn't fail when invoked as a normal link.
Parameters:
  path - path to Link component
Parameters:
  isAjax - Whether to simulate that AJAX (javascript) is enabled or not.If it's false then AjaxLink and AjaxSubmitLink will fail,since it wouldn't work in real life. AjaxFallbackLink will beinvoked with null as the AjaxRequestTarget parameter.

 ...
 component.add(new AjaxEventBehavior("ondblclick") {
 public void onEvent(AjaxRequestTarget) {
 // Do something.
 }
 });
 ...
 

 ...
 tester.executeAjaxEvent(component, "ondblclick");
 // Test that the code inside onEvent is correct.
 ...
 

PLEASE NOTE! This method doesn't actually insert the component in the client DOM tree, using javascript.
Parameters:
  component - The component which has the AjaxEventBehavior we wan't totest. If the component is null, the test will fail.
Parameters:
  event - The event which we simulate is fired. If the event is null,the test will fail.

 tester.startPage(new TestPageSource()
 {
 public Page getTestPage()
 {
 Book mockBook = new Book("myBookName");
 return new ViewBook(mockBook);
 }
 });