org.nuxeo.functionaltests

Class AbstractTest

java.lang.Object

org.nuxeo.functionaltests.AbstractTest

public abstract class AbstractTest
extends Object

Base functions for all pages.

Field Summary

Fields

Modifier and Type	Field and Description
static int	AJAX_SHORT_TIMEOUT_SECONDS
static int	AJAX_TIMEOUT_SECONDS
static String	CHROME_DRIVER_DEFAULT_EXECUTABLE_NAME
static String	CHROME_DRIVER_DEFAULT_PATH_LINUX
static String	CHROME_DRIVER_DEFAULT_PATH_MAC
static String	CHROME_DRIVER_DEFAULT_PATH_WINVISTA
static String	CHROME_DRIVER_DEFAULT_PATH_WINXP
static String	CHROME_DRIVER_WINDOWS_EXECUTABLE_NAME
static org.openqa.selenium.remote.RemoteWebDriver	driver
static int	LOAD_SHORT_TIMEOUT_SECONDS
static int	LOAD_TIMEOUT_SECONDS
static String	NUXEO_URL
static int	PAGE_LOAD_TIME_OUT_SECONDS Page Load timeout in seconds.
static int	POLLING_FREQUENCY_MILLISECONDS Polling frequency in milliseconds.
static int	POLLING_FREQUENCY_SECONDS
protected static org.browsermob.proxy.ProxyServer	proxyServer
static String	SYSPROP_CHROME_DRIVER_PATH
static String	TEST_PASSWORD
static String	TEST_USERNAME
protected static File	tmp_firebug_xpi
org.junit.rules.MethodRule	watchman Logger method to follow what's being run on server logs and take a screenshot of the last page in case of failure

Constructor Summary

Constructors

Constructor and Description
AbstractTest()

Method Summary

Modifier and Type	Method and Description
protected static void	addFireBug(org.openqa.selenium.firefox.FirefoxProfile profile)
protected static String	anyElementNotLoaded(List<org.openqa.selenium.internal.WrapsElement> proxies, List<String> fieldNames)
static <T> T	asPage(Class<T> pageClassToProxy)
void	checkJavascriptError()
protected void	cleanRepository(DocumentBasePage currentPage) Cleans the repository (delete the test Workspace) from the currentPage.
protected CollectionContentTabSubPage	createCollection(DocumentBasePage currentPage, String collectionsTitle, String fileDescription) Creates a Collection form the currentPage.
protected DocumentBasePage	createCollections(DocumentBasePage currentPage, String collectionsTitle, String fileDescription) Creates a Collections container form the currentPage.
protected FileDocumentBasePage	createFile(DocumentBasePage currentPage, String fileTitle, String fileDescription, boolean uploadBlob, String filePrefix, String fileSuffix, String fileContent) Creates a File form the currentPage.
protected NoteDocumentBasePage	createNote(DocumentBasePage currentPage, String noteTitle, String noteDescription, boolean defineNote, String noteContent) Creates a Note form the currentPage.
protected DocumentBasePage	createWorkspace(DocumentBasePage currentPage, String workspaceTitle, String workspaceDescription) Creates a Workspace form the currentPage.
protected void	deleteWorkspace(DocumentBasePage currentPage, String workspaceTitle) Deletes the Workspace with title workspaceTitle from the currentPage.
static <T> T	fillElement(Class<T> pageClassToProxy, T page) Fills an instantiated page/form/widget attributes
protected static File	findExecutableOnPath(String executableName)
static <T> T	get(String url, Class<T> pageClassToProxy)
protected static List<String>	getClassLoaderFiles() Introspects the classpath and returns the list of files in it.
protected String	getCurrentDocumentId() Get the current document id stored in the javascript ctx.currentDocument variable of the current page.
LoginPage	getLoginPage()
static org.openqa.selenium.WebDriver	getPopup()
static String	getTmpFileToUploadPath(String filePrefix, String fileSuffix, String fileContent) Creates a temporary file and returns its absolute path.
static <T extends WebFragment> T	getWebFragment(org.openqa.selenium.By by, Class<T> webFragmentClass)
static <T extends WebFragment> T	getWebFragment(org.openqa.selenium.WebElement element, Class<T> webFragmentClass)
static <T> T	getWithoutErrorHandler(String url, Class<T> pageClassToProxy) Do not wait for page load.
protected static void	initChromeDriver()
static void	initDriver()
protected static void	initFirefoxDriver()
protected DocumentBasePage	initRepository(DocumentBasePage currentPage) Init the repository with a test Workspace form the currentPage.
protected static <T> T	instantiatePage(Class<T> pageClassToProxy)
protected static <T extends WebFragment> T	instantiateWebFragment(org.openqa.selenium.WebElement element, Class<T> webFragmentClass)
DocumentBasePage	login() Login as Administrator
DocumentBasePage	login(String username, String password)
DocumentBasePage	loginAsTestUser() Login as default test user.
LoginPage	loginInvalid(String username, String password) Login using an invalid credential.
LoginPage	logout()
<T extends AbstractPage> T	nav(Class<T> pageClass, String linkText) navigate to a link text. wait until the link is available and click on it.
void	navToUrl(String urlString) Navigate to a specified url
static void	quitDriver()
protected static void	removeFireBug()
void	runBeforeAfters() This method will be executed before any method registered with JUnit After annotation.
protected static org.openqa.selenium.Proxy	startProxy()
protected static void	stopProxy()

