com.whitestein.lsps.test.web

Class UITester

java.lang.Object

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

com.whitestein.lsps.test.web.UITester

Direct Known Subclasses:

UIDefaultAppTester

public class UITester
extends UIFinder

Helper for testing of the LSPS application. A generic tester, which should work on any app containing LSPS forms. For testing the Default Application, the class has additional utility methods.

When writing tests:

• Consider calling LspsRemote.unloadAllModules() in @Before and @After method
• Upload the testing model in the @Before method
• log in (for example by calling UIDefaultAppTester.login(String, String)) in the @Before method
• In the test method, just use this object to lookup UI components by ID

Example of your test case:

     public static class MyTest {
             // initializes the helper class
             protected UITester app = new UITester(new FirefoxDriver());
             // this will make a screenshot of the page on test failure
             @Rule
             public ScreenshotOnFailureRule screenshotOnFailureRule = new ScreenshotOnFailureRule(app, true);
             @Before
             public void prepare() {
                 LspsRemote.unloadAllModules();
                 app.login();
             }
             @After
             public void cleanup() {
                 LspsRemote.unloadAllModules();
             }
             @Test
             public void myTest() {
                 LspsRemote.uploadModule("mymodule", "1.0");
                 app.runModel("mymodule");
                 app.openTodo("mytodo");
                 final LspsTextBox name = app.find("NAME").as().textBox();
                 ...
             }
     }
 

Note that the tester framework uses Vaadin TestBench. To use this framework, you need to obtain the TestBench license first.

Author:

mvy

Field Summary

Fields

Modifier and Type	Field and Description
String	contextRoot Context root where the Vaadin Default app is deployed.

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

context

Constructor Summary

Constructors

Constructor and Description
UITester(WebDriver driver) Deprecated. use UIDefaultAppTester.UIDefaultAppTester(WebDriver).
UITester(WebDriver driver, String contextRoot)

Method Summary

Modifier and Type	Method and Description
void	assertDocumentTitles(String... titles) Asserts that there are the following documents available to the current user.
void	assertUserSeesDocument(String documentName) Checks that the currently logged-in user is able to open given document.
protected static void	closeMenu(MenuBarElement menu)
List<DocumentInfo>	getDocuments() Returns a list of documents displayed for the currently logged-in user.
List<String>	getDocumentTitles() Returns the titles of a list of document displayed for the currently logged-in user.
protected TestPerson	getLoggedInPerson()
List<Todo>	getTodoList() Obtains a complete list of TODOs for the currently logged-in user.
void	login() Deprecated. call UIDefaultAppTester.loginAdminAdminAndWait() instead.
static By	menuItemById(String titleKey) Returns a locator for given menu item.
protected void	mockLogIn(TestPerson login, String password) When your app differs greatly from the default app and UIDefaultAppTester.login(String, String) wouldn't work, you can log in via your custom TestBench/Selenium code.
protected void	mockLogout() When your app differs greatly from the default app and UIDefaultAppTester.logout() wouldn't work, you can log in via your custom TestBench/Selenium code.
void	openTodo(String todoTitle) Deprecated. call UIDefaultAppTester.openTodo(String) instead.
ModelInstance	runModel(String modelName) Deprecated. call UIDefaultAppTester.runModel(String) instead.
void	waitForElementPresent(By by) Wait till element described by descriptor by appears

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

$, clickButton, contains, find, findAll, getDriver, toString, waitForVaadin

Methods inherited from class java.lang.Object

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

Field Detail

contextRoot

public final String contextRoot

Context root where the Vaadin Default app is deployed. For example "lsps-application"

Constructor Detail

UITester

@Deprecated
public UITester(WebDriver driver)

Deprecated. use UIDefaultAppTester.UIDefaultAppTester(WebDriver).

Parameters:

driver - the web driver to

UITester

public UITester(WebDriver driver,
                String contextRoot)

Method Detail

waitForElementPresent

public void waitForElementPresent(By by)

Wait till element described by descriptor by appears

Parameters:

by -

menuItemById

public static By menuItemById(String titleKey)

Returns a locator for given menu item.

Note that if you wish to activate a sub-menu-item, you will need to click on its parent first, to unravel the menu item itself.

Parameters:

titleKey - the title key as given to the NavigationMenu class

Returns:

the Selenium locator which locates the menu item, not null.

closeMenu

protected static void closeMenu(MenuBarElement menu)

mockLogIn

protected void mockLogIn(TestPerson login,
                         String password)

When your app differs greatly from the default app and UIDefaultAppTester.login(String, String) wouldn't work, you can log in via your custom TestBench/Selenium code. Then, just call this function in order for other functions (such as getTodoList()) to work properly.

Parameters:

login -

password -

mockLogout

protected void mockLogout()

When your app differs greatly from the default app and UIDefaultAppTester.logout() wouldn't work, you can log in via your custom TestBench/Selenium code. Then, just call this function in order for other functions (such as getTodoList()) to work properly.

getLoggedInPerson

protected TestPerson getLoggedInPerson()

getTodoList

public List<Todo> getTodoList()

Obtains a complete list of TODOs for the currently logged-in user. The list is obtained via webservices.

Returns:

a list of TODOs, not null, may be empty.

Throws:

IllegalStateException - if no user is currently logged in via mockLogIn(TestPerson, String).

getDocuments

public List<DocumentInfo> getDocuments()

Returns a list of documents displayed for the currently logged-in user. The list is obtained via webservices.

Returns:

document list, not null, may be empty.

getDocumentTitles

public List<String> getDocumentTitles()

Returns the titles of a list of document displayed for the currently logged-in user. The list is obtained via webservices.

Returns:

document list, not null, may be empty.

assertUserSeesDocument

public void assertUserSeesDocument(String documentName)

Checks that the currently logged-in user is able to open given document.

Parameters:

documentName - the document name, not null.

Throws:

AssertionError - if getDocuments() does not contain given document.

login

@Deprecated
public void login()

Deprecated. call UIDefaultAppTester.loginAdminAdminAndWait() instead.

This method only works on the Default Application. Please use UIDefaultAppTester.loginAdminAdminAndWait() instead.

openTodo

@Deprecated
public void openTodo(String todoTitle)

Deprecated. call UIDefaultAppTester.openTodo(String) instead.

This method only works on the Default Application. Please use UIDefaultAppTester.openTodo(String) instead.

Parameters:

todoTitle -

runModel

@Deprecated
public ModelInstance runModel(String modelName)

Deprecated. call UIDefaultAppTester.runModel(String) instead.

This method only works on the Default Application. Please use UIDefaultAppTester.runModel(String) instead.

Parameters:

modelName -

Returns:

model instance id

assertDocumentTitles

public void assertDocumentTitles(String... titles)

Asserts that there are the following documents available to the current user.

Parameters:

titles - the expected document titles, not null.