com.atlassian.jira.functest.framework.assertions

Class AssertionsImpl

java.lang.Object

com.atlassian.jira.functest.framework.assertions.AssertionsImpl

All Implemented Interfaces:

Assertions

public class AssertionsImpl
extends Object
implements Assertions

Implementation of Assertions

Since:

v3.13

Constructor Summary

Constructors

Constructor and Description
AssertionsImpl(net.sourceforge.jwebunit.WebTester tester, JIRAEnvironmentData environmentData, Navigation navigation, LocatorFactory locator, Backdoor backdoor)

Method Summary

Modifier and Type	Method and Description
void	assertEquals(String failureMessage, List expected, List actual) Elaboration of assertEquals for lists with nicer messages.
void	assertHttpStatusCode(com.atlassian.httpclient.api.HttpStatus code) Check that the last response returned the provided HTTP status code.
void	assertLastChangeHistoryRecords(String issueKey, ExpectedChangeHistoryRecord expectedChangeHistoryRecord) Useful to check that a particular change history item exists for a given issue.
void	assertLastChangeHistoryRecords(String issueKey, List expectedChangeHistoryRecords) Useful to check that a number of change history items exist for a given issue.
void	assertNewestChangeHistoryRecord(String issueKey, String authorName, List<ExpectedChangeHistoryItem> expectedChangeHistoryItems) Useful to check if newest change history entry exists with proper values.
void	assertNodeByIdDoesNotExist(String id) Asserts that a given node does not exists
void	assertNodeByIdDoesNotHaveText(String id, String textToTest) Asserts that a given node exists but does not contain the given text
void	assertNodeByIdEquals(String id, String textToTest) Asserts that a given node exactly equals the given text
void	assertNodeByIdExists(String id) Asserts that a given node exists
void	assertNodeByIdHasText(String id, String textToTest) Asserts that a given node contains the given text
void	assertNodeDoesNotExist(Locator locator) Asserts that a given node does not exists
void	assertNodeDoesNotExist(String xpath) Asserts that a node does not exist under the xpath expression given
void	assertNodeDoesNotHaveText(Locator locator, String textToTest) Asserts that a given node exists but does not contain the given text
void	assertNodeDoesNotHaveText(String xpath, String textToTest) Asserts that a node under the xpath expression given does not contain the given text
void	assertNodeEquals(Locator locator, String textToTest) Asserts that a given node exactly equals the given text
void	assertNodeExists(Locator locator) Asserts that a given node exists
void	assertNodeExists(String xpath) Asserts that a node exists under the xpath expression given
void	assertNodeHasText(Locator locator, String textToTest) Asserts that a given node contains the given text
void	assertNodeHasText(String xpath, String textToTest) Asserts that a node under the xpath expression given contains the given text
void	assertProfileLinkPresent(String id, String linkText) Checks that a profile link with the given ID and link Text exists on the page.
void	assertSubmitButtonPresentWithText(String buttonId, String buttonText) Check that the button with the id provided has the text provided as its value.
CommentAssertions	comments(Iterable<String> comments) Returns an object that can be used to make assertions on a specified group of comments.
CommentAssertions	comments(String... comments) Returns an object that can be used to make assertions on a specified group of comments.
JiraFormAssertions	forms() Form assertions.
DashboardAssertions	getDashboardAssertions()
IssueNavigatorAssertions	getIssueNavigatorAssertions() Return an object that can be used to make assertions about the navigator.
JiraFormAssertions	getJiraFormAssertions()
JiraMessageAssertions	getJiraMessageAssertions()
LabelAssertions	getLabelAssertions()
LinkAssertions	getLinkAssertions()
ProjectFieldsAssertions	getProjectFieldsAssertions()
RequestAssertions	getRequestAssertions()
SidebarAssertions	getSidebarAssertions()
TableAssertions	getTableAssertions()
TextAssertions	getTextAssertions()
URLAssertions	getURLAssertions()
UserAssertions	getUserAssertions()
ViewIssueAssertions	getViewIssueAssertions() Returns an object that can be used to make assertions on the "View Issue" page.
HTMLAssertions	html() HTML assertions.
LinkAssertions	link() Link assertions.
PluginAssertions	plugins() Returns an object that can be used to make assertions about P2 plugins.
TextAssertions	text() Text assertions.

