org.safs.selenium.webdriver.lib

Class Tree

java.lang.Object

org.safs.selenium.webdriver.lib.model.DefaultRefreshable

org.safs.selenium.webdriver.lib.Component

org.safs.selenium.webdriver.lib.Tree

All Implemented Interfaces:

IHierarchicalSelectable, IOperable, IRefreshable, ISelectable, ITreeSelectable, IWebAccessibleInternetRole

public class Tree
extends Component
implements ITreeSelectable

A library class to handle different specific Tree.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) class	Tree.DefaultSelectable_Tree
protected static class	Tree.SapSelectable_Tree

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ATTRIBUTE_DATA_EXPANDED 'data-expanded' attribute for tree http://demos.telerik.com/kendo-ui/treeview/index
(package private) ITreeSelectable	treeListable

Fields inherited from class org.safs.selenium.webdriver.lib.Component

accessible, anOperableObject, ATTRIBUTE_CLASS, ATTRIBUTE_DIJITPOPUPPARENT, ATTRIBUTE_ID, ATTRIBUTE_INDEX, ATTRIBUTE_MULTIPLE, ATTRIBUTE_NAME, ATTRIBUTE_TEXT, ATTRIBUTE_TYPE, ATTRIBUTE_VALUE, ATTRIBUTE_VISIBILITY, ATTRIBUTE_WIDGETID, delayGetContent, dijitpopupparent, operableObjects, TAG_HTML_INPUT, TAG_HTML_SELECT, VALUE_CHECKBOX_ATTRIBUTE_TYPE, VALUE_PASSWORD_ATTRIBUTE_TYPE, VALUE_RADIO_ATTRIBUTE_TYPE, VALUE_SUBMIT_ATTRIBUTE_TYPE, VALUE_TEXT_ATTRIBUTE_TYPE, VALUE_VISIBILITY_HIDDEN, VALUE_VISIBILITY_VISIBLE, waiRole, widgetid

Fields inherited from class org.safs.selenium.webdriver.lib.model.DefaultRefreshable

cssClass, id, map, object, possibleRecognitionStrings, searchContext, tagName, webelement

Fields inherited from interface org.safs.selenium.webdriver.lib.model.IWebAccessibleInternetRole

ATTRIBUTE_ARIA_ACTIVEDDESCENDANT, ATTRIBUTE_ARIA_ATOMIC, ATTRIBUTE_ARIA_AUTOCOMPLETE, ATTRIBUTE_ARIA_BUSY, ATTRIBUTE_ARIA_CHECKED, ATTRIBUTE_ARIA_CONTROLS, ATTRIBUTE_ARIA_DESCRIBEDBY, ATTRIBUTE_ARIA_DISABLED, ATTRIBUTE_ARIA_DRIPEFFECT, ATTRIBUTE_ARIA_EXPANDED, ATTRIBUTE_ARIA_FLOWTO, ATTRIBUTE_ARIA_GRABBED, ATTRIBUTE_ARIA_HASPOPUP, ATTRIBUTE_ARIA_HIDDEN, ATTRIBUTE_ARIA_INVALID, ATTRIBUTE_ARIA_LABEL, ATTRIBUTE_ARIA_LABELDEBY, ATTRIBUTE_ARIA_LEVEL, ATTRIBUTE_ARIA_LIVE, ATTRIBUTE_ARIA_MULTISELECTABLE, ATTRIBUTE_ARIA_ORIENTATION, ATTRIBUTE_ARIA_OWNS, ATTRIBUTE_ARIA_POSINSET, ATTRIBUTE_ARIA_PRESSED, ATTRIBUTE_ARIA_READONLY, ATTRIBUTE_ARIA_RELEVANT, ATTRIBUTE_ARIA_REQUIRED, ATTRIBUTE_ARIA_SELECTED, ATTRIBUTE_ARIA_SETSIZE, ATTRIBUTE_ARIA_SORT, ATTRIBUTE_ARIA_VALUEMAX, ATTRIBUTE_ARIA_VALUEMIN, ATTRIBUTE_ARIA_VALUENOW, ATTRIBUTE_ARIA_VALUETEXT, ATTRIBUTE_WAI_ROLE, WAI_ROLE_ALERT, WAI_ROLE_ALERTDIALOG, WAI_ROLE_APPLICATION, WAI_ROLE_ARTICLE, WAI_ROLE_BANNER, WAI_ROLE_BUTTON, WAI_ROLE_CHECKBOX, WAI_ROLE_COLUMNHEADER, WAI_ROLE_COMBOBOX, WAI_ROLE_COMPLEMENTARY, WAI_ROLE_CONTENTINFO, WAI_ROLE_DEFINITION, WAI_ROLE_DIALOG, WAI_ROLE_DIRECTORY, WAI_ROLE_DOCUMENT, WAI_ROLE_FORM, WAI_ROLE_GRID, WAI_ROLE_GRIDCELL, WAI_ROLE_GROUP, WAI_ROLE_HEADING, WAI_ROLE_IMG, WAI_ROLE_LINK, WAI_ROLE_LIST, WAI_ROLE_LISTBOX, WAI_ROLE_LISTITEM, WAI_ROLE_LOG, WAI_ROLE_MAIN, WAI_ROLE_MARQUEE, WAI_ROLE_MATH, WAI_ROLE_MENU, WAI_ROLE_MENUBAR, WAI_ROLE_MENUITEM, WAI_ROLE_MENUITEMCHECKBOX, WAI_ROLE_MENUITEMRADIO, WAI_ROLE_NAVIGATION, WAI_ROLE_NOTE, WAI_ROLE_OPTION, WAI_ROLE_PRESENTATION, WAI_ROLE_PROGRESSBAR, WAI_ROLE_RADIO, WAI_ROLE_RADIOGROUP, WAI_ROLE_REGION, WAI_ROLE_ROW, WAI_ROLE_ROWGROUP, WAI_ROLE_ROWHEADER, WAI_ROLE_SCROLLBAR, WAI_ROLE_SEARCH, WAI_ROLE_SEPARATOR, WAI_ROLE_SLIDER, WAI_ROLE_SPINBUTTON, WAI_ROLE_STATUS, WAI_ROLE_TAB, WAI_ROLE_TABLIST, WAI_ROLE_TABPANEL, WAI_ROLE_TEXTBOX, WAI_ROLE_TIMER, WAI_ROLE_TOOLBAR, WAI_ROLE_TOOLTIP, WAI_ROLE_TREE, WAI_ROLE_TREEGRID, WAI_ROLE_TREEITEM

