com.atlassian.jira.webtests
Class AbstractAtlassianWebTestCase

java.lang.Object
  junit.framework.Assert
      junit.framework.TestCase
          net.sourceforge.jwebunit.WebTestCase
              com.atlassian.jira.webtests.WebTestCaseWrapper
                  com.atlassian.jira.webtests.AbstractAtlassianWebTestCase

All Implemented Interfaces:

junit.framework.Test

Direct Known Subclasses:

JIRAWebTest

public class AbstractAtlassianWebTestCase
extends WebTestCaseWrapper

This super class provides extensions to JWebUnit useful in acceptance tests.

Field Summary

Fields inherited from class net.sourceforge.jwebunit.WebTestCase

tester

Method Summary

protected void	assertCollapsedTextSequence(String[] textSequence) Asserts that the text sequence occurs somewhere in the document in the order specified.
protected void	assertLessThan(int a, int b) Makes a junit assertion that a is less than b.
protected void	assertLinkWithNameExists(String linkName)
protected void	assertLinkWithNameNotPresent(String linkName)
protected void	assertLinkWithTextExists(String linkText)
protected void	assertLinkWithTextNotPresent(String linkText)
void	assertTextPresent(String text1, int numOccurrences) Deprecated. please use TextAssertions.assertTextPresentNumOccurences(String, String, int)
void	assertTextPresentAfterText(String after, String before) Asserts that the given String after occurs *after* the given String before.
void	assertTextPresentBeforeText(String before, String after) Asserts that the given String before occurs *before* the given String after.
protected void	assertTextPresentOnlyOnce(String text1)
void	assertTextSequence(String[] text) Asserts that the array of strings appears in the given order in the current response body.
void	assertTextSequence(String failMesgPrefix, String[] text) Asserts that the array of strings appears in the given order in the response body, on failure, using failMesgPrefix as a prefix on the assertion failure message.
protected void	clickAnyButtonWithValue(String value) Click the first button you find with the given value.
protected void	clickButtonWithValue(String value) Click only a single button with the specific value.
static int	findTextSequence(String stringToSearch, String[] sequenceToFind) Attempts to find the given sequence in the given string and if it fails to find the sequence, returns the index in the sequence that it failed to find a match for.
static String[]	flattenArray(String[][] text) Utility method that flattens a 2d array into a 1d array by stringing each inner array together in their outer array order.
protected String	getCollapsedResponseText() Returns all the text nodes of the web response collapsed and then concatenated together.
com.meterware.httpunit.WebTable	getFirstWebTableWithClass(String className) Gets the first table on the current page that has the given class attribute.
protected String	getResponseText()
com.meterware.httpunit.WebTable[]	getWebTablesWithClass(String className) Gets the tables on the current page that have the given class attribute.
com.meterware.httpunit.WebTable	getWebTableWithID(String id) Gets the table on the current page that has the given ID.
protected boolean	hasLinkWithName(String linkName)
protected boolean	hasLinkWithText(String linkText)

Methods inherited from class com.atlassian.jira.webtests.WebTestCaseWrapper

assertElementNotPresent, assertElementPresent, assertOptionValueNotPresent, assertOptionValuePresent, assertTextInTable, assertTextNotPresent, assertTextPresent, clickCancelButton, dumpResponse, dumpResponse, log, log, log, logSection, raiseRuntimeException, selectMultiOption, selectMultiOptionByValue, selectOption, submit, tearDown

Methods inherited from class net.sourceforge.jwebunit.WebTestCase

assertButtonNotPresent, assertButtonPresent, assertCheckboxNotSelected, assertCheckboxSelected, assertCookiePresent, assertCookieValueEquals, assertFormElementEmpty, assertFormElementEquals, assertFormElementNotPresent, assertFormElementNotPresentWithLabel, assertFormElementPresent, assertFormElementPresentWithLabel, assertFormNotPresent, assertFormNotPresent, assertFormPresent, assertFormPresent, assertFramePresent, assertKeyInTable, assertKeyNotInTable, assertKeyNotPresent, assertKeyPresent, assertKeysInTable, assertLinkNotPresent, assertLinkNotPresentWithImage, assertLinkNotPresentWithText, assertLinkNotPresentWithText, assertLinkPresent, assertLinkPresentWithImage, assertLinkPresentWithText, assertLinkPresentWithText, assertOptionEquals, assertOptionsEqual, assertOptionsNotEqual, assertOptionValuesEqual, assertOptionValuesNotEqual, assertRadioOptionNotPresent, assertRadioOptionNotSelected, assertRadioOptionPresent, assertRadioOptionSelected, assertSubmitButtonNotPresent, assertSubmitButtonPresent, assertSubmitButtonValue, assertTableEquals, assertTableEquals, assertTableNotPresent, assertTablePresent, assertTableRowsEqual, assertTableRowsEqual, assertTextInElement, assertTextInTable, assertTextNotInElement, assertTextNotInTable, assertTextNotInTable, assertTitleEquals, assertTitleEqualsKey, assertWindowPresent, beginAt, checkCheckbox, checkCheckbox, clickButton, clickLink, clickLinkWithImage, clickLinkWithText, clickLinkWithText, clickLinkWithTextAfterText, dumpCookies, dumpCookies, dumpResponse, dumpTable, dumpTable, getDialog, getMessage, getTestContext, getTester, gotoFrame, gotoPage, gotoRootWindow, gotoWindow, reset, setFormElement, setFormElementWithLabel, setWorkingForm, submit, uncheckCheckbox, uncheckCheckbox

