net.sf.jameleon.plugin.jwebunit
Class HttpFunctionTag

java.lang.Object
  org.apache.commons.jelly.TagSupport
      net.sf.jameleon.LocationAwareTagSupport
          net.sf.jameleon.JameleonTagSupport
              net.sf.jameleon.function.FunctionTag
                  net.sf.jameleon.plugin.jwebunit.HttpFunctionTag

All Implemented Interfaces:

BreakPoint, Attributable, Storable, DynaTag, LocationAware, Tag

public abstract class HttpFunctionTag
extends FunctionTag

An implementation of the JWebUnit plugin for a FunctionTag. All methods in the WebTester class provided by the JWebUnit API is wrapped for easy coding and statical reporting.

For function points that will always be used to start the test case, the begin() method should be called first.

Field Summary

protected com.meterware.httpunit.WebClientListener	listener A Client Listener used for logging.
protected long	requestTime The start time of a request
protected net.sourceforge.jwebunit.WebTester	session The session that is to be shared among all TestSteps encapsulated within a TestCase

Fields inherited from class net.sf.jameleon.function.FunctionTag

addt, breakPoint, expectException, expectFailure, fResults, functionDelay, functionId, lastFileWritten, log, NO_DELAY, params, postcondition, precondition, st, state, tct, vpt

Fields inherited from class net.sf.jameleon.JameleonTagSupport

attributes, broker, contextVars, fp, unsupportedAttributes

Fields inherited from class net.sf.jameleon.LocationAwareTagSupport

columnNumber, elementTagName, lineNumber, scriptFileName

Fields inherited from class org.apache.commons.jelly.TagSupport

body, context, hasTrimmed, parent, shouldTrim

Constructor Summary

HttpFunctionTag()
Default constructor -- Does nothing

Method Summary

