com.whitestein.lsps.test.web

Class UIDefaultAppTester

java.lang.Object

com.whitestein.lsps.test.web.components.UIFinder

com.whitestein.lsps.test.web.UITester

com.whitestein.lsps.test.web.UIDefaultAppTester

public class UIDefaultAppTester
extends UITester

Adds support for the "Default application" UI items (menus, todo list, Document list, etc). Cannot be used on heavily tuned apps.

Author:

mvy

Field Summary

Fields inherited from class com.whitestein.lsps.test.web.UITester

contextRoot

Fields inherited from class com.whitestein.lsps.test.web.components.UIFinder

context

Constructor Summary

Constructors

Constructor and Description
UIDefaultAppTester(WebDriver driver)
UIDefaultAppTester(WebDriver driver, String contextRoot)
UIDefaultAppTester(WebDriver driver, String contextRoot, int implicitWaitSeconds, int pageLoadTimeoutSeconds, int scriptTimeoutSeconds)

Method Summary

Modifier and Type	Method and Description
protected void	awaitFullyLoggedIn()
String	getCurrentDocumentTitle() Returns the current document title.
String	getCurrentTodoTitle() Returns the current todo title.
long	getLoginTimeOutInSeconds()
boolean	isCurrentPageDocument() Checks if the currently shown page is a document.
boolean	isCurrentPageDocuments() Checks if the application is currently showing the "Document List" page.
boolean	isCurrentPageRunModel() Checks if the application is currently showing the "Run Model" page.
boolean	isCurrentPageTodo() Checks if the currently shown page is a todo.
boolean	isCurrentPageTodoList() Checks if the application is currently showing the "Todo List" page.
boolean	isLoggedIn()
void	login(String name, String password) Login to the default application, as given user, but does not wait for the login to succeed.
void	loginAdminAdminAndWait() Login to the default application, as admin/admin, Awaits until the Vaadin application fully boots.
void	loginAndWait(String name, String password) Login to the default application, as given user.
void	logout() Logout from process console.
void	openDocument(String documentTitle) Goes to the 'Documents' page and opens document based on its title.
void	openDocuments() Opens the page with the document list.
void	openRunModel() Opens the "Run Model" page.
void	openTodo(String todoTitle) Goes to todo list and opens todo based on its title.
void	openTodoList() Opens the todo list page.
void	openUrl(String url, By anyElementId) Open an arbitrary url and waits until expected element shows up.
ModelInstance	runModel(String modelName) Runs model based on modelName and return model instance id
void	setLoginTimeOutInSeconds(long loginTimeOutInSeconds)

Methods inherited from class com.whitestein.lsps.test.web.UITester

assertDocumentTitles, assertUserSeesDocument, closeMenu, getDocuments, getDocumentTitles, getLoggedInPerson, getRemote, getTodoList, menuItemById, mockLogIn, mockLogout, waitForAttributeToBe, waitForElementPresent, waitForElementPresent

Methods inherited from class com.whitestein.lsps.test.web.components.UIFinder

$, actions, clickButton, contains, createIdLocator, findAllByAttributeValue, findAllByClassname, findAllByFormId, findAllById, findAllByIdPrefix, findAllByLspsId, findAllByTextContent, findAllByXpath, findByAttributeValue, findByClassname, findByFormId, findById, findByIdPrefix, findByLspsId, findByTextContent, findByXpath, findCaptionByTextContent, findElement, findElements, findNthByTag, getDriver, getLspsCommandExecutor, toString, waitForVaadin, webElementsByExactTextContent, webElementsByFormId, webElementsById, webElementsByIdPrefix, webElementsByLspsFormId, webElementsByLspsId, webElementsByTextContent, webElementsByXpath

Methods inherited from class java.lang.Object

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

Constructor Detail

UIDefaultAppTester

public UIDefaultAppTester(WebDriver driver)

UIDefaultAppTester