Methods inherited from class java.lang.Object

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

Constructor Detail

AssertionsImpl

@Inject
public AssertionsImpl(net.sourceforge.jwebunit.WebTester tester,
                              JIRAEnvironmentData environmentData,
                              Navigation navigation,
                              LocatorFactory locator,
                              Backdoor backdoor)

Method Detail

assertLastChangeHistoryRecords

public void assertLastChangeHistoryRecords(String issueKey,
                                           ExpectedChangeHistoryRecord expectedChangeHistoryRecord)

Description copied from interface: Assertions

Useful to check that a particular change history item exists for a given issue.

Specified by:

assertLastChangeHistoryRecords in interface Assertions

Parameters:

issueKey - The issue to check

expectedChangeHistoryRecord - A ExpectedChangeHistoryRecord item

assertNewestChangeHistoryRecord

public void assertNewestChangeHistoryRecord(String issueKey,
                                            String authorName,
                                            List<ExpectedChangeHistoryItem> expectedChangeHistoryItems)

Description copied from interface: Assertions

Useful to check if newest change history entry exists with proper values.

Specified by:

assertNewestChangeHistoryRecord in interface Assertions

Parameters:

issueKey - - issue to check history entries in

authorName - - key name of the author

expectedChangeHistoryItems - - A list of ExpectedChangeHistoryItem items

comments

public CommentAssertions comments(Iterable<String> comments)

Description copied from interface: Assertions

Returns an object that can be used to make assertions on a specified group of comments.

Specified by:

comments in interface Assertions

Parameters:

comments - The comments that will be used in the assertions.

Returns:

a {CommentAssertions} object that can be used to make assertions on a specified group of comments.

comments

public CommentAssertions comments(String... comments)

Description copied from interface: Assertions

Returns an object that can be used to make assertions on a specified group of comments.

Specified by:

comments in interface Assertions

Parameters:

comments - The comments that will be used in the assertions.

Returns:

a {CommentAssertions} object that can be used to make assertions on a specified group of comments.

assertLastChangeHistoryRecords

public void assertLastChangeHistoryRecords(String issueKey,
                                           List expectedChangeHistoryRecords)

Description copied from interface: Assertions

Useful to check that a number of change history items exist for a given issue.

Specified by:

assertLastChangeHistoryRecords in interface Assertions

Parameters:

issueKey - The issue to check

expectedChangeHistoryRecords - A list of ExpectedChangeHistoryRecords

html

public HTMLAssertions html()

Description copied from interface: Assertions

HTML assertions.

Specified by:

html in interface Assertions

Returns:

HTML assertions.

text

public TextAssertions text()

Description copied from interface: Assertions

Text assertions. Shortcut for Assertions.getTextAssertions().

Specified by:

text in interface Assertions

Returns:

text assertions.

link

public LinkAssertions link()

Description copied from interface: Assertions

Link assertions. Shortcut for Assertions.getLinkAssertions().

Specified by:

link in interface Assertions

Returns:

link assertions.

forms

public JiraFormAssertions forms()

Description copied from interface: Assertions

Form assertions. Shortcut for Assertions.getJiraFormAssertions().

Specified by:

forms in interface Assertions

Returns:

form assertions

plugins

public PluginAssertions plugins()

Description copied from interface: Assertions

Returns an object that can be used to make assertions about P2 plugins.

Specified by:

plugins in interface Assertions

Returns:

see above

getIssueNavigatorAssertions

public IssueNavigatorAssertions getIssueNavigatorAssertions()

Description copied from interface: Assertions

Return an object that can be used to make assertions about the navigator.

Specified by:

getIssueNavigatorAssertions in interface Assertions

Returns:

an object that can be used to make assertions about the navigator.

getViewIssueAssertions

public ViewIssueAssertions getViewIssueAssertions()

