Tapestry provides support for easily unit testing your pages and components. Follow the simple steps below.
Div |
---|
style | float:right |
---|
title | Related Articles |
---|
class | aui-label |
---|
|
Content by Label |
---|
showLabels | false |
---|
showSpace | false |
---|
title | Related Articles |
---|
cql | label = "testing" and space = currentSpace() |
---|
|
|
Unit testing pages or components
Wiki Markup |
---|
{float:right|background=#eee}
{contentbylabel:title=Related Articles|showLabels=false|showSpace=false|space=@self|labels=testing}
{float} |
...
Setting up a driving environment
...
- Your application package.
- Your filter name. This is used to load your Tapestry IoC module only. If you have none, you can pass an empty string or anything to it.
- The folder acting as your context root. This is used to locate your templates (if they're put there).Here is an example (using TestNG, but you're free to use JUnit or anything else):
Code Block |
---|
|
public class MyTest extends Assert
{
@Test
public void test1()
{
String appPackage = "org.example.app";
String appName = "App1"; // App1Module.java has configured some services.
PageTester tester = new PageTester(appPackage, appName, "src/main/webapp");
}
}
|
...
Here is an example. Let's assuming the page being tested is named "MyPage" and it should return a page containing an HTML element whose id is "id1" and whose text content should be "hello":
Code Block |
---|
|
public class MyTest extends Assert
{
@Test
public void test1()
{
String appPackage = "org.example.app";
String appName = "LocaleApp";
PageTester tester = new PageTester(appPackage, appName, "src/main/webapp");
Document doc = tester.renderPage("MyPage");
assertEquals(doc.getElementById("id1").getChildText(), "hello");
}
}
|
If the page requires a context, you can pass it this way:
Code Block |
---|
|
public class MyTest extends Assert
{
@Test
public void test1()
{
String appPackage = "org.example.app";
String appName = "LocaleApp";
PageTester tester = new PageTester(appPackage, appName, "src/main/webapp");
Object[] context = new Object[]{ "abc", 123 };
Document doc = tester.invoke(new ComponentInvocation(new PageLinkTarget("MyPage"), context));
assertEquals(doc.getElementById("id1").getChildText(), "hello");
}
}
|
...
After rendering a page, you may want to "click" on an action link and then assert against the resulting page. You can do it this way:
Code Block |
---|
|
public class MyTest extends Assert
{
@Test
public void test1()
{
String appPackage = "org.example.app";
String appName = "LocaleApp";
PageTester tester = new PageTester(appPackage, appName, "src/main/webapp");
Document doc = tester.renderPage("MyPage");
Element link = doc.getElementById("link1");
doc = tester.clickLink(link);
assertTrue(doc.toString().contains("abc"));
}
}
|
...
After rendering a page, you may want to fill out a form, submit it and then inspect the resulting page. You can do it this way:
Code Block |
---|
|
public class MyTest extends Assert
{
@Test
public void test1()
{
String appPackage = "org.example.app";
String appName = "LocaleApp";
PageTester tester = new PageTester(appPackage, appName, "src/main/webapp");
Document doc = tester.renderPage("MyPage");
Element form = doc.getElementById("form1");
Map<String, String> fieldValues = new HashMap<String, String>();
fieldValues.put("field1", "hello");
fieldValues.put("field2", "100");
doc = tester.submitForm(form, fieldValues);
assertTrue(doc.toString().contains("abc"));
}
}
|
To submit a form by clicking a submit button, call the clickSubmit() method instead.
Unit testing a component
...