public UIDefaultAppTester(WebDriver driver,
                          String contextRoot)

UIDefaultAppTester

public UIDefaultAppTester(WebDriver driver,
                          String contextRoot,
                          int implicitWaitSeconds,
                          int pageLoadTimeoutSeconds,
                          int scriptTimeoutSeconds)

Method Detail

loginAdminAdminAndWait

public void loginAdminAdminAndWait()

Login to the default application, as admin/admin, Awaits until the Vaadin application fully boots.

loginAndWait

public void loginAndWait(String name,
                         String password)

Login to the default application, as given user. Awaits until the Vaadin application fully boots.

Parameters:

name - the user name, not null

password - the password, not null.

login

public void login(String name,
                  String password)

Login to the default application, as given user, but does not wait for the login to succeed. Use this only when testing login with invalid username/password.

Parameters:

name - the user name, not null

password - the password, not null.

awaitFullyLoggedIn

protected void awaitFullyLoggedIn()

isLoggedIn

public boolean isLoggedIn()

Returns:

true if user is logged in - screen contains application instead of login screen

isCurrentPageDocuments

public boolean isCurrentPageDocuments()

Checks if the application is currently showing the "Document List" page.

Returns:

true if the app is currently showing the document list page, false if it is showing e.g. a particular document, or a todo list, or something else.

isCurrentPageRunModel

public boolean isCurrentPageRunModel()

Checks if the application is currently showing the "Run Model" page.

Returns:

true if the app is currently showing the run model page.

isCurrentPageTodoList

public boolean isCurrentPageTodoList()

Checks if the application is currently showing the "Todo List" page.

Returns:

true if the app is currently showing the todo list page.

openTodo

public void openTodo(String todoTitle)

Goes to todo list and opens todo based on its title. The function fails if the UI expression fails to evaluate.

Overrides:

openTodo in class UITester

Parameters:

todoTitle - the exact todo title.

Throws:

RuntimeException - if the UI expression fails to evaluate.

runModel

public ModelInstance runModel(String modelName)

Runs model based on modelName and return model instance id

Overrides:

runModel in class UITester

Parameters:

modelName -

Returns:

model instance id

openRunModel

public void openRunModel()

Opens the "Run Model" page.

openDocument

public void openDocument(String documentTitle)

Goes to the 'Documents' page and opens document based on its title. The function fails if the UI expression fails to evaluate.

Parameters:

documentTitle -

Throws:

RuntimeException - if the UI expression fails to evaluate.

openDocuments

public void openDocuments()

Opens the page with the document list.

logout

public void logout()

Logout from process console.

isCurrentPageDocument

public boolean isCurrentPageDocument()

Checks if the currently shown page is a document.

Returns:

true if the current page is a document, false if the current page is, say, a document list page, a todo, a todo list page, etc.

getCurrentDocumentTitle

public String getCurrentDocumentTitle()

Returns the current document title. WARNING: the document title is retrieved uppercase.

Returns:

the current document title or null if no document is currently displayed (isCurrentPageDocument() returns false).

getCurrentTodoTitle

public String getCurrentTodoTitle()

Returns the current todo title. WARNING: the todo title is retrieved uppercase.

Returns:

the current todo title or null if no todo is currently displayed (isCurrentPageTodo() returns false).

isCurrentPageTodo

public boolean isCurrentPageTodo()

Checks if the currently shown page is a todo.

Returns:

true if the current page is a todo, false if the current page is, say, a document list page, a document, a todo list page, etc.

openTodoList

public void openTodoList()

Opens the todo list page.

openUrl

public void openUrl(String url,
                    By anyElementId)

Open an arbitrary url and waits until expected element shows up.

Parameters:

url -

anyElementId -

getLoginTimeOutInSeconds

public long getLoginTimeOutInSeconds()

setLoginTimeOutInSeconds

public void setLoginTimeOutInSeconds(long loginTimeOutInSeconds)