void	assertButtonNotPresent(String buttonId) Assert that a button with a given id is not present.
void	assertButtonNotPresent(String buttonId, int assertLevel) Assert that a button with a given id is not present.
void	assertButtonPresent(String buttonId) Assert that a button with a given id is present.
void	assertButtonPresent(String buttonId, int assertLevel) Assert that a button with a given id is present.
void	assertCheckboxNotSelected(String checkBoxName) Assert that a specific checkbox is not selected.
void	assertCheckboxNotSelected(String checkBoxName, int assertLevel) Assert that a specific checkbox is not selected.
void	assertCheckboxSelected(String checkBoxName) Assert that a specific checkbox is selected.
void	assertCheckboxSelected(String checkBoxName, int assertLevel) Assert that a specific checkbox is selected.
void	assertElementNotPresent(String anID) Assert that an element with a given id is not present.
void	assertElementNotPresent(String anID, int assertLevel) Assert that an element with a given id is not present.
void	assertElementPresent(String anID) Assert that an element with a given id is present.
void	assertElementPresent(String anID, int assertLevel) Assert that an element with a given id is present.
void	assertFormElementEmpty(String formElementName) Assert that a form element had no value / is empty.
void	assertFormElementEmpty(String formElementName, int assertLevel) Assert that a form element had no value / is empty.
void	assertFormElementEquals(String formElementName, String expectedValue) Assert that a specific form element has an expected value.
void	assertFormElementEquals(String formElementName, String expectedValue, int assertLevel) Assert that a specific form element has an expected value.
void	assertFormElementNotPresent(String formElementName) Assert that a form input element with a given name is not present.
void	assertFormElementNotPresent(String formElementName, int assertLevel) Assert that a form input element with a given name is not present.
void	assertFormElementNotPresentWithLabel(String formElementLabel) Assert that a form input element with a given label is not present.
void	assertFormElementNotPresentWithLabel(String formElementLabel, int assertLevel) Assert that a form input element with a given label is not present.
void	assertFormElementPresent(String formElementName) Assert that a form input element with a given name is present.
void	assertFormElementPresent(String formElementName, int assertLevel) Assert that a form input element with a given name is present.
void	assertFormElementPresentWithLabel(String formElementLabel) Assert that a form input element with a given label is present.
void	assertFormElementPresentWithLabel(String formElementLabel, int assertLevel) Assert that a form input element with a given label is present.
void	assertFormPresent() Assert that there is a form present.
void	assertFormPresent(int assertLevel) Assert that there is a form present.
void	assertFormPresent(String nameOrID) Assert that there is a form with the specified name or id present.
void	assertFormPresent(String nameOrID, int assertLevel) Assert that there is a form with the specified name or id present.
void	assertFramePresent(String frameName) Assert that a frame with the given name is present.
void	assertFramePresent(String frameName, int assertLevel) Assert that a frame with the given name is present.
void	assertKeyInTable(String tableSummaryOrId, String key) Assert that the value of a given web resource is present in a specific table.
void	assertKeyInTable(String tableSummaryOrId, String key, int assertLevel) Assert that the value of a given web resource is present in a specific table.
void	assertKeyNotInTable(String tableSummaryOrId, String key) Assert that the value of a given web resource is not present in a specific table.
void	assertKeyNotInTable(String tableSummaryOrId, String key, int assertLevel) Assert that the value of a given web resource is not present in a specific table.
void	assertKeyNotPresent(String key) Assert that a web resource's value is not present.
void	assertKeyNotPresent(String key, int assertLevel) Assert that a web resource's value is not present.
void	assertKeyPresent(String key) Assert that a web resource's value is present.
void	assertKeyPresent(String key, int assertLevel) Assert that a web resource's value is present.
void	assertKeysInTable(String tableSummaryOrId, String[] keys) Assert that the values of a set of web resources are all present in a specific table.
void	assertKeysInTable(String tableSummaryOrId, String[] keys, int assertLevel) Assert that the values of a set of web resources are all present in a specific table.
void	assertLinkNotPresent(String linkId) Assert that no link with the given id is present in the response.
void	assertLinkNotPresent(String linkId, int assertLevel) Assert that no link with the given id is present in the response.
void	assertLinkNotPresentWithImage(String imageFileName) Assert that a link containing a specified image is not present.
void	assertLinkNotPresentWithImage(String imageFileName, int assertLevel) Assert that a link containing a specified image is not present.
void	assertLinkNotPresentWithText(String linkText) Assert that no link containing the supplied text is present.
void	assertLinkNotPresentWithText(String linkText, int assertLevel) Assert that no link containing the supplied text is present.
void	assertLinkPresent(String linkId) Assert that a link with a given id is present in the response.
void	assertLinkPresent(String linkId, int assertLevel) Assert that a link with a given id is present in the response.
void	assertLinkPresentWithImage(String imageFileName) Assert that a link containing a specified image is present.
void	assertLinkPresentWithImage(String imageFileName, int assertLevel) Assert that a link containing a specified image is present.
void	assertLinkPresentWithText(String linkText) Assert that a link containing the supplied text is present.
void	assertLinkPresentWithText(String linkText, int assertLevel) Assert that a link containing the supplied text is present.
void	assertOptionEquals(String selectName, String option) Assert that the currently selected display value of a select box matches a given value.
void	assertOptionEquals(String selectName, String option, int assertLevel) Assert that the currently selected display value of a select box matches a given value.
void	assertOptionsEqual(String selectName, String[] expectedOptions) Assert that the display values of a select element's options match a given array of strings.
void	assertOptionsEqual(String selectName, String[] expectedOptions, int assertLevel) Assert that the display values of a select element's options match a given array of strings.
void	assertOptionsNotEqual(String selectName, String[] expectedOptions) Assert that the display values of a select element's options do not match a given array of strings.
void	assertOptionsNotEqual(String selectName, String[] expectedOptions, int assertLevel) Assert that the display values of a select element's options do not match a given array of strings.
void	assertOptionValuesEqual(String selectName, String[] expectedValues) Assert that the values of a select element's options match a given array of strings.
void	assertOptionValuesEqual(String selectName, String[] expectedValues, int assertLevel) Assert that the values of a select element's options match a given array of strings.
void	assertOptionValuesNotEqual(String selectName, String[] optionValues) Assert that the values of a select element's options do not match a given array of strings.
void	assertOptionValuesNotEqual(String selectName, String[] optionValues, int assertLevel) Assert that the values of a select element's options do not match a given array of strings.
void	assertRadioOptionNotPresent(String name, String radioOption) Assert that a specific option is not present in a radio group.
void	assertRadioOptionNotPresent(String name, String radioOption, int assertLevel) Assert that a specific option is not present in a radio group.
void	assertRadioOptionNotSelected(String name, String radioOption) Assert that a specific option is not selected in a radio group.
void	assertRadioOptionNotSelected(String name, String radioOption, int assertLevel) Assert that a specific option is not selected in a radio group.
void	assertRadioOptionPresent(String name, String radioOption) Assert that a specific option is present in a radio group.
void	assertRadioOptionPresent(String name, String radioOption, int assertLevel) Assert that a specific option is present in a radio group.
void	assertRadioOptionSelected(String name, String radioOption) Assert that a specific option is selected in a radio group.
void	assertRadioOptionSelected(String name, String radioOption, int assertLevel) Assert that a specific option is selected in a radio group.
void	assertSubmitButtonNotPresent(String buttonName) Assert that a submit button with a given name is not present.
void	assertSubmitButtonNotPresent(String buttonName, int assertLevel) Assert that a submit button with a given name is not present.
void	assertSubmitButtonPresent(String buttonName) Assert that a submit button with a given name is present.
void	assertSubmitButtonPresent(String buttonName, int assertLevel) Assert that a submit button with a given name is present.
void	assertSubmitButtonValue(String buttonName, String expectedValue) Assert that a submit button with a given name and value is present.
void	assertSubmitButtonValue(String buttonName, String expectedValue, int assertLevel) Assert that a submit button with a given name and value is present.
void	assertTableEquals(String tableSummaryOrId, net.sourceforge.jwebunit.ExpectedTable expectedTable) Assert that a specific table matches an ExpectedTable.
void	assertTableEquals(String tableSummaryOrId, net.sourceforge.jwebunit.ExpectedTable expectedTable, int assertLevel) Assert that a specific table matches an ExpectedTable.
void	assertTableEquals(String tableSummaryOrId, String[][] expectedCellValues) Assert that a specific table matches a matrix of supplied text values.
void	assertTableEquals(String tableSummaryOrId, String[][] expectedCellValues, int assertLevel) Assert that a specific table matches a matrix of supplied text values.
void	assertTableNotPresent(String tableSummaryOrId) Assert that a table with a given summary or id value is not present.
void	assertTableNotPresent(String tableSummaryOrId, int assertLevel) Assert that a table with a given summary or id value is not present.
void	assertTablePresent(String tableSummaryOrId) Assert that a table with a given summary or id value is present.
void	assertTablePresent(String tableSummaryOrId, int assertLevel) Assert that a table with a given summary or id value is present.
void	assertTableRowsEqual(String tableSummaryOrId, int startRow, net.sourceforge.jwebunit.ExpectedTable expectedTable) Assert that a range of rows for a specific table matches a matrix of supplied text values.
void	assertTableRowsEqual(String tableSummaryOrId, int startRow, net.sourceforge.jwebunit.ExpectedTable expectedTable, int assertLevel) Assert that a range of rows for a specific table matches a matrix of supplied text values.
void	assertTableRowsEqual(String tableSummaryOrId, int startRow, String[][] expectedCellValues) Assert that a range of rows for a specific table matches a matrix of supplied text values.
void	assertTableRowsEqual(String tableSummaryOrId, int startRow, String[][] expectedCellValues, int assertLevel) Assert that a range of rows for a specific table matches a matrix of supplied text values.
void	assertTextInElement(String elementID, String text) Assert that a given element contains specific text.
void	assertTextInElement(String elementID, String text, int assertLevel) Assert that a given element contains specific text.
void	assertTextInTable(String tableSummaryOrId, String text) Assert that supplied text is present in a specific table.
void	assertTextInTable(String tableSummaryOrId, String[] text) Assert that a set of text values are all present in a specific table.
void	assertTextInTable(String tableSummaryOrId, String[] text, int assertLevel) Assert that a set of text values are all present in a specific table.
void	assertTextInTable(String tableSummaryOrId, String text, int assertLevel) Assert that supplied text is present in a specific table.
void	assertTextNotInTable(String tableSummaryOrId, String text) Assert that supplied text is not present in a specific table.
void	assertTextNotInTable(String tableSummaryOrId, String[] text) Assert that none of a set of text values are present in a specific table.
void	assertTextNotInTable(String tableSummaryOrId, String[] text, int assertLevel) Assert that none of a set of text values are present in a specific table.
void	assertTextNotInTable(String tableSummaryOrId, String text, int assertLevel) Assert that supplied text is not present in a specific table.
void	assertTextNotPresent(String text) Assert that supplied text is not present.
void	assertTextNotPresent(String text, int assertLevel) Assert that supplied text is not present.
void	assertTextPresent(String text) Assert that supplied text is present.
void	assertTextPresent(String text, int assertLevel) Assert that supplied text is present.
void	assertTitleEquals(String title) Assert title of current html page in conversation matches an expected value.
void	assertTitleEquals(String title, int assertLevel) Assert title of current html page in conversation matches an expected value.
void	assertTitleEqualsKey(String titleKey) Assert title of current html page matches the value of a specified web resource.
void	assertTitleEqualsKey(String titleKey, int assertLevel) Assert title of current html page matches the value of a specified web resource.
void	assertWindowPresent(String windowName) Assert that a window with the given name is open.
void	assertWindowPresent(String windowName, int assertLevel) Assert that a window with the given name is open.
void	begin() Begin conversation at a url relative to the application root.
void	beginAt(String relativeURL) Begin conversation at a url relative to the application root.
void	checkCheckbox(String checkBoxName) Select a specified checkbox.
void	clickButton(String buttonId) Click the button with the given id.
void	clickLink(String linkId) Navigate by selection of a link with given id.
void	clickLinkWithImage(String imageFileName) Navigate by selection of a link with a given image.
void	clickLinkWithText(String linkText) Navigate by selection of a link containing given text.
void	dumpResponse(PrintStream stream) Dump html of current response to a specified stream - for debugging purposes.
void	dumpTable(String tableNameOrId, PrintStream stream) Dump the table as the 2D array that is used for assertions - for debugging purposes.
void	dumpTable(String tableNameOrId, String[][] table) Dump the table as the 2D array that is used for assertions - for debugging purposes.
void	dumpTable(String tableNameOrId, String[][] table, PrintStream stream) Dump the table as the 2D array that is used for assertions - for debugging purposes.
net.sourceforge.jwebunit.HttpUnitDialog	getDialog() Provides access to the httpunit wrapper for subclasses - in case functionality not yet wrappered required by test.
String	getMessage(String key) Return the value of a web resource based on its key.
net.sourceforge.jwebunit.TestContext	getTestContext() Provide access to test context.
void	gotoFrame(String frameName) Make the named frame active (current response will be frame's contents).
void	gotoRootWindow() Make the root window active.
void	gotoWindow(String windowName) Make a given window active (current response will be window's contents).
void	pluginTearDown() Called when the function is done being executed.
protected void	recordHttpResultBlock(Runnable r) Runs the run method of a Runnable and records the time taken to execute the code block
void	reset() Reset the current form.
void	selectOption(String selectName, String option) Select an option with a given display value in a select element.
void	setBaseUrl() Sets the baseUrl to it's property setting based on the application name, and environment.
void	setFormElement(String formElementName, String value) Set the value of a form input element.
void	setupEnvironment() Gets the references of the session and the test results from the parent TestCase This method gets called once all attributes are set from the macro language.
void	setWorkingForm(String nameOrId) Begin interaction with a specified form.
void	store(String fName, int event)
void	submit() Submit form - default submit button will be used (unnamed submit button, or named button if there is only one on the form.
void	submit(String buttonName) Submit form by pressing named button.
void	uncheckCheckbox(String checkBoxName) Deselect a specified checkbox.

Methods inherited from class net.sf.jameleon.function.FunctionTag

addParam, addRequiredAttribute, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertFalse, assertFalse, assertMethod, assertMethodWithLevel, assertNotNull, assertNotNull, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNotSame, assertNotSame, assertNull, assertNull, assertNull, assertNull, assertRegexMatches, assertRegexMatches, assertRegexMatches, assertRegexMatches, assertSame, assertSame, assertSame, assertSame, assertTextContains, assertTextContains, assertTextContains, assertTextContains, assertTextEndsWith, assertTextEndsWith, assertTextEndsWith, assertTextEndsWith, assertTextStartsWith, assertTextStartsWith, assertTextStartsWith, assertTextStartsWith, assertTrue, assertTrue, assertTrue, assertTrue, checkParamTypes, cleanUp, cleanUpEnvironment, delay, delay, doTag, fail, fail, fail, fail, getFunctionId, getFunctionResults, getMatchingRegexText, getParam, getParamLength, getParams, getParentTags, getSessionTag, getStoreToFileName, getStringOrDefault, getTestCaseTag, getVariable, getVariableAsBoolean, getVariableAsList, getVariableAsString, isBreakPoint, isContextVariableNull, recordFunctionResult, regexMatches, removeFunctionResult, removeVariable, setDefaultVariableValue, setDefaultVariableValue, setExpectException, setExpectFailure, setFunctionDelay, setFunctionId, setup, setUpFunctionResults, setVariable, tearDown, testBlock, traceMsg, validate

Methods inherited from class net.sf.jameleon.JameleonTagSupport

cleanVariablesInContext, createAttributes, describeAttributes, getAttributeBroker, getAttributes, getAttributeType, getClassAttributes, getFunctionalPoint, getUnsupportedAttributes, loadFunctionalPoint, resetFunctionalPoint, setAttribute, setVariableInContext, testForUnsupportedAttributesCaught

Methods inherited from class net.sf.jameleon.LocationAwareTagSupport

getColumnNumber, getElementName, getFileName, getLineNumber, setColumnNumber, setElementName, setFileName, setLineNumber

Methods inherited from class org.apache.commons.jelly.TagSupport

findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, findAncestorWithClass, getBody, getBodyText, getBodyText, getContext, getParent, invokeBody, isEscapeText, isTrim, setBody, setContext, setEscapeText, setParent, setTrim, trimBody

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.commons.jelly.Tag

getBody, getContext, getParent, invokeBody, setBody, setContext, setParent

Field Detail

session

protected net.sourceforge.jwebunit.WebTester session

The session that is to be shared among all TestSteps encapsulated within a TestCase

requestTime

protected long requestTime

The start time of a request

listener

protected com.meterware.httpunit.WebClientListener listener

A Client Listener used for logging. This can't be used since the Dialog doesn't get instaniated until after the first request.

Constructor Detail

HttpFunctionTag

public HttpFunctionTag()

Default constructor -- Does nothing

Method Detail

setupEnvironment

public void setupEnvironment()

Gets the references of the session and the test results from the parent TestCase This method gets called once all attributes are set from the macro language. Any required setup should go here.

Overrides:

setupEnvironment in class FunctionTag

pluginTearDown

public void pluginTearDown()

Called when the function is done being executed. Use to clean up resources created in the setup method.

Overrides:

pluginTearDown in class FunctionTag

getDialog

public net.sourceforge.jwebunit.HttpUnitDialog getDialog()

Provides access to the httpunit wrapper for subclasses - in case functionality not yet wrappered required by test.

Returns:

HttpUnitDialog instance used to wrapper httpunit conversation.

getTestContext

public net.sourceforge.jwebunit.TestContext getTestContext()

Provide access to test context.

Returns:

TestContext

setBaseUrl

public void setBaseUrl()

Sets the baseUrl to it's property setting based on the application name, and environment.

begin

public void begin()

Begin conversation at a url relative to the application root. This uses a variable stored in the context called beginAt

beginAt

public void beginAt(String relativeURL)

Begin conversation at a url relative to the application root.

Parameters:

relativeURL -

recordHttpResultBlock

protected void recordHttpResultBlock(Runnable r)

Runs the run method of a Runnable and records the time taken to execute the code block

Parameters:

r - - The block of code you want executed ( defined in the run() method ).

getMessage

public String getMessage(String key)

Return the value of a web resource based on its key. This translates to a property file lookup with the locale based on the current TestContext.

Parameters:

key - name of the web resource.

Returns:

value of the web resource, encoded according to TestContext.

store

public void store(String fName,
                  int event)
           throws IOException

Specified by:

store in interface Storable

Overrides:

store in class FunctionTag

Throws:

IOException

assertTitleEquals

public void assertTitleEquals(String title)

Assert title of current html page in conversation matches an expected value.

Parameters:

title - expected title value

assertTitleEquals

public void assertTitleEquals(String title,
                              int assertLevel)

Assert title of current html page in conversation matches an expected value.

Parameters:

title - expected title value

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTitleEqualsKey

public void assertTitleEqualsKey(String titleKey)

Assert title of current html page matches the value of a specified web resource.

Parameters:

titleKey - web resource key for title

assertTitleEqualsKey

public void assertTitleEqualsKey(String titleKey,
                                 int assertLevel)

Assert title of current html page matches the value of a specified web resource.

Parameters:

titleKey - web resource key for title

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertKeyPresent

public void assertKeyPresent(String key)

Assert that a web resource's value is present.

Parameters:

key - web resource name

assertKeyPresent

public void assertKeyPresent(String key,
                             int assertLevel)

Assert that a web resource's value is present.

Parameters:

key - web resource name

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTextPresent

public void assertTextPresent(String text)

Assert that supplied text is present.

Parameters:

text -

assertTextPresent

public void assertTextPresent(String text,
                              int assertLevel)

Assert that supplied text is present.

Parameters:

text -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertKeyNotPresent

public void assertKeyNotPresent(String key)

Assert that a web resource's value is not present.

Parameters:

key - web resource name

assertKeyNotPresent

public void assertKeyNotPresent(String key,
                                int assertLevel)

Assert that a web resource's value is not present.

Parameters:

key - web resource name

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTextNotPresent

public void assertTextNotPresent(String text)

Assert that supplied text is not present.

Parameters:

text -

assertTextNotPresent

public void assertTextNotPresent(String text,
                                 int assertLevel)

Assert that supplied text is not present.

Parameters:

text -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTablePresent

public void assertTablePresent(String tableSummaryOrId)

Assert that a table with a given summary or id value is present.

Parameters:

tableSummaryOrId - summary or id attribute value of table

assertTablePresent

public void assertTablePresent(String tableSummaryOrId,
                               int assertLevel)

Assert that a table with a given summary or id value is present.

Parameters:

tableSummaryOrId - summary or id attribute value of table

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTableNotPresent

public void assertTableNotPresent(String tableSummaryOrId)

Assert that a table with a given summary or id value is not present.

Parameters:

tableSummaryOrId - summary or id attribute value of table

assertTableNotPresent

public void assertTableNotPresent(String tableSummaryOrId,
                                  int assertLevel)

Assert that a table with a given summary or id value is not present.

Parameters:

tableSummaryOrId - summary or id attribute value of table

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertKeyInTable

public void assertKeyInTable(String tableSummaryOrId,
                             String key)

Assert that the value of a given web resource is present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

key - web resource name

assertKeyInTable

public void assertKeyInTable(String tableSummaryOrId,
                             String key,
                             int assertLevel)

Assert that the value of a given web resource is present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

key - web resource name

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTextInTable

public void assertTextInTable(String tableSummaryOrId,
                              String text)

Assert that supplied text is present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

text -

assertTextInTable

public void assertTextInTable(String tableSummaryOrId,
                              String text,
                              int assertLevel)

Assert that supplied text is present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

text -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertKeysInTable

public void assertKeysInTable(String tableSummaryOrId,
                              String[] keys)

Assert that the values of a set of web resources are all present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

keys - Array of web resource names.

assertKeysInTable

public void assertKeysInTable(String tableSummaryOrId,
                              String[] keys,
                              int assertLevel)

Assert that the values of a set of web resources are all present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

keys - Array of web resource names.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTextInTable

public void assertTextInTable(String tableSummaryOrId,
                              String[] text)

Assert that a set of text values are all present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

text - Array of expected text values.

assertTextInTable

public void assertTextInTable(String tableSummaryOrId,
                              String[] text,
                              int assertLevel)

Assert that a set of text values are all present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

text - Array of expected text values.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertKeyNotInTable

public void assertKeyNotInTable(String tableSummaryOrId,
                                String key)

Assert that the value of a given web resource is not present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

key - web resource name

assertKeyNotInTable

public void assertKeyNotInTable(String tableSummaryOrId,
                                String key,
                                int assertLevel)

Assert that the value of a given web resource is not present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

key - web resource name

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTextNotInTable

public void assertTextNotInTable(String tableSummaryOrId,
                                 String text)

Assert that supplied text is not present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

text -

assertTextNotInTable

public void assertTextNotInTable(String tableSummaryOrId,
                                 String text,
                                 int assertLevel)

Assert that supplied text is not present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

text -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTextNotInTable

public void assertTextNotInTable(String tableSummaryOrId,
                                 String[] text)

Assert that none of a set of text values are present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

text - Array of text values

assertTextNotInTable

public void assertTextNotInTable(String tableSummaryOrId,
                                 String[] text,
                                 int assertLevel)

Assert that none of a set of text values are present in a specific table.

Parameters:

tableSummaryOrId - summary or id attribute value of table

text - Array of text values

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTableEquals

public void assertTableEquals(String tableSummaryOrId,
                              net.sourceforge.jwebunit.ExpectedTable expectedTable)

Assert that a specific table matches an ExpectedTable.

Parameters:

tableSummaryOrId - summary or id attribute value of table

expectedTable - represents expected values (colspan supported).

assertTableEquals

public void assertTableEquals(String tableSummaryOrId,
                              net.sourceforge.jwebunit.ExpectedTable expectedTable,
                              int assertLevel)

Assert that a specific table matches an ExpectedTable.

Parameters:

tableSummaryOrId - summary or id attribute value of table

expectedTable - represents expected values (colspan supported).

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTableEquals

public void assertTableEquals(String tableSummaryOrId,
                              String[][] expectedCellValues)

Assert that a specific table matches a matrix of supplied text values.

Parameters:

tableSummaryOrId - summary or id attribute value of table

expectedCellValues - double dimensional array of expected values

assertTableEquals

public void assertTableEquals(String tableSummaryOrId,
                              String[][] expectedCellValues,
                              int assertLevel)

Assert that a specific table matches a matrix of supplied text values.

Parameters:

tableSummaryOrId - summary or id attribute value of table

expectedCellValues - double dimensional array of expected values

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTableRowsEqual

public void assertTableRowsEqual(String tableSummaryOrId,
                                 int startRow,
                                 net.sourceforge.jwebunit.ExpectedTable expectedTable)

Assert that a range of rows for a specific table matches a matrix of supplied text values.

Parameters:

tableSummaryOrId - summary or id attribute value of table

startRow - index of start row for comparison

expectedTable - represents expected values (colspan supported).

assertTableRowsEqual

public void assertTableRowsEqual(String tableSummaryOrId,
                                 int startRow,
                                 net.sourceforge.jwebunit.ExpectedTable expectedTable,
                                 int assertLevel)

Assert that a range of rows for a specific table matches a matrix of supplied text values.

Parameters:

tableSummaryOrId - summary or id attribute value of table

startRow - index of start row for comparison

expectedTable - represents expected values (colspan supported).

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTableRowsEqual

public void assertTableRowsEqual(String tableSummaryOrId,
                                 int startRow,
                                 String[][] expectedCellValues)

Assert that a range of rows for a specific table matches a matrix of supplied text values.

Parameters:

tableSummaryOrId - summary or id attribute value of table

startRow - index of start row for comparison

expectedCellValues - double dimensional array of expected values

assertTableRowsEqual

public void assertTableRowsEqual(String tableSummaryOrId,
                                 int startRow,
                                 String[][] expectedCellValues,
                                 int assertLevel)

Assert that a range of rows for a specific table matches a matrix of supplied text values.

Parameters:

tableSummaryOrId - summary or id attribute value of table

startRow - index of start row for comparison

expectedCellValues - double dimensional array of expected values

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFormElementPresent

public void assertFormElementPresent(String formElementName)

Assert that a form input element with a given name is present.

Parameters:

formElementName -

assertFormElementPresent

public void assertFormElementPresent(String formElementName,
                                     int assertLevel)

Assert that a form input element with a given name is present.

Parameters:

formElementName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFormElementNotPresent

public void assertFormElementNotPresent(String formElementName)

Assert that a form input element with a given name is not present.

Parameters:

formElementName -

assertFormElementNotPresent

public void assertFormElementNotPresent(String formElementName,
                                        int assertLevel)

Assert that a form input element with a given name is not present.

Parameters:

formElementName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFormElementPresentWithLabel

public void assertFormElementPresentWithLabel(String formElementLabel)

Assert that a form input element with a given label is present.

Parameters:

formElementLabel - label preceding form element.

assertFormElementPresentWithLabel

public void assertFormElementPresentWithLabel(String formElementLabel,
                                              int assertLevel)

Assert that a form input element with a given label is present.

Parameters:

formElementLabel - label preceding form element.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFormElementNotPresentWithLabel

public void assertFormElementNotPresentWithLabel(String formElementLabel)

Assert that a form input element with a given label is not present.

Parameters:

formElementLabel - label preceding form element.

assertFormElementNotPresentWithLabel

public void assertFormElementNotPresentWithLabel(String formElementLabel,
                                                 int assertLevel)

Assert that a form input element with a given label is not present.

Parameters:

formElementLabel - label preceding form element.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFormPresent

public void assertFormPresent()

Assert that there is a form present.

assertFormPresent

public void assertFormPresent(int assertLevel)

Assert that there is a form present.

Parameters:

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFormPresent

public void assertFormPresent(String nameOrID)

Assert that there is a form with the specified name or id present.

Parameters:

nameOrID -

assertFormPresent

public void assertFormPresent(String nameOrID,
                              int assertLevel)

Assert that there is a form with the specified name or id present.

Parameters:

nameOrID -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFormElementEquals

public void assertFormElementEquals(String formElementName,
                                    String expectedValue)

Assert that a specific form element has an expected value.

Parameters:

formElementName -

expectedValue -

assertFormElementEquals

public void assertFormElementEquals(String formElementName,
                                    String expectedValue,
                                    int assertLevel)

Assert that a specific form element has an expected value.

Parameters:

formElementName -

expectedValue -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFormElementEmpty

public void assertFormElementEmpty(String formElementName)

Assert that a form element had no value / is empty.

Parameters:

formElementName -

assertFormElementEmpty

public void assertFormElementEmpty(String formElementName,
                                   int assertLevel)

Assert that a form element had no value / is empty.

Parameters:

formElementName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertCheckboxSelected

public void assertCheckboxSelected(String checkBoxName)

Assert that a specific checkbox is selected.

Parameters:

checkBoxName -

assertCheckboxSelected

public void assertCheckboxSelected(String checkBoxName,
                                   int assertLevel)

Assert that a specific checkbox is selected.

Parameters:

checkBoxName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertCheckboxNotSelected

public void assertCheckboxNotSelected(String checkBoxName)

Assert that a specific checkbox is not selected.

Parameters:

checkBoxName -

assertCheckboxNotSelected

public void assertCheckboxNotSelected(String checkBoxName,
                                      int assertLevel)

Assert that a specific checkbox is not selected.

Parameters:

checkBoxName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertRadioOptionPresent

public void assertRadioOptionPresent(String name,
                                     String radioOption)

Assert that a specific option is present in a radio group.

Parameters:

name - radio group name.

radioOption - option to test for.

assertRadioOptionPresent

public void assertRadioOptionPresent(String name,
                                     String radioOption,
                                     int assertLevel)

Assert that a specific option is present in a radio group.

Parameters:

name - radio group name.

radioOption - option to test for.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertRadioOptionNotPresent

public void assertRadioOptionNotPresent(String name,
                                        String radioOption)

Assert that a specific option is not present in a radio group.

Parameters:

name - radio group name.

radioOption - option to test for.

assertRadioOptionNotPresent

public void assertRadioOptionNotPresent(String name,
                                        String radioOption,
                                        int assertLevel)

Assert that a specific option is not present in a radio group.

Parameters:

name - radio group name.

radioOption - option to test for.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertRadioOptionSelected

public void assertRadioOptionSelected(String name,
                                      String radioOption)

Assert that a specific option is selected in a radio group.

Parameters:

name - radio group name.

radioOption - option to test for selection.

assertRadioOptionSelected

public void assertRadioOptionSelected(String name,
                                      String radioOption,
                                      int assertLevel)

Assert that a specific option is selected in a radio group.

Parameters:

name - radio group name.

radioOption - option to test for selection.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertRadioOptionNotSelected

public void assertRadioOptionNotSelected(String name,
                                         String radioOption)

Assert that a specific option is not selected in a radio group.

Parameters:

name - radio group name.

radioOption - option to test for selection.

assertRadioOptionNotSelected

public void assertRadioOptionNotSelected(String name,
                                         String radioOption,
                                         int assertLevel)

Assert that a specific option is not selected in a radio group.

Parameters:

name - radio group name.

radioOption - option to test for selection.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertOptionsEqual

public void assertOptionsEqual(String selectName,
                               String[] expectedOptions)

Assert that the display values of a select element's options match a given array of strings.

Parameters:

selectName - name of the select element.

expectedOptions - expected display values for the select box.

assertOptionsEqual

public void assertOptionsEqual(String selectName,
                               String[] expectedOptions,
                               int assertLevel)

Assert that the display values of a select element's options match a given array of strings.

Parameters:

selectName - name of the select element.

expectedOptions - expected display values for the select box.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertOptionsNotEqual

public void assertOptionsNotEqual(String selectName,
                                  String[] expectedOptions)

Assert that the display values of a select element's options do not match a given array of strings.

Parameters:

selectName - name of the select element.

expectedOptions - expected display values for the select box.

assertOptionsNotEqual

public void assertOptionsNotEqual(String selectName,
                                  String[] expectedOptions,
                                  int assertLevel)

Assert that the display values of a select element's options do not match a given array of strings.

Parameters:

selectName - name of the select element.

expectedOptions - expected display values for the select box.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertOptionValuesEqual

public void assertOptionValuesEqual(String selectName,
                                    String[] expectedValues)

Assert that the values of a select element's options match a given array of strings.

Parameters:

selectName - name of the select element.

expectedValues - expected values for the select box.

assertOptionValuesEqual

public void assertOptionValuesEqual(String selectName,
                                    String[] expectedValues,
                                    int assertLevel)

Assert that the values of a select element's options match a given array of strings.

Parameters:

selectName - name of the select element.

expectedValues - expected values for the select box.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertOptionValuesNotEqual

public void assertOptionValuesNotEqual(String selectName,
                                       String[] optionValues)

Assert that the values of a select element's options do not match a given array of strings.

Parameters:

selectName - name of the select element.

optionValues - expected values for the select box.

assertOptionValuesNotEqual

public void assertOptionValuesNotEqual(String selectName,
                                       String[] optionValues,
                                       int assertLevel)

Assert that the values of a select element's options do not match a given array of strings.

Parameters:

selectName - name of the select element.

optionValues - expected values for the select box.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertOptionEquals

public void assertOptionEquals(String selectName,
                               String option)

Assert that the currently selected display value of a select box matches a given value.

Parameters:

selectName - name of the select element.

option - expected display value of the selected option.

assertOptionEquals

public void assertOptionEquals(String selectName,
                               String option,
                               int assertLevel)

Assert that the currently selected display value of a select box matches a given value.

Parameters:

selectName - name of the select element.

option - expected display value of the selected option.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertSubmitButtonPresent

public void assertSubmitButtonPresent(String buttonName)

Assert that a submit button with a given name is present.

Parameters:

buttonName -

assertSubmitButtonPresent

public void assertSubmitButtonPresent(String buttonName,
                                      int assertLevel)

Assert that a submit button with a given name is present.

Parameters:

buttonName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertSubmitButtonNotPresent

public void assertSubmitButtonNotPresent(String buttonName)

Assert that a submit button with a given name is not present.

Parameters:

buttonName -

assertSubmitButtonNotPresent

public void assertSubmitButtonNotPresent(String buttonName,
                                         int assertLevel)

Assert that a submit button with a given name is not present.

Parameters:

buttonName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertSubmitButtonValue

public void assertSubmitButtonValue(String buttonName,
                                    String expectedValue)

Assert that a submit button with a given name and value is present.

Parameters:

buttonName -

expectedValue -

assertSubmitButtonValue

public void assertSubmitButtonValue(String buttonName,
                                    String expectedValue,
                                    int assertLevel)

Assert that a submit button with a given name and value is present.

Parameters:

buttonName -

expectedValue -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertButtonPresent

public void assertButtonPresent(String buttonId)

Assert that a button with a given id is present.

Parameters:

buttonId -

assertButtonPresent

public void assertButtonPresent(String buttonId,
                                int assertLevel)

Assert that a button with a given id is present.

Parameters:

buttonId -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertButtonNotPresent

public void assertButtonNotPresent(String buttonId)

Assert that a button with a given id is not present.

Parameters:

buttonId -

assertButtonNotPresent

public void assertButtonNotPresent(String buttonId,
                                   int assertLevel)

Assert that a button with a given id is not present.

Parameters:

buttonId -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertLinkPresent

public void assertLinkPresent(String linkId)

Assert that a link with a given id is present in the response.

Parameters:

linkId -

assertLinkPresent

public void assertLinkPresent(String linkId,
                              int assertLevel)

Assert that a link with a given id is present in the response.

Parameters:

linkId -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertLinkNotPresent

public void assertLinkNotPresent(String linkId)

Assert that no link with the given id is present in the response.

Parameters:

linkId -

assertLinkNotPresent

public void assertLinkNotPresent(String linkId,
                                 int assertLevel)

Assert that no link with the given id is present in the response.

Parameters:

linkId -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertLinkPresentWithText

public void assertLinkPresentWithText(String linkText)

Assert that a link containing the supplied text is present.

Parameters:

linkText -

assertLinkPresentWithText

public void assertLinkPresentWithText(String linkText,
                                      int assertLevel)

Assert that a link containing the supplied text is present.

Parameters:

linkText -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertLinkNotPresentWithText

public void assertLinkNotPresentWithText(String linkText)

Assert that no link containing the supplied text is present.

Parameters:

linkText -

assertLinkNotPresentWithText

public void assertLinkNotPresentWithText(String linkText,
                                         int assertLevel)

Assert that no link containing the supplied text is present.

Parameters:

linkText -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertLinkPresentWithImage

public void assertLinkPresentWithImage(String imageFileName)

Assert that a link containing a specified image is present.

Parameters:

imageFileName - A suffix of the image's filename; for example, to match "images/my_icon.png", you could just pass in "my_icon.png".

assertLinkPresentWithImage

public void assertLinkPresentWithImage(String imageFileName,
                                       int assertLevel)

Assert that a link containing a specified image is present.

Parameters:

imageFileName - A suffix of the image's filename; for example, to match "images/my_icon.png", you could just pass in "my_icon.png".

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertLinkNotPresentWithImage

public void assertLinkNotPresentWithImage(String imageFileName)

Assert that a link containing a specified image is not present.

Parameters:

imageFileName - A suffix of the image's filename; for example, to match "images/my_icon.png", you could just pass in "my_icon.png".

assertLinkNotPresentWithImage

public void assertLinkNotPresentWithImage(String imageFileName,
                                          int assertLevel)

Assert that a link containing a specified image is not present.

Parameters:

imageFileName - A suffix of the image's filename; for example, to match "images/my_icon.png", you could just pass in "my_icon.png".

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertElementPresent

public void assertElementPresent(String anID)

Assert that an element with a given id is present.

Parameters:

anID - element id to test for.

assertElementPresent

public void assertElementPresent(String anID,
                                 int assertLevel)

Assert that an element with a given id is present.

Parameters:

anID - element id to test for.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertElementNotPresent

public void assertElementNotPresent(String anID)

Assert that an element with a given id is not present.

Parameters:

anID - element id to test for.

assertElementNotPresent

public void assertElementNotPresent(String anID,
                                    int assertLevel)

Assert that an element with a given id is not present.

Parameters:

anID - element id to test for.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertTextInElement

public void assertTextInElement(String elementID,
                                String text)

Assert that a given element contains specific text.

Parameters:

elementID - id of element to be inspected.

text - to check for.

assertTextInElement

public void assertTextInElement(String elementID,
                                String text,
                                int assertLevel)

Assert that a given element contains specific text.

Parameters:

elementID - id of element to be inspected.

text - to check for.

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertWindowPresent

public void assertWindowPresent(String windowName)

Assert that a window with the given name is open.

Parameters:

windowName -

assertWindowPresent

public void assertWindowPresent(String windowName,
                                int assertLevel)

Assert that a window with the given name is open.

Parameters:

windowName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

assertFramePresent

public void assertFramePresent(String frameName)

Assert that a frame with the given name is present.

Parameters:

frameName -

assertFramePresent

public void assertFramePresent(String frameName,
                               int assertLevel)

Assert that a frame with the given name is present.

Parameters:

frameName -

assertLevel - - Only run this test under the assertLevel as described in AssertLevel

setWorkingForm

public void setWorkingForm(String nameOrId)

Begin interaction with a specified form. If form interaction methods are called without explicitly calling this method first, jWebUnit will attempt to determine itself which form is being manipulated. It is not necessary to call this method if their is only one form on the current page.

Parameters:

nameOrId - name or id of the form to work with.

setFormElement

public void setFormElement(String formElementName,
                           String value)

Set the value of a form input element.

Parameters:

formElementName - name of form element.

value -

checkCheckbox

public void checkCheckbox(String checkBoxName)

Select a specified checkbox.

Parameters:

checkBoxName - name of checkbox to be deselected.

uncheckCheckbox

public void uncheckCheckbox(String checkBoxName)

Deselect a specified checkbox.

Parameters:

checkBoxName - name of checkbox to be deselected.

selectOption

public void selectOption(String selectName,
                         String option)

Select an option with a given display value in a select element.

Parameters:

selectName - name of select element.

option - display value of option to be selected.

submit

public void submit()

Submit form - default submit button will be used (unnamed submit button, or named button if there is only one on the form.

submit

public void submit(String buttonName)

Submit form by pressing named button.

Parameters:

buttonName - name of button to submit form with.

reset

public void reset()

Reset the current form.

clickLinkWithText

public void clickLinkWithText(String linkText)

Navigate by selection of a link containing given text.

Parameters:

linkText -

clickButton

public void clickButton(String buttonId)

Click the button with the given id.

Parameters:

buttonId -

clickLinkWithImage

public void clickLinkWithImage(String imageFileName)

Navigate by selection of a link with a given image.

Parameters:

imageFileName - A suffix of the image's filename; for example, to match "images/my_icon.png", you could just pass in "my_icon.png".

clickLink

public void clickLink(String linkId)

Navigate by selection of a link with given id.

Parameters:

linkId - id of link

gotoWindow

public void gotoWindow(String windowName)

Make a given window active (current response will be window's contents).

Parameters:

windowName -

gotoRootWindow

public void gotoRootWindow()

Make the root window active.

gotoFrame

public void gotoFrame(String frameName)

Make the named frame active (current response will be frame's contents).

Parameters:

frameName -

dumpResponse

public void dumpResponse(PrintStream stream)

Dump html of current response to a specified stream - for debugging purposes.

Parameters:

stream -

dumpTable

public void dumpTable(String tableNameOrId,
                      PrintStream stream)

Dump the table as the 2D array that is used for assertions - for debugging purposes.

Parameters:

tableNameOrId -

stream -

dumpTable

public void dumpTable(String tableNameOrId,
                      String[][] table)

Dump the table as the 2D array that is used for assertions - for debugging purposes.

Parameters:

tableNameOrId -

table -

dumpTable

public void dumpTable(String tableNameOrId,
                      String[][] table,
                      PrintStream stream)

Dump the table as the 2D array that is used for assertions - for debugging purposes.

Parameters:

tableNameOrId -

table -

stream -