Constructor Summary

Constructors

Constructor and Description
Tree(org.openqa.selenium.WebElement treeview)

Method Summary

Modifier and Type	Method and Description
void	activateItem(int index, boolean verify, org.openqa.selenium.Keys key, java.awt.Point offset) Try to activate (double-click) the item according to the index, and then verify if the item has been really selected according to the parameter 'verify'.
void	activateItem(TextMatchingCriterion criterion, boolean verify, org.openqa.selenium.Keys key, java.awt.Point offset) Try to activate (double-click) the item according to the item's text (fully or partially given), and then verify if the item has been really selected according to the parameter 'verify'.
protected void	castOperable() Cast the IOperable object to the specific one. The subclasses will override this method as they know what specific Operable to use. Here a void implementation is given, as not all subclass need the specific Operable, such as EditBox. Cast may throw Exception, we should catch it if calling this method. This method should be called after Component.anOperableObject has been initialized.
void	collapseItem(TextMatchingCriterion criterion, boolean collpaseChildren, boolean verify) Collapse the item according to the path.
protected IOperable	createDefaultOperable() Create the default IOperable object for a certain specific component. It is different from the Component.createGenericOperable(), which will provide an IOperable to support the minimal generic functionalities, like GetGUIImage, Click, HoverMouse etc. Subclass COULD override this method to provide a default backup IOperable when other ways fail to create IOperable.
protected IOperable	createSAPOperable() Create the IOperable object for SAP domain. Subclass SHOULD override this method if SAP will be supported.
void	expandItem(TextMatchingCriterion criterion, boolean expandChildren, boolean verify) Expand the item according to the path.
void	ExpandTextNode(java.lang.String fullnode) Deprecated. due to deprecation of node(String, boolean)
TreeNode[]	getContent() Get all tree nodes.
TreeNode	getMatchedElement(TextMatchingCriterion criterion) According to a certain 'search condition', get the matched subitem within this Component. This method just return a null.
static boolean	isTreeNodeExpanded(org.openqa.selenium.WebElement treenode)
static boolean	isTreeNodeSelected(org.openqa.selenium.WebElement treenode)
static java.lang.String	parseTreeNodeText(org.openqa.selenium.WebElement treenode) For treenode, WebElement.getText() may return also the text of its children. These text are separated by '\n', this method tries to get the text before the first '\n', which should be text of this tree node.
void	selectItem(int index, boolean verify, org.openqa.selenium.Keys key, java.awt.Point offset, int mouseButtonNumber) Try to select (single-click) the item according to the index, and then verify if the item has been really selected according to the parameter 'verify'.
void	selectItem(TextMatchingCriterion criterion, boolean verify, org.openqa.selenium.Keys key, java.awt.Point offset, int mouseButtonNumber) Try to select (single-click) the item according to the item's text (fully or partially given), and then verify if the item has been really selected according to the parameter 'verify'.
void	SelectTextNode(java.lang.String fullnode) Deprecated. due to deprecation of node(String, boolean)
void	verifyContains(TextMatchingCriterion criterion) Verify the item (specified by text, partialMatch and matchIndex) is contained.
void	verifyItemSelection(int index, boolean expectSelected) Verify the item (specified by index) is selected or un-selected.
void	verifyItemSelection(TextMatchingCriterion criterion, boolean expectSelected) Verify the item (specified by text, partialMatch and matchIndex) is selected or un-selected.