Methods inherited from class java.lang.Object

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

Field Detail

TEST_USERNAME

public static final String TEST_USERNAME

Since:

5.9.2

See Also:

Constant Field Values

TEST_PASSWORD

public static final String TEST_PASSWORD

Since:

5.9.2

See Also:

Constant Field Values

POLLING_FREQUENCY_MILLISECONDS

public static final int POLLING_FREQUENCY_MILLISECONDS

Polling frequency in milliseconds.

Since:

5.9.2

See Also:

Constant Field Values

PAGE_LOAD_TIME_OUT_SECONDS

public static final int PAGE_LOAD_TIME_OUT_SECONDS

Page Load timeout in seconds.

Since:

5.9.2

See Also:

Constant Field Values

CHROME_DRIVER_DEFAULT_PATH_LINUX

public static final String CHROME_DRIVER_DEFAULT_PATH_LINUX

Since:

5.7

See Also:

Constant Field Values

CHROME_DRIVER_DEFAULT_PATH_MAC

public static final String CHROME_DRIVER_DEFAULT_PATH_MAC

Since:

5.7 "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" doesn't work

See Also:

Constant Field Values

CHROME_DRIVER_DEFAULT_PATH_WINVISTA

public static final String CHROME_DRIVER_DEFAULT_PATH_WINVISTA

Since:

5.7

CHROME_DRIVER_DEFAULT_PATH_WINXP

public static final String CHROME_DRIVER_DEFAULT_PATH_WINXP

Since:

5.7

CHROME_DRIVER_DEFAULT_EXECUTABLE_NAME

public static final String CHROME_DRIVER_DEFAULT_EXECUTABLE_NAME

Since:

5.7

See Also:

Constant Field Values

CHROME_DRIVER_WINDOWS_EXECUTABLE_NAME

public static final String CHROME_DRIVER_WINDOWS_EXECUTABLE_NAME

Since:

5.7

See Also:

Constant Field Values

NUXEO_URL

public static final String NUXEO_URL

LOAD_TIMEOUT_SECONDS

public static final int LOAD_TIMEOUT_SECONDS

See Also:

Constant Field Values

LOAD_SHORT_TIMEOUT_SECONDS

public static final int LOAD_SHORT_TIMEOUT_SECONDS

See Also:

Constant Field Values

AJAX_TIMEOUT_SECONDS

public static final int AJAX_TIMEOUT_SECONDS

See Also:

Constant Field Values

AJAX_SHORT_TIMEOUT_SECONDS

public static final int AJAX_SHORT_TIMEOUT_SECONDS

See Also:

Constant Field Values

POLLING_FREQUENCY_SECONDS

public static final int POLLING_FREQUENCY_SECONDS

