net.sourceforge.jbizmo.commons.selenium.page.imp.primefaces

Class AbstractViewPageObject

java.lang.Object

net.sourceforge.jbizmo.commons.selenium.page.AbstractPageComponent

net.sourceforge.jbizmo.commons.selenium.page.imp.primefaces.AbstractPrimefacesPageComponent

net.sourceforge.jbizmo.commons.selenium.page.imp.primefaces.AbstractPageObject

net.sourceforge.jbizmo.commons.selenium.page.imp.primefaces.AbstractViewPageObject

Direct Known Subclasses:

AbstractSearchPageObject

public abstract class AbstractViewPageObject
extends AbstractPageObject

Abstract base object for all page objects that represent views

Copyright 2017 (C) by Martin Ganserer

Version:

1.0.0

Author:

Martin Ganserer

Field Summary

Fields

Modifier and Type	Field and Description
protected DataTableComponent	dataTable

Fields inherited from class net.sourceforge.jbizmo.commons.selenium.page.imp.primefaces.AbstractPageObject

BUTTON_ID_LOG_IN, FORM_ID_PREFIX

Fields inherited from class net.sourceforge.jbizmo.commons.selenium.page.AbstractPageComponent

AJAX_POLLING_INTERVAL_MILLISECONDS, ATTR_NAME_CLASS, ATTR_NAME_SELECTED, ATTR_NAME_STYLE, ATTR_NAME_VALUE, driver, HTML_LIST_ITEM, ITEM_DELIMITER, logger, NEW_LINE, ROW_OFFSET_X, ROW_OFFSET_Y, testContext

Constructor Summary

Constructors

Constructor and Description
AbstractViewPageObject(SeleniumTestContext testContext) Constructor

Method Summary

Modifier and Type	Method and Description
<T extends AbstractPageObject> T	clickContextMenuAdd(Class<T> pageClass) Click on the context-menu item 'Add'
void	clickContextMenuCopy(org.openqa.selenium.WebElement rowElement) Click on the context-menu item 'Copy' in order to copy the object that is bound to the given row
<T extends AbstractPageObject> T	clickContextMenuCopy(org.openqa.selenium.WebElement rowElement, Class<T> pageClass) Click on the context-menu item 'Copy' in order to copy the object that is bound to the given row
<T extends AbstractPageObject> T	clickContextMenuCreate(Class<T> pageClass) Click on the context-menu item 'Create'
void	clickContextMenuDelete(org.openqa.selenium.WebElement rowElement) Click on the context-menu item 'Delete' in order to delete the object that is bound to the given row
void	clickContextMenuDownload(org.openqa.selenium.WebElement rowElement) Click on the context-menu item 'Download'
void	clickContextMenuExport() Click on the context-menu item 'Export'
void	clickContextMenuExport(org.openqa.selenium.WebElement rowElement) Click on the context-menu item 'Export'
void	clickContextMenuImport() Click on the context-menu item 'Import'
void	clickContextMenuImport(PageElementTestData testData) Click on the context-menu item 'Import' and upload the file that is defined in the respective test data object
void	clickContextMenuItem(String elementId) Open the context-menu and select an item that is identified by the given ID
void	clickContextMenuItem(org.openqa.selenium.WebElement rowElement, String elementId) Open the context-menu and select an item that is identified by the given ID
<T extends AbstractPageObject> T	clickContextMenuUpdate(org.openqa.selenium.WebElement rowElement, Class<T> pageClass) Click on the context-menu item 'Update'
<T extends AbstractPageObject> T	clickContextMenuView(org.openqa.selenium.WebElement rowElement, Class<T> pageClass) Click on the context-menu item 'View'
void	doubleClickRow(org.openqa.selenium.WebElement rowElement) Perform a double-click on the given row
<T extends AbstractPageObject> T	doubleClickRow(org.openqa.selenium.WebElement rowElement, Class<T> pageClass) Perform a double-click on the given row
protected org.openqa.selenium.WebElement	getFirstRow()
org.openqa.selenium.WebElement	getPaginatorNext()
protected String	getPanelIdPrefix()
org.openqa.selenium.WebElement	getRowByCellValue(String cellValue)
org.openqa.selenium.WebElement	getRowByCellValue(String cellValue, boolean skipPagination)
org.openqa.selenium.WebElement	getRowByObjectId(String objectId)
org.openqa.selenium.WebElement	getRowByObjectId(String objectId, boolean skipPagination)
org.openqa.selenium.WebElement	getRowByRowIndex(int rowIndex)
int	getRowCount()
void	openContextMenu(org.openqa.selenium.WebElement rowElement) Open the context-menu
void	pressRefreshButton() Press the 'Refresh' context-menu item
void	selectRow(org.openqa.selenium.WebElement rowElement) Select a row
void	validateMaxRowCount(PageElementTestData testData) Validate if the number of visible rows in the first page of the table component is smaller (or equal) than a given upper limit
void	validateMinRowCount(PageElementTestData testData) Validate if the number of visible rows in the first page of the table component is greater (or equal) than a given lower limit
void	validateRowCount(PageElementTestData testData) Validate if the number of visible rows in the first page of the table component is equal to the expected row count