Methods inherited from class org.safs.selenium.webdriver.lib.Component

clearCache, clearComponentBox, createDOJOOperable, createGenericOperable, createHTMLOperable, createOperable, doubleCheckVerification, getDijitpopupparent, getValue, getWaiRole, getWidgetid, initialize, inputChars, inputComponentBoxChars, inputComponentBoxKeys, inputKeys, isAccessible, permitInvisible, setDijitpopupparent, setFocus, setWidgetid, updateFields, verifyComponentBox

Methods inherited from class org.safs.selenium.webdriver.lib.model.DefaultRefreshable

getAttribute, getCssClass, getEmbeddedObject, getId, getMap, getPossibleRecognitionStrings, getSearchContext, getTagName, getWebElement, initialize, refresh, setCssClass, setId, setPossibleRecognitionStrings, setSearchContext, setTagName, setWebElement

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.safs.selenium.webdriver.lib.model.IOperable

clearCache

Field Detail

treeListable

ITreeSelectable treeListable

ATTRIBUTE_DATA_EXPANDED

public static final java.lang.String ATTRIBUTE_DATA_EXPANDED

'data-expanded' attribute for tree http://demos.telerik.com/kendo-ui/treeview/index

See Also:

Constant Field Values

Constructor Detail

Tree

public Tree(org.openqa.selenium.WebElement treeview)
     throws SeleniumPlusException

Throws:

SeleniumPlusException

Method Detail

castOperable

protected void castOperable()

Description copied from class: Component

Cast the IOperable object to the specific one.
The subclasses will override this method as they know what specific Operable to use.
Here a void implementation is given, as not all subclass need the specific Operable, such as EditBox.
Cast may throw Exception, we should catch it if calling this method.
This method should be called after Component.anOperableObject has been initialized.

Overrides:

castOperable in class Component

See Also:

Component.anOperableObject, Component.updateFields()

createSAPOperable

protected IOperable createSAPOperable()

Description copied from class: Component

Create the IOperable object for SAP domain.
Subclass SHOULD override this method if SAP will be supported.

Overrides:

createSAPOperable in class Component

See Also:

Component.createOperable(WebElement)

createDefaultOperable

protected IOperable createDefaultOperable()

Description copied from class: Component

Create the default IOperable object for a certain specific component.
It is different from the Component.createGenericOperable(), which will provide an IOperable
to support the minimal generic functionalities, like GetGUIImage, Click, HoverMouse etc.
Subclass COULD override this method to provide a default backup IOperable when other ways fail to create IOperable.

Overrides:

createDefaultOperable in class Component

See Also:

Component.createOperable(WebElement), Component.createDOJOOperable(), Component.createHTMLOperable(), Component.createSAPOperable()

isTreeNodeExpanded

public static boolean isTreeNodeExpanded(org.openqa.selenium.WebElement treenode)

isTreeNodeSelected

public static boolean isTreeNodeSelected(org.openqa.selenium.WebElement treenode)

parseTreeNodeText

public static java.lang.String parseTreeNodeText(org.openqa.selenium.WebElement treenode)

For treenode, WebElement.getText() may return also the text of its children.
These text are separated by '\n', this method tries to get the text before the first '\n', which
should be text of this tree node.

Parameters:

treenode - WebElement, represents the tree node.

Returns:

String, the label of the treenode, or null if the treenode is null

selectItem