Description copied from interface: Assertions

Returns an object that can be used to make assertions on the "View Issue" page.

It is assumed that you are already on the View Issue page. If not, then use something like navigation.issue().viewIssue("RAT-1") to get to the required Issue.

Specified by:

getViewIssueAssertions in interface Assertions

Returns:

an object that can be used to make assertions on the "View Issue" page.

See Also:

IssueNavigation.viewIssue(String)

getDashboardAssertions

public DashboardAssertions getDashboardAssertions()

Specified by:

getDashboardAssertions in interface Assertions

Returns:

an object that can be used to make assertions about Dashboard pages

getJiraFormAssertions

public JiraFormAssertions getJiraFormAssertions()

Specified by:

getJiraFormAssertions in interface Assertions

Returns:

an object that can be used to make assertions about JIRA forms

getJiraMessageAssertions

public JiraMessageAssertions getJiraMessageAssertions()

Specified by:

getJiraMessageAssertions in interface Assertions

Returns:

an object that can be used to make assertions about JIRA messages

getProjectFieldsAssertions

public ProjectFieldsAssertions getProjectFieldsAssertions()

Specified by:

getProjectFieldsAssertions in interface Assertions

Returns:

an object that can be used to make assertions about Project and Issue Type fields

getURLAssertions

public URLAssertions getURLAssertions()

Specified by:

getURLAssertions in interface Assertions

Returns:

an object that can be used to make assertions about the current JIRA url.

getTextAssertions

public TextAssertions getTextAssertions()

Specified by:

getTextAssertions in interface Assertions

Returns:

an object that can be used for text assertions.

getLinkAssertions

public LinkAssertions getLinkAssertions()

Specified by:

getLinkAssertions in interface Assertions

Returns:

an object that can be used to make assertions about links.

getLabelAssertions

public LabelAssertions getLabelAssertions()

Specified by:

getLabelAssertions in interface Assertions

Returns:

an object that can be used to make assertions about labels.

getTableAssertions

public TableAssertions getTableAssertions()

Specified by:

getTableAssertions in interface Assertions

Returns:

an object that can be used to make assertions about tables.

getUserAssertions

public UserAssertions getUserAssertions()

Specified by:

getUserAssertions in interface Assertions

Returns:

an object that can be used to make assertions about users.

getRequestAssertions

public RequestAssertions getRequestAssertions()

Specified by:

getRequestAssertions in interface Assertions

Returns:

an object that can be used to make assertions about requests, headers etc.

getSidebarAssertions

public SidebarAssertions getSidebarAssertions()

Specified by:

getSidebarAssertions in interface Assertions

Returns:

an object that can be used to make assertions about the sidebar

assertEquals

public void assertEquals(String failureMessage,
                         List expected,
                         List actual)

Elaboration of assertEquals for lists with nicer messages.

Specified by:

assertEquals in interface Assertions

Parameters:

failureMessage - The message (prefix) to use to describe a failure.

expected - the expected list.

actual - the actual list to be tested.

assertProfileLinkPresent

public void assertProfileLinkPresent(String id,
                                     String linkText)

Description copied from interface: Assertions

Checks that a profile link with the given ID and link Text exists on the page. Also clicks the link and checks that the user's profile with linkText shows up.

Specified by:

assertProfileLinkPresent in interface Assertions

Parameters:

id - The id of the profileLink

