org.apache.shale.test.htmlunit.AbstractHtmlUnitTestCase Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to you under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.shale.test.htmlunit;
import com.gargoylesoftware.htmlunit.ElementNotFoundException;
import com.gargoylesoftware.htmlunit.WebClient;
import com.gargoylesoftware.htmlunit.html.HtmlAnchor;
import com.gargoylesoftware.htmlunit.html.HtmlBody;
import com.gargoylesoftware.htmlunit.html.HtmlElement;
import com.gargoylesoftware.htmlunit.html.HtmlForm;
import com.gargoylesoftware.htmlunit.html.HtmlHead;
import com.gargoylesoftware.htmlunit.html.HtmlPage;
import com.gargoylesoftware.htmlunit.html.HtmlSubmitInput;
import java.io.IOException;
import java.net.URL;
import java.util.Iterator;
import junit.framework.Test;
import junit.framework.TestCase;
import junit.framework.TestSuite;
/**
* Abstract base class for system integration tests based on HtmlUnit.
* These tests will expect a system property named url to be
* present, which will define the URL (including the context path, but
* without a trailing slash) of the application to be tested.
*/
public abstract class AbstractHtmlUnitTestCase extends TestCase {
// ------------------------------------------------------------ Constructors
/**
* Construct a new instance of this test case.
*
* @param name Name of the new test case
*/
public AbstractHtmlUnitTestCase(String name) {
super(name);
}
// ------------------------------------------------------ Instance Variables
/**
* The most recently retrieved page from the server.
*/
protected HtmlPage page = null;
/**
* The calculated URL for the installed "systest" web application.
* This value is based on a system property named url,
* which must be defined as part of the command line that executes
* each test case.
*/
protected URL url = null;
/**
* The web client for this test case.
*/
protected WebClient webClient = null;
// ------------------------------------------------------ Test Setup Methods
/**
* Set up the instance variables required for this test case.
*
* @exception Exception if an error occurs
*/
protected void setUp() throws Exception {
// Calculate the URL for the installed "systest" web application
String url = System.getProperty("url");
this.url = new URL(url + "/");
// Initialize HtmlUnit constructs for this test case
webClient = new WebClient();
}
/**
* Return the set of tests included in this test suite.
*/
public static Test suite() {
return (new TestSuite(AbstractHtmlUnitTestCase.class));
}
/**
* Tear down instance variables required by this test case.
*/
protected void tearDown() throws Exception {
page = null;
url = null;
webClient = null;
}
// ------------------------------------------------------- Protected Methods
/**
* Return the body element for the most recently retrieved page.
* If there is no such element, return null.
*
* @exception Exception if an error occurs
*/
protected HtmlBody body() throws Exception {
Iterator elements = page.getAllHtmlChildElements();
while (elements.hasNext()) {
HtmlElement element = (HtmlElement) elements.next();
if (element instanceof HtmlBody) {
return ((HtmlBody) element);
}
}
return (null);
}
/**
* Return the HTML element with the specified id from the
* most recently retrieved page. If there is no such element, return
* null.
*
* @param id Identifier of the requested element.
*
* @exception Exception if an error occurs
*/
protected HtmlElement element(String id) throws Exception {
try {
return (page.getHtmlElementById(id));
} catch (ElementNotFoundException e) {
return (null);
}
}
/**
* Return the form with the specified id from the most
* recently retrieved page. If there is no such form, return
* null.
*
* @param id Identifier of the requested form.
*
* @exception Exception if an error occurs
*/
protected HtmlForm form(String id) throws Exception {
Iterator forms = page.getForms().iterator();
while (forms.hasNext()) {
HtmlForm form = (HtmlForm) forms.next();
if (id.equals(form.getAttributeValue("id"))) {
return (form);
}
}
return (null);
}
/**
*
Return the head element for the most recently retrieved page.
* If there is no such element, return null.
*
* @exception Exception if an error occurs
*/
protected HtmlHead head() throws Exception {
Iterator elements = page.getAllHtmlChildElements();
while (elements.hasNext()) {
HtmlElement element = (HtmlElement) elements.next();
if (element instanceof HtmlHead) {
return ((HtmlHead) element);
}
}
return (null);
}
/**
* Click the specified hyperlink, and retrieve the subsequent page,
* saving a reference so that other utility methods may be used to
* retrieve information from it.
*
* @param anchor Anchor component to click
*
* @exception IOException if an input/output error occurs
*/
protected HtmlPage link(HtmlAnchor anchor) throws IOException {
HtmlPage page = (HtmlPage) anchor.click();
this.page = page;
return page;
}
/**
* Return the currently stored page reference.
*/
protected HtmlPage page() {
return this.page;
}
/**
* Retrieve and return the page at the specified context relative path.
* Save a reference to this page so that other utility methods may be used
* to retrieve information from it.
*
* @param path Context relative path
*
* @exception IllegalArgumentException if the context relative path
* does not begin with a '/' character
* @exception Exception if a different error occurs
*/
protected HtmlPage page(String path) throws Exception {
HtmlPage page = (HtmlPage) webClient.getPage(url(path));
this.page = page;
return (page);
}
/**
* Reset the stored page reference to the specified value. This is
* useful for scenarios testing resubmit of the same page (simulating the
* user pressing the back button and then submitting again).
*
* @param page Previously saved page to which to reset
*/
protected void reset(HtmlPage page) {
this.page = page;
}
/**
* Submit the current page, using the specified component, and retrieve
* the subsequent page, saving a reference so that other utility methods
* may be used to retrieve information from it.
*
* @param submit Submit button component to click
*
* @exception IOException if an input/output error occurs
*/
protected HtmlPage submit(HtmlSubmitInput submit) throws IOException {
HtmlPage page = (HtmlPage) submit.click();
this.page = page;
return page;
}
/**
* Return the page title from the most recently retrieved page.
* Any leading and trailing whitespace will be trimmed.
*
* @exception Exception if an error occurs
*/
protected String title() throws Exception {
return (page.getTitleText().trim());
}
/**
* Calculate and return an absolute URL for the specified context
* relative path, which must begin with a '/' character.
*
* @param path Context relative path
*
* @exception IllegalArgumentException if the context relative path
* does not begin with a '/' character
* @exception Exception if a different error ocurs
*/
protected URL url(String path) throws Exception {
if (path.charAt(0) != '/') {
throw new IllegalArgumentException("Context path '" + path
+ "' does not start with '/'");
}
return new URL(url, path.substring(1));
}
}