Methods inherited from class net.sourceforge.jbizmo.commons.selenium.page.imp.primefaces.AbstractPageObject

buildPageURL, getCheckBoxSelection, open, open, openPageByNavigator, openTabPage, pressBackButton, pressButton, pressLogoutButton, pressSaveButton, pressSaveButton, selectAutoCompleteItem, selectComboboxItem, selectItem, selectLoVItem, setCheckBoxValue, uploadFile, validateAutoCompleteItem, validateCheckBoxValue, validateComboboxItem, validateLabelText, validateLoVItem, validatePageTitle, waitForMessageDialog, waitForNotificationMessage

Methods inherited from class net.sourceforge.jbizmo.commons.selenium.page.imp.primefaces.AbstractPrimefacesPageComponent

createPageObject, waitForPendingAjaxRequests

Methods inherited from class net.sourceforge.jbizmo.commons.selenium.page.AbstractPageComponent

assertEquals, assertNotNull, assertTrue, delayPageLoad, doubleClickElement, fail, fail, findWebElement, findWebElement, findWebElementByXPath, findWebElementsByXPath, getDriver, getLogger, getTestContext, moveToElement, scrollTo, setInputFieldValue, setLogger, validateInputFieldValue, waitUntilVisible

Methods inherited from class java.lang.Object

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

Field Detail

dataTable

protected DataTableComponent dataTable

Constructor Detail

AbstractViewPageObject

public AbstractViewPageObject(SeleniumTestContext testContext)

Constructor

Parameters:

testContext -

Method Detail

pressRefreshButton

public void pressRefreshButton()

Press the 'Refresh' context-menu item

Throws:

AssertionError - if the context-menu item could not be found

doubleClickRow

public <T extends AbstractPageObject> T doubleClickRow(org.openqa.selenium.WebElement rowElement,
                                                       Class<T> pageClass)

Perform a double-click on the given row

Type Parameters:

T - the type of the page object to be returned

Parameters:

rowElement -

pageClass -

Returns:

an instance of the selected page class

Throws:

AssertionError - if the page object either could not be created, or the parameter rowElement is null

doubleClickRow

public void doubleClickRow(org.openqa.selenium.WebElement rowElement)

Perform a double-click on the given row

Parameters:

rowElement -

Throws:

AssertionError - if the parameter rowElement is null

selectRow

public void selectRow(org.openqa.selenium.WebElement rowElement)

Select a row

Parameters:

rowElement -

Throws:

AssertionError - if the parameter rowElement is null

getRowByRowIndex

public org.openqa.selenium.WebElement getRowByRowIndex(int rowIndex)

Parameters:

rowIndex -

Returns:

the row with the given index or null if a row could not be found

Throws:

AssertionError - if the row either could not be found, or the row index is smaller than 1

getRowByObjectId

public org.openqa.selenium.WebElement getRowByObjectId(String objectId,
                                                       boolean skipPagination)

Parameters:

objectId -

skipPagination - if set to true searching in subsequent pages will be skipped

Returns:

the row with the given object ID or null if the row could not be found

Throws:

AssertionError - if the parameter objectId is null or empty

getRowByObjectId

public org.openqa.selenium.WebElement getRowByObjectId(String objectId)

Parameters:

objectId -

Returns:

the row with the given object ID or null if the row could not be found

Throws:

AssertionError - if the parameter objectId is null or empty

getRowByCellValue

public org.openqa.selenium.WebElement getRowByCellValue(String cellValue,
                                                        boolean skipPagination)

Parameters:

cellValue -

skipPagination - if set to true searching in subsequent pages will be skipped

Returns:

the first row that contains a cell with the given value or null if an appropriate row could not be found

Throws:

AssertionError - if the parameter cellValue is null or empty

getRowByCellValue

public org.openqa.selenium.WebElement getRowByCellValue(String cellValue)

Parameters:

cellValue -

Returns:

the first row that contains a cell with the given value or null if an appropriate row could not be found

Throws:

AssertionError - if the parameter cellValue is null or empty

getRowCount

public int getRowCount()

Returns:

the number of rows displayed in the current page

Throws:

AssertionError - if the table element could not be found

validateRowCount

public void validateRowCount(PageElementTestData testData)

Validate if the number of visible rows in the first page of the table component is equal to the expected row count

Parameters:

testData -

Throws:

AssertionError - if the validation either has failed, or the expected row count could not be determined

validateMinRowCount

public void validateMinRowCount(PageElementTestData testData)

Validate if the number of visible rows in the first page of the table component is greater (or equal) than a given lower limit

Parameters:

testData -

Throws:

AssertionError - if the validation either has failed, or the expected row count could not be determined

validateMaxRowCount

public void validateMaxRowCount(PageElementTestData testData)

Validate if the number of visible rows in the first page of the table component is smaller (or equal) than a given upper limit

