org.safs

Class DCGUIUtilities

java.lang.Object

org.safs.STAFRequester

org.safs.DDGUIUtilities

org.safs.DCGUIUtilities

public class DCGUIUtilities
extends DDGUIUtilities

Concrete subclass of DDGUIUtilities that provides no real implementation for the handling of GUI components. This is primarily intended to be used by processors or engines that provide features and functions that do no act on GUI components-- for example, many non-component Driver Commands.

Field Summary

Fields inherited from class org.safs.DDGUIUtilities

appmaps, DEBUG_MESSAGE, FAILED_MESSAGE, FAILED_OK_MESSAGE, GENERIC_MESSAGE, log, PASSED_MESSAGE, trdata, WARNING_MESSAGE, WARNING_OK_MESSAGE

Fields inherited from class org.safs.STAFRequester

staf

Constructor Summary

Constructors

Constructor and Description
DCGUIUtilities()

Method Summary

Modifier and Type	Method and Description
java.util.List	extractListItems(java.lang.Object obj, java.lang.String countProp, java.lang.String itemProp) Extract items from a List or Array type of object property.
Tree	extractMenuBarItems(java.lang.Object obj) Extract a menu hierarchy from a MenuBar pseudo-object reference.
Tree	extractMenuItems(java.lang.Object obj) Extract a menu hierarchy from a object.
java.lang.Object	findPropertyMatchedChild(java.lang.Object obj, java.lang.String property, java.lang.String bench, boolean exactMatch) Attempt to locate a child object based on a matching property value.
java.lang.String	getListItem(java.lang.Object obj, int i, java.lang.String itemProp) Get a single list item from a List or Array type of object property.
int	setActiveWindow(java.lang.String appMapName, java.lang.String windowName, java.lang.String compName) "Activate" the specified component's topmost parent.
int	waitForObject(java.lang.String appMapName, java.lang.String windowName, java.lang.String compName, long secTimeout) Wait up to a maximum timeout value for the specified component to "exist".

Methods inherited from class org.safs.DDGUIUtilities

clearAllAppMapCaches, clearAppMapCache, createAppMapInstance, getAppMap, getLogUtilities, getTestRecordData, isAppMapRegistered, openAppMap, registerAppMap, registerAppMap, setLogUtilities, setTestRecordData

Methods inherited from class org.safs.STAFRequester

getSTAFHelper, setSTAFHelper

Methods inherited from class java.lang.Object

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

Constructor Detail

DCGUIUtilities

public DCGUIUtilities()

Method Detail

extractMenuItems

public Tree extractMenuItems(java.lang.Object obj)
                      throws SAFSException

Description copied from class: DDGUIUtilities

Extract a menu hierarchy from a object. This is generally for JPopupMenus, JMenus, and JMenuItems (JMenu is subclass of JMenuItem).

Specified by:

extractMenuItems in class DDGUIUtilities

Returns:

null

Throws:

SAFSException

See Also:

DDGUIUtilities.extractMenuItems(Object)

extractMenuBarItems

public Tree extractMenuBarItems(java.lang.Object obj)
                         throws SAFSException

Description copied from class: DDGUIUtilities

Extract a menu hierarchy from a MenuBar pseudo-object reference. Often this can be served by the extracMenuItems function. This is generally for JMenuBars.

Specified by:

extractMenuBarItems in class DDGUIUtilities

Returns:

null

Throws:

SAFSException

See Also:

DDGUIUtilities.extractMenuBarItems(Object)

getListItem

public java.lang.String getListItem(java.lang.Object obj,
                                    int i,
                                    java.lang.String itemProp)
                             throws SAFSException

Description copied from class: DDGUIUtilities

Get a single list item from a List or Array type of object property.

Specified by:

getListItem in class DDGUIUtilities

Returns:

"item:"+i+", "+obj;

Throws:

SAFSException

See Also:

DDGUIUtilities.getListItem(Object, int, String)

extractListItems

public java.util.List extractListItems(java.lang.Object obj,
                                       java.lang.String countProp,
                                       java.lang.String itemProp)
                                throws SAFSException

Description copied from class: DDGUIUtilities

Extract items from a List or Array type of object property.

Specified by:

extractListItems in class DDGUIUtilities

Returns:

List with "item: "+obj

Throws:

SAFSException

See Also:

DDGUIUtilities.extractListItems(Object, String, String)

findPropertyMatchedChild

public java.lang.Object findPropertyMatchedChild(java.lang.Object obj,
                                                 java.lang.String property,
                                                 java.lang.String bench,
                                                 boolean exactMatch)
                                          throws SAFSObjectNotFoundException

Description copied from class: DDGUIUtilities

Attempt to locate a child object based on a matching property value. The check can require an exactMatch; or, a case-insensitive partial substring match if the exactMatch parameter is false. (Can use StringUtils.isCaseContainsMatch)

Specified by:

findPropertyMatchedChild in class DDGUIUtilities

Parameters:

obj - -- the pseudo-object reference whose children will be evaluated.

property - -- the property of each child that will be evaluated. The property is expected to be one that can successfully return a value cast as type String.

bench - -- the benchmark value for the property to be used in comparisons.

exactMatch - -- if true, an exact case-sensitive match of the bench value provided is required to signal a match.
if false, a case-insensitive partial substring match with the bench value is performed.

Returns:

null

Throws:

SAFSObjectNotFoundException - if no matching child object is found.

See Also:

DDGUIUtilities.findPropertyMatchedChild(Object, String, String, boolean)

setActiveWindow

public int setActiveWindow(java.lang.String appMapName,
                           java.lang.String windowName,
                           java.lang.String compName)
                    throws SAFSObjectNotFoundException

Description copied from class: DDGUIUtilities

"Activate" the specified component's topmost parent.

Specified by:

setActiveWindow in class DDGUIUtilities

Parameters:

appMapName - name of AppMap used to lookup component.

windowName - name of Window in AppMap.

compName - name of Window Component in AppMap. If the Window IS the desired Component, then both windowName and compName will be the same.

Returns:

0

Throws:

SAFSObjectNotFoundException - if the component or its parent cannot be found.

See Also:

DDGUIUtilities.setActiveWindow(String, String, String)

waitForObject

public int waitForObject(java.lang.String appMapName,
                         java.lang.String windowName,
                         java.lang.String compName,
                         long secTimeout)
                  throws SAFSObjectNotFoundException

Description copied from class: DDGUIUtilities

Wait up to a maximum timeout value for the specified component to "exist".

Specified by:

waitForObject in class DDGUIUtilities

Parameters:

appMapName - name of AppMap used to lookup component.

windowName - name of Window in AppMap.

compName - name of Window Component in AppMap. If the Window IS the desired Component, then both windowName and compName will be the same.

secTimeout - maximum wait in seconds

Returns:

0

Throws:

SAFSObjectNotFoundException - if the component or its parent cannot be found.

See Also:

DDGUIUtilities.waitForObject(String, String, String, long)