See Also:

Constant Field Values

SYSPROP_CHROME_DRIVER_PATH

public static final String SYSPROP_CHROME_DRIVER_PATH

See Also:

Constant Field Values

driver

public static org.openqa.selenium.remote.RemoteWebDriver driver

tmp_firebug_xpi

protected static File tmp_firebug_xpi

proxyServer

protected static org.browsermob.proxy.ProxyServer proxyServer

watchman

public org.junit.rules.MethodRule watchman

Logger method to follow what's being run on server logs and take a screenshot of the last page in case of failure

Constructor Detail

AbstractTest

public AbstractTest()

Method Detail

runBeforeAfters

public void runBeforeAfters()

This method will be executed before any method registered with JUnit After annotation.

Since:

5.8

initDriver

public static void initDriver()
                       throws Exception

Throws:

Exception

initFirefoxDriver

protected static void initFirefoxDriver()
                                 throws Exception

Throws:

Exception

initChromeDriver

protected static void initChromeDriver()
                                throws Exception

Throws:

Exception

findExecutableOnPath

protected static File findExecutableOnPath(String executableName)

Since:

5.7

checkJavascriptError

public void checkJavascriptError()

Since:

7.1

quitDriver

public static void quitDriver()

getClassLoaderFiles

protected static List<String> getClassLoaderFiles()
                                           throws Exception

Introspects the classpath and returns the list of files in it. FIXME: should use HarnessRuntime#getClassLoaderFiles that returns the same thing

Returns:

Throws:

Exception

addFireBug

protected static void addFireBug(org.openqa.selenium.firefox.FirefoxProfile profile)
                          throws Exception

Throws:

Exception

removeFireBug

protected static void removeFireBug()

startProxy

protected static org.openqa.selenium.Proxy startProxy()
                                               throws Exception

Throws:

Exception

stopProxy

protected static void stopProxy()
                         throws Exception

Throws:

Exception

get

public static <T> T get(String url,
                        Class<T> pageClassToProxy)

getWithoutErrorHandler

public static <T> T getWithoutErrorHandler(String url,
                                           Class<T> pageClassToProxy)
                                    throws IOException

Do not wait for page load. Do not handle error. Do not give explicit error in case of failure. This is a very raw get.

Throws:

IOException

Since:

6.0

getPopup

public static org.openqa.selenium.WebDriver getPopup()

asPage

public static <T> T asPage(Class<T> pageClassToProxy)

getWebFragment

public static <T extends WebFragment> T getWebFragment(org.openqa.selenium.By by,
                                                       Class<T> webFragmentClass)

getWebFragment

public static <T extends WebFragment> T getWebFragment(org.openqa.selenium.WebElement element,
                                                       Class<T> webFragmentClass)

fillElement

public static <T> T fillElement(Class<T> pageClassToProxy,
                                T page)

Fills an instantiated page/form/widget attributes

Since:

5.7

anyElementNotLoaded

protected static String anyElementNotLoaded(List<org.openqa.selenium.internal.WrapsElement> proxies,
                                            List<String> fieldNames)

instantiatePage

protected static <T> T instantiatePage(Class<T> pageClassToProxy)

instantiateWebFragment

protected static <T extends WebFragment> T instantiateWebFragment(org.openqa.selenium.WebElement element,
                                                                  Class<T> webFragmentClass)

getLoginPage

public LoginPage getLoginPage()

logout

public LoginPage logout()

nav

public <T extends AbstractPage> T nav(Class<T> pageClass,
                                      String linkText)

navigate to a link text. wait until the link is available and click on it.

navToUrl

public void navToUrl(String urlString)
              throws MalformedURLException

Navigate to a specified url

Parameters:

urlString - url

Throws:

MalformedURLException

login

public DocumentBasePage login()
                       throws DocumentBasePage.UserNotConnectedException

Login as Administrator

Returns:

the Document base page (by default returned by CAP)

Throws:

DocumentBasePage.UserNotConnectedException

login

public DocumentBasePage login(String username,
                              String password)
                       throws DocumentBasePage.UserNotConnectedException