Parameters:

testData -

Throws:

AssertionError - if the validation either has failed, or the expected row count could not be determined

getPaginatorNext

public org.openqa.selenium.WebElement getPaginatorNext()

Returns:

the element that represents the 'Next Page' button or null if it could not be found

openContextMenu

public void openContextMenu(org.openqa.selenium.WebElement rowElement)

Open the context-menu

Parameters:

rowElement -

Throws:

AssertionError - if the context-menu either could not be found, or the parameter rowElement is null

clickContextMenuItem

public void clickContextMenuItem(org.openqa.selenium.WebElement rowElement,
                                 String elementId)

Open the context-menu and select an item that is identified by the given ID

Parameters:

rowElement -

elementId -

Throws:

AssertionError - if the context-menu item either could not be found, or the parameter rowElement is null

clickContextMenuItem

public void clickContextMenuItem(String elementId)

Open the context-menu and select an item that is identified by the given ID

Parameters:

elementId -

Throws:

AssertionError - if the context-menu item could not be found

clickContextMenuDelete

public void clickContextMenuDelete(org.openqa.selenium.WebElement rowElement)

Click on the context-menu item 'Delete' in order to delete the object that is bound to the given row

Parameters:

rowElement -

Throws:

AssertionError - if an element either could not be found, or the parameter rowElement is null

clickContextMenuCopy

public <T extends AbstractPageObject> T clickContextMenuCopy(org.openqa.selenium.WebElement rowElement,
                                                             Class<T> pageClass)

Click on the context-menu item 'Copy' in order to copy the object that is bound to the given row

Type Parameters:

T - the type of the page object to be returned

Parameters:

rowElement -

pageClass -

Returns:

an instance of the selected page class

Throws:

AssertionError - if the page object either could not be created, or an element could not be found

clickContextMenuCopy

public void clickContextMenuCopy(org.openqa.selenium.WebElement rowElement)

Click on the context-menu item 'Copy' in order to copy the object that is bound to the given row

Parameters:

rowElement -

Throws:

AssertionError - if an element either could not be found, or the parameter rowElement is null

clickContextMenuCreate

public <T extends AbstractPageObject> T clickContextMenuCreate(Class<T> pageClass)

Click on the context-menu item 'Create'

Type Parameters:

T - the type of the page object to be returned

Parameters:

pageClass -

Returns:

an instance of the selected page class

Throws:

AssertionError - if the page object either could not be created, or the context-menu item could not be found

clickContextMenuAdd

public <T extends AbstractPageObject> T clickContextMenuAdd(Class<T> pageClass)

Click on the context-menu item 'Add'

Type Parameters:

T - the type of the page object to be returned

Parameters:

pageClass -

Returns:

an instance of the selected page class

Throws:

AssertionError - if the page object either could not be created, or the context-menu item could not be found

clickContextMenuUpdate

public <T extends AbstractPageObject> T clickContextMenuUpdate(org.openqa.selenium.WebElement rowElement,
                                                               Class<T> pageClass)

Click on the context-menu item 'Update'

Type Parameters:

T - the type of the page object to be returned

Parameters:

pageClass -

rowElement -

Returns:

an instance of the selected page class

Throws:

AssertionError - if the page object either could not be created, or the context-menu item could not be found

clickContextMenuView

public <T extends AbstractPageObject> T clickContextMenuView(org.openqa.selenium.WebElement rowElement,
                                                             Class<T> pageClass)

Click on the context-menu item 'View'

Type Parameters:

T - the type of the page object to be returned

Parameters:

pageClass -

rowElement -

Returns:

an instance of the selected page class

Throws:

AssertionError - if the page object either could not be created, or the context-menu item could not be found

clickContextMenuImport

public void clickContextMenuImport()

Click on the context-menu item 'Import'

Throws:

AssertionError - if the context-menu item could not be found

clickContextMenuImport

public void clickContextMenuImport(PageElementTestData testData)

Click on the context-menu item 'Import' and upload the file that is defined in the respective test data object

Parameters:

testData - the test data object that provides the absolute path to the import file

Throws:

AssertionError - if an element either could not be found, or test data is invalid

clickContextMenuExport

public void clickContextMenuExport(org.openqa.selenium.WebElement rowElement)

Click on the context-menu item 'Export'

Parameters:

rowElement -

Throws:

AssertionError - if the context-menu item either could not be found, or the parameter rowElement is null

clickContextMenuExport

public void clickContextMenuExport()

Click on the context-menu item 'Export'

Throws:

AssertionError - if the context-menu item could not be found

clickContextMenuDownload

public void clickContextMenuDownload(org.openqa.selenium.WebElement rowElement)

Click on the context-menu item 'Download'

Parameters:

rowElement -

Throws:

AssertionError - if the context-menu item either could not be found, or the parameter rowElement is null

getPanelIdPrefix

protected String getPanelIdPrefix()

Returns:

the panel ID prefix

getFirstRow

protected org.openqa.selenium.WebElement getFirstRow()

Returns:

the first row of the data table