linkText - The Text of the profileLink (usually the user's full name).

assertNodeByIdExists

public void assertNodeByIdExists(String id)

Description copied from interface: Assertions

Asserts that a given node exists

Specified by:

assertNodeByIdExists in interface Assertions

Parameters:

id - the id of the node

assertNodeByIdDoesNotExist

public void assertNodeByIdDoesNotExist(String id)

Description copied from interface: Assertions

Asserts that a given node does not exists

Specified by:

assertNodeByIdDoesNotExist in interface Assertions

Parameters:

id - the id of the node

assertNodeByIdEquals

public void assertNodeByIdEquals(String id,
                                 String textToTest)

Description copied from interface: Assertions

Asserts that a given node exactly equals the given text

Specified by:

assertNodeByIdEquals in interface Assertions

Parameters:

id - The id of the node to test

textToTest - The text to test for

assertNodeByIdHasText

public void assertNodeByIdHasText(String id,
                                  String textToTest)

Description copied from interface: Assertions

Asserts that a given node contains the given text

Specified by:

assertNodeByIdHasText in interface Assertions

Parameters:

id - The id of the node to test

textToTest - The text to test for

assertNodeByIdDoesNotHaveText

public void assertNodeByIdDoesNotHaveText(String id,
                                          String textToTest)

Description copied from interface: Assertions

Asserts that a given node exists but does not contain the given text

Specified by:

assertNodeByIdDoesNotHaveText in interface Assertions

Parameters:

id - The id of the node to test

textToTest - The text to test for

assertNodeExists

public void assertNodeExists(String xpath)

Description copied from interface: Assertions

Asserts that a node exists under the xpath expression given

Specified by:

assertNodeExists in interface Assertions

Parameters:

xpath - The xpath expression to evaluate

assertNodeDoesNotExist

public void assertNodeDoesNotExist(String xpath)

Description copied from interface: Assertions

Asserts that a node does not exist under the xpath expression given

Specified by:

assertNodeDoesNotExist in interface Assertions

Parameters:

xpath - The xpath expression to evaluate

assertNodeHasText

public void assertNodeHasText(String xpath,
                              String textToTest)

Description copied from interface: Assertions

Asserts that a node under the xpath expression given contains the given text

Specified by:

assertNodeHasText in interface Assertions

Parameters:

xpath - The xpath expression to evaluate

textToTest - The text to test for

assertNodeDoesNotHaveText

public void assertNodeDoesNotHaveText(String xpath,
                                      String textToTest)

Description copied from interface: Assertions

Asserts that a node under the xpath expression given does not contain the given text

Specified by:

assertNodeDoesNotHaveText in interface Assertions

Parameters:

xpath - The xpath expression to evaluate

textToTest - The text to test for

assertNodeExists

public void assertNodeExists(Locator locator)

Description copied from interface: Assertions

Asserts that a given node exists

Specified by:

assertNodeExists in interface Assertions

Parameters:

locator - the locator for the node

assertNodeDoesNotExist

public void assertNodeDoesNotExist(Locator locator)

Description copied from interface: Assertions

Asserts that a given node does not exists

Specified by:

assertNodeDoesNotExist in interface Assertions

Parameters:

locator - the locator for the node

assertNodeEquals

public void assertNodeEquals(Locator locator,
                             String textToTest)

Description copied from interface: Assertions

Asserts that a given node exactly equals the given text

Specified by:

assertNodeEquals in interface Assertions

Parameters:

locator - The locator that contains text

textToTest - The text to test for

assertNodeHasText

public void assertNodeHasText(Locator locator,
                              String textToTest)

Description copied from interface: Assertions

Asserts that a given node contains the given text

Specified by:

assertNodeHasText in interface Assertions

Parameters:

locator - The locator that contains text

textToTest - The text to test for

assertNodeDoesNotHaveText

public void assertNodeDoesNotHaveText(Locator locator,
                                      String textToTest)

Description copied from interface: Assertions

Asserts that a given node exists but does not contain the given text

Specified by:

assertNodeDoesNotHaveText in interface Assertions

Parameters:

locator - The locator to test

textToTest - The text to test for

assertSubmitButtonPresentWithText

public void assertSubmitButtonPresentWithText(String buttonId,
                                              String buttonText)

Description copied from interface: Assertions

Check that the button with the id provided has the text provided as its value.

Specified by:

assertSubmitButtonPresentWithText in interface Assertions

Parameters:

buttonId - The id of the button to locate

buttonText - The text the button should contain as its value

assertHttpStatusCode

public void assertHttpStatusCode(com.atlassian.httpclient.api.HttpStatus code)

Description copied from interface: Assertions

Check that the last response returned the provided HTTP status code.

Specified by:

assertHttpStatusCode in interface Assertions