public void selectItem(TextMatchingCriterion criterion,
                       boolean verify,
                       org.openqa.selenium.Keys key,
                       java.awt.Point offset,
                       int mouseButtonNumber)
                throws SeleniumPlusException

Description copied from interface: ISelectable

Try to select (single-click) the item according to the item's text (fully or partially given), and then verify if the item has been really selected according to the parameter 'verify'. If the parameter key is provided, the selection will happen with that key pressed at the same time. If the parameter offset is provided, then click at offset relative to the top-left corner of view; otherwise at the center. The parameter mouseButtonNumber decides right-click or left-click.
Note: There are maybe some callback methods associated with the item-container, but setting select text MAY NOT invoke them, in the implementation of this method we should make sure those callbacks are invoked (we can fire some events.)

Specified by:

selectItem in interface ISelectable

Parameters:

criterion - TextMatchingCriterion, containing text, partialMatch, matchedIndex as search-criterion.

verify - boolean, if true then verify the selection;

key - org.openqa.selenium.Keys, it is the key to press during selection.
for example Keys.SHIFT, or Keys.CONTROL.
If user doesn't want any key pressed, please provide null

offset - Point, the position relative to the up-left corner to click at
If user provides null, then the center of the item will be used

mouseButtonNumber - int, the mouse-button-number representing right, middle, or left button.
it can be WDLibrary.MOUSE_BUTTON_LEFT or WDLibrary.MOUSE_BUTTON_RIGHT
or WDLibrary.MOUSE_BUTTON_MIDDLE.

Throws:

SeleniumPlusException

selectItem

public void selectItem(int index,
                       boolean verify,
                       org.openqa.selenium.Keys key,
                       java.awt.Point offset,
                       int mouseButtonNumber)
                throws SeleniumPlusException

Description copied from interface: ISelectable

Try to select (single-click) the item according to the index, and then verify if the item has been really selected according to the parameter 'verify'. If the parameter key is provided, the selection will happen with that key pressed at the same time. If the parameter offset is provided, then click at offset relative to the top-left corner of view; otherwise at the center. The parameter mouseButtonNumber decides right-click or left-click.
Note: There are maybe some callback methods associated with the item-container, but setting select index MAY NOT invoke them, in the implementation of this method we should make sure those callbacks are invoked (we can fire some events.)

Specified by:

selectItem in interface ISelectable

Parameters:

index - int, the index of the item to select, it is 0-based index.

verify - boolean, if true then verify the selection;

key - org.openqa.selenium.Keys, it is the key to press during selection.
for example Keys.SHIFT, or Keys.CONTROL.
If user doesn't want any key pressed, please provide null

offset - Point, the position relative to the up-left corner to click at
If user provides null, then the center of the item will be used

mouseButtonNumber - int, the mouse-button-number representing right, middle, or left button.
it can be WDLibrary.MOUSE_BUTTON_LEFT or WDLibrary.MOUSE_BUTTON_RIGHT
or WDLibrary.MOUSE_BUTTON_MIDDLE.

Throws:

SeleniumPlusException

activateItem

public void activateItem(TextMatchingCriterion criterion,
                         boolean verify,
                         org.openqa.selenium.Keys key,
                         java.awt.Point offset)
                  throws SeleniumPlusException

Description copied from interface: ISelectable

Try to activate (double-click) the item according to the item's text (fully or partially given), and then verify if the item has been really selected according to the parameter 'verify'. If the parameter key is provided, the selection will happen with that key pressed at the same time.

Specified by:

activateItem in interface ISelectable

Parameters:

criterion - TextMatchingCriterion, containing text, partialMatch, matchedIndex as search-criterion.

verify - boolean, if true then verify the selection;

key - org.openqa.selenium.Keys, it is the key to press during selection.
for example Keys.SHIFT, or Keys.CONTROL.
If user doesn't want any key pressed, please provide null

offset - Point, the position relative to the up-left corner to click at
If user provides null, then the center of the item will be used

Throws:

SeleniumPlusException

activateItem

public void activateItem(int index,
                         boolean verify,
                         org.openqa.selenium.Keys key,
                         java.awt.Point offset)
                  throws SeleniumPlusException

Description copied from interface: ISelectable

Try to activate (double-click) the item according to the index, and then verify if the item has been really selected according to the parameter 'verify'. If the parameter key is provided, the selection will happen with that key pressed at the same time.

Specified by:

activateItem in interface ISelectable

Parameters:

index - int, the index of the item to select, it is 0-based index.