Methods inherited from class junit.framework.TestCase

countTestCases, createResult, getName, run, run, runBare, runTest, setName, setUp, toString

Methods inherited from class junit.framework.Assert

assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, fail, fail, failNotEquals, failNotSame, failSame, format

Methods inherited from class java.lang.Object

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

Method Detail

clickButtonWithValue

protected void clickButtonWithValue(String value)

Click only a single button with the specific value. If more than one button found with that value it will barf.

Parameters:

value - the value attribute of the of the button element to click.

clickAnyButtonWithValue

protected void clickAnyButtonWithValue(String value)

Click the first button you find with the given value. Ignores duplicate values.

Parameters:

value - the value attribute of the of the button element to click.

hasLinkWithText

protected boolean hasLinkWithText(String linkText)

hasLinkWithName

protected boolean hasLinkWithName(String linkName)

assertLinkWithTextExists

protected void assertLinkWithTextExists(String linkText)

assertLinkWithTextNotPresent

protected void assertLinkWithTextNotPresent(String linkText)

assertLinkWithNameExists

protected void assertLinkWithNameExists(String linkName)

assertLinkWithNameNotPresent

protected void assertLinkWithNameNotPresent(String linkName)

assertTextPresentBeforeText

public void assertTextPresentBeforeText(String before,
                                        String after)

Asserts that the given String before occurs *before* the given String after.

Parameters:

before - supposed to come before the other.

after - supposed to come after the other.

assertTextPresentOnlyOnce

protected void assertTextPresentOnlyOnce(String text1)

assertTextPresent

public void assertTextPresent(String text1,
                              int numOccurrences)

Deprecated. please use TextAssertions.assertTextPresentNumOccurences(String, String, int)

Asserts that the specified text appears in the response text an exact number of times

Parameters:

text1 - the text to search for

numOccurrences - the number of times the text should occur. Must not be negative.

assertTextPresentAfterText

public void assertTextPresentAfterText(String after,
                                       String before)

Asserts that the given String after occurs *after* the given String before.

Parameters:

after - supposed to come after the other.

before - supposed to come before the other.

assertLessThan

protected void assertLessThan(int a,
                              int b)

Makes a junit assertion that a is less than b.

Note: Don't remove this method. It is used by the soapclient tests!

Parameters:

a - asserted to be the smaller.

b - asserted to be the greater.

assertTextSequence

public void assertTextSequence(String[] text)

Asserts that the array of strings appears in the given order in the current response body.

Parameters:

text - the sequence to assert is present.

assertTextSequence

public void assertTextSequence(String failMesgPrefix,
                               String[] text)

Asserts that the array of strings appears in the given order in the response body, on failure, using failMesgPrefix as a prefix on the assertion failure message.

Parameters:

failMesgPrefix - the message prefix in the case of a failure.

text - the array.

findTextSequence

public static int findTextSequence(String stringToSearch,
                                   String[] sequenceToFind)

Attempts to find the given sequence in the given string and if it fails to find the sequence, returns the index in the sequence that it failed to find a match for. If the sequence is present, returns -1.

Parameters:

stringToSearch - the String to search.

sequenceToFind - the sequence to search for.

Returns:

-1 if sequence is found, otherwise the index in sequenceToFind of the first text that was not found in position.

flattenArray

public static String[] flattenArray(String[][] text)

Utility method that flattens a 2d array into a 1d array by stringing each inner array together in their outer array order. E.g. a 2d array {{1,2},{3,4}} would become {1,2,3,4}. TODO: find me a new home

Parameters:

text - the 2d array to flatten

Returns:

the flattened array.

getResponseText

protected String getResponseText()

getCollapsedResponseText

protected String getCollapsedResponseText()

Returns all the text nodes of the web response collapsed and then concatenated together. Very useful for text sequence detection when you don care about intermediate Elements such as anchors and spans.

Returns:

all the text nodes of the web respone collapsed and then concatenated together

assertCollapsedTextSequence

protected void assertCollapsedTextSequence(String[] textSequence)

Asserts that the text sequence occurs somewhere in the document in the order specified. It also uses the collapsed text nodes of the page response.

Parameters:

textSequence - the text sequence

getFirstWebTableWithClass

public com.meterware.httpunit.WebTable getFirstWebTableWithClass(String className)

Gets the first table on the current page that has the given class attribute.

Parameters:

className - the name of the class attribute of the desired table element.

Returns:

the tables.

getWebTableWithID

public com.meterware.httpunit.WebTable getWebTableWithID(String id)

Gets the table on the current page that has the given ID.

Parameters:

id - ID of the required table element.

Returns:

The table on the current page that has the given ID.

getWebTablesWithClass

public com.meterware.httpunit.WebTable[] getWebTablesWithClass(String className)

Gets the tables on the current page that have the given class attribute.

Parameters:

className - the name of the class attribute of the desired table element.

Returns:

the tables.