Throws:

DocumentBasePage.UserNotConnectedException

loginAsTestUser

public DocumentBasePage loginAsTestUser()
                                 throws DocumentBasePage.UserNotConnectedException

Login as default test user.

Throws:

DocumentBasePage.UserNotConnectedException

Since:

5.9.2

loginInvalid

public LoginPage loginInvalid(String username,
                              String password)

Login using an invalid credential.

Parameters:

username -

password -

initRepository

protected DocumentBasePage initRepository(DocumentBasePage currentPage)
                                   throws Exception

Init the repository with a test Workspace form the currentPage.

Parameters:

currentPage - the current page

Returns:

the created Workspace page

Throws:

Exception - if initializing repository fails

cleanRepository

protected void cleanRepository(DocumentBasePage currentPage)
                        throws Exception

Cleans the repository (delete the test Workspace) from the currentPage.

Parameters:

currentPage - the current page

Throws:

Exception - if cleaning repository fails

createWorkspace

protected DocumentBasePage createWorkspace(DocumentBasePage currentPage,
                                           String workspaceTitle,
                                           String workspaceDescription)

Creates a Workspace form the currentPage.

Parameters:

currentPage - the current page

workspaceTitle - the workspace title

workspaceDescription - the workspace description

Returns:

the created Workspace page

deleteWorkspace

protected void deleteWorkspace(DocumentBasePage currentPage,
                               String workspaceTitle)

Deletes the Workspace with title workspaceTitle from the currentPage.

Parameters:

currentPage - the current page

workspaceTitle - the workspace title

createFile

protected FileDocumentBasePage createFile(DocumentBasePage currentPage,
                                          String fileTitle,
                                          String fileDescription,
                                          boolean uploadBlob,
                                          String filePrefix,
                                          String fileSuffix,
                                          String fileContent)
                                   throws IOException

Creates a File form the currentPage.

Parameters:

currentPage - the current page

fileTitle - the file title

fileDescription - the file description

uploadBlob - true if a blob needs to be uploaded (temporary file created for this purpose)

filePrefix - the file prefix

fileSuffix - the file suffix

fileContent - the file content

Returns:

the created File page

Throws:

IOException - if temporary file creation fails

createCollections

protected DocumentBasePage createCollections(DocumentBasePage currentPage,
                                             String collectionsTitle,
                                             String fileDescription)

Creates a Collections container form the currentPage.

Parameters:

currentPage - the current page

collectionsTitle - the Collections container title

collectionsDescription - the collections description

Returns:

the created Collections page

Throws:

IOException - if temporary file creation fails

createCollection

protected CollectionContentTabSubPage createCollection(DocumentBasePage currentPage,
                                                       String collectionsTitle,
                                                       String fileDescription)

Creates a Collection form the currentPage.

Parameters:

currentPage - the current page

collectionTitle - the Collections container title

collectionDescription - the collection description

Returns:

the created Collections page

Throws:

IOException - if temporary file creation fails

getTmpFileToUploadPath

public static String getTmpFileToUploadPath(String filePrefix,
                                            String fileSuffix,
                                            String fileContent)
                                     throws IOException

Creates a temporary file and returns its absolute path.

Parameters:

tmpFilePrefix - the file prefix

fileSuffix - the file suffix

fileContent - the file content

Returns:

the temporary file to upload path

Throws:

IOException - if temporary file creation fails

Since:

5.9.3

getCurrentDocumentId

protected String getCurrentDocumentId()

Get the current document id stored in the javascript ctx.currentDocument variable of the current page.

Returns:

the current document id

Since:

5.7

createNote

protected NoteDocumentBasePage createNote(DocumentBasePage currentPage,
                                          String noteTitle,
                                          String noteDescription,
                                          boolean defineNote,
                                          String noteContent)
                                   throws IOException

Creates a Note form the currentPage.

Parameters:

currentPage - the current page

noteTitle - the note title

noteDescription - the note description

defineNote - true if the content of the note needs to be defined

noteContent - the content of the note

Returns:

the created note page.

Throws:

IOException

Since:

5.9.4