verify - boolean, if true then verify the selection;

key - org.openqa.selenium.Keys, it is the key to press during selection.
for example Keys.SHIFT, or Keys.CONTROL.
If user doesn't want any key pressed, please provide null

offset - Point, the position relative to the up-left corner to click at
If user provides null, then the center of the item will be used

Throws:

SeleniumPlusException

verifyItemSelection

public void verifyItemSelection(TextMatchingCriterion criterion,
                                boolean expectSelected)
                         throws SeleniumPlusException

Description copied from interface: ISelectable

Verify the item (specified by text, partialMatch and matchIndex) is selected or un-selected.

Specified by:

verifyItemSelection in interface ISelectable

Parameters:

criterion - TextMatchingCriterion, containing text, partialMatch, matchedIndex as search-criterion.

expectSelected - boolean, true if the item is expected 'selected'; false if expected 'unselected'.

Throws:

SeleniumPlusException - if the verification fails.

verifyItemSelection

public void verifyItemSelection(int index,
                                boolean expectSelected)
                         throws SeleniumPlusException

Description copied from interface: ISelectable

Verify the item (specified by index) is selected or un-selected.

Specified by:

verifyItemSelection in interface ISelectable

Parameters:

index - int, the index of the item to select, it is 0-based index.

expectSelected - boolean, true if the item is expected 'selected'; false if expected 'unselected'.

Throws:

SeleniumPlusException - if the verification fails.

verifyContains

public void verifyContains(TextMatchingCriterion criterion)
                    throws SeleniumPlusException

Description copied from interface: ISelectable

Verify the item (specified by text, partialMatch and matchIndex) is contained.

Specified by:

verifyContains in interface ISelectable

Parameters:

criterion - TextMatchingCriterion, containing text, partialMatch, matchedIndex as search-criterion.

Throws:

SeleniumPlusException - if the verification fails.

getContent

public TreeNode[] getContent()
                      throws SeleniumPlusException

Description copied from interface: ITreeSelectable

Get all tree nodes.

Specified by:

getContent in interface IHierarchicalSelectable

Specified by:

getContent in interface ISelectable

Specified by:

getContent in interface ITreeSelectable

Returns:

TreeNode[] an array of the TreeNode

Throws:

SeleniumPlusException

expandItem

public void expandItem(TextMatchingCriterion criterion,
                       boolean expandChildren,
                       boolean verify)
                throws SeleniumPlusException

Description copied from interface: ITreeSelectable

Expand the item according to the path.

Specified by:

expandItem in interface ITreeSelectable

Parameters:

criterion - TextMatchingCriterion, containing text, partialMatch, matchedIndex as search-criterion.

expandChildren - boolean, if true then expand all the children of this node.

verify - boolean, if true then verify the treepath has been expended.

Throws:

SeleniumPlusException

collapseItem

public void collapseItem(TextMatchingCriterion criterion,
                         boolean collpaseChildren,
                         boolean verify)
                  throws SeleniumPlusException

Description copied from interface: ITreeSelectable

Collapse the item according to the path.

Specified by:

collapseItem in interface ITreeSelectable

Parameters:

criterion - TextMatchingCriterion, containing text, partialMatch, matchedIndex as search-criterion.

collpaseChildren - boolean, if true then collapse all the children of this node.

verify - boolean, if true then verify the treepath has been collapse.

Throws:

SeleniumPlusException

getMatchedElement

public TreeNode getMatchedElement(TextMatchingCriterion criterion)
                           throws SeleniumPlusException

Description copied from class: Component

According to a certain 'search condition', get the matched subitem within this Component.
This method just return a null. Its sublcass SHOULD give a detail implementation.

Specified by:

getMatchedElement in interface ISelectable

Specified by:

getMatchedElement in interface ITreeSelectable

Overrides:

getMatchedElement in class Component

Parameters:

criterion - TextMatchingCriterion, the search condition

Returns:

Element, the matched element

Throws:

SeleniumPlusException - if Element cannot be found

SelectTextNode

public void SelectTextNode(java.lang.String fullnode)
                    throws SeleniumPlusException

Deprecated. due to deprecation of node(String, boolean)

Parameters:

fullnode -

Throws:

SeleniumPlusException

ExpandTextNode

public void ExpandTextNode(java.lang.String fullnode)
                    throws SeleniumPlusException

Deprecated. due to deprecation of node(String, boolean)

Parameters:

fullnode -

Throws:

SeleniumPlusException