org.safs.rational.flex

Class CFFlexMenuBar

java.lang.Object

org.safs.Processor

org.safs.ComponentFunction

org.safs.rational.CFComponent

org.safs.rational.CFMenuBar

org.safs.rational.flex.CFFlexMenuBar

All Implemented Interfaces:

ITestRecordStackable, RuntimeDataInterface

Direct Known Subclasses:

CFFlexMenuBar

public class CFFlexMenuBar
extends CFMenuBar

Purpose: Process a Flex-MenuBar component.

Since:

JAN 12, 2009 JAN 14, 2009 Add Flex support for SelectMenuItem, SelectMenuItemContains, VerifyMenuItem and VerifyMenuItemContains. The verification of Menu status (Checked...) not supported so far. JAN 20, 2009 Refactor method doSelectMenubar.

Author:

JunwuMa

Nested Class Summary

Nested classes/interfaces inherited from class org.safs.ComponentFunction

ComponentFunction.Window

Field Summary

Fields inherited from class org.safs.rational.CFMenuBar

ITEMCOUNT_PROPERTY, MENUCOUNT_PROPERTY, PATH_PREFIX, SELECTMENUITEM, SELECTMENUITEMCONTAINS, SELECTPOPUPMENUITEM, SELECTUNVERIFIEDMENUITEM, SELECTUNVERIFIEDPOPUPMENUITEM, TEXT_PROPERTY, UITYPE_MENUBAR, UITYPE_POPUPMENU, UITYPE_PROPERTY, VERIFYMENUITEM, VERIFYMENUITEMCONTAINS, VERIFYPOPUPMENU, VERIFYPOPUPMENUCONTAINS, VERIFYPOPUPMENUITEM, VERIFYPOPUPMENUPARTIALMATCH

Fields inherited from class org.safs.rational.CFComponent

keepEncodingConsistent, obj1, script, winObject

Fields inherited from class org.safs.ComponentFunction

action, ALTCLICK, ALTLEFTDRAG, altText, ASSIGNPROPERTYVARIABLE, CAPTUREOBJECTDATATOFILE, CAPTUREPROPERTIESTOFILE, CAPTUREPROPERTYTOFILE, CLEARAPPMAPCACHE, CLICK, CLOSEWINDOW, compName, COMPONENTCLICK, CTRLALTLEFTDRAG, CTRLCLICK, CTRLLEFTDRAG, CTRLRIGHTCLICK, CTRLSHIFTLEFTDRAG, DOUBLECLICK, GETGUIIMAGE, GETTEXTFROMGUI, GUIDOESEXIST, GUIDOESNOTEXIST, HOVERMOUSE, HSCROLLTO, INPUTCHARACTERS, INPUTKEYS, ISPROPERTYEXIST, iterator, LEFTDRAG, LOCATESCREENIMAGE, mapname, MAXIMIZE, MINIMIZE, MOUSECLICK, OBJECT_DATA, PARAM_FILTER, PARAM_UUID, PROPERTY_DOT_itemText, PROPERTY_innerHTML, PROPERTY_innerText, PROPERTY_Items, PROPERTY_text, PROPERTY_textContent, RELATIVE_TO_PARENT, RELATIVE_TO_SCREEN, RESTORE, RIGHTCLICK, RIGHTDRAG, SAVETEXTFROMGUI, SENDEVENT, SETPOSITION, SETPROPERTYVALUE, SHIFTCLICK, SHIFTLEFTDRAG, TEST_DATA_SUFFIX, utils, VERIFYARRAYPROPERTYTOFILE, VERIFYBINARYFILETOFILE, VERIFYCLIPBOARDTOFILE, VERIFYFILETOFILE, VERIFYGUIIMAGETOFILE, VERIFYOBJECTDATATOFILE, VERIFYPROPERTY, VERIFYPROPERTYCONTAINS, VERIFYPROPERTYTOFILE, VERIFYTEXTFILETOFILE, VERIFYVALUECONTAINS, VERIFYVALUEEQUALS, VERIFYVALUES, VERIFYVALUESIGNORECASE, VSCROLLTO, WAITFORGUI, windowName

Fields inherited from class org.safs.Processor

breakpointsOn, CASE_INSENSITIVE_FLAG, CASEINSENSITIVE_FLAG, clearProxiesAlways, commandLineBreakpoint, customStr, customText, DEBUG_MESSAGE, debugStr, debugText, DEFAULT_CUSTOM_PROCESSOR_PACKAGE, DEFAULT_CUSTOM_PROCESSOR_SUBPACKAGE, DEFAULT_PROCESSOR_PACKAGE, FAILED_MESSAGE, FAILED_OK_MESSAGE, failedStr, failedText, FAILURE_DETAIL, GENERIC_MESSAGE, genericStr, genericText, LINE_FAILURE_4, log, myBreakpointsOn, otherStr, otherText, PARAM_SIZE_1, PARAM_SIZE_2, PARAM_SIZE_3, PARAM_SIZE_4, params, PASSED_MESSAGE, passedStr, passedText, PRE_TXT_SUCCESS_4, PRE_TXT_SUCCESS_5, processorConfigSet, processorMap, recordProcessed, RECTYPE_DRIVER_COMMAND, RECTYPE_DRIVER_COMMAND_F, RECTYPE_DRIVER_COMMAND_W, RECTYPE_TEST_STEP, RECTYPE_TEST_STEP_F, RECTYPE_TEST_STEP_W, RFSMCache, RFSMOnly, RFT_FIND_SEARCH_MODE_ALGORITHM, RFT_FIND_SEARCH_MODE_CACHE, SAFS_CLEARPROXIESALWAYS_ITEM, SAFS_COMMANDLINEBREAKPOINT_ITEM, SAFS_COMMANDLINEBREAKPOINT_VARIABLE, SAFS_PARAMS_FILE, SAFS_RESBUN_NAME, SAFS_SECSWAITFORCOMPONENT_ITEM, SAFS_SECSWAITFORCOMPONENT_VARIABLE, SAFS_SECSWAITFORWINDOW_ITEM, SAFS_SECSWAITFORWINDOW_VARIABLE, SAFS_TESTDOMAINS_ITEM, SAFS_TESTDOMAINS_VARIABLE, secsWaitForComponent, secsWaitForWindow, SENT_MSG_3, testDomains, testRecordData, testrecordStackable, TXT_FAILURE_1, TXT_FAILURE_2, TXT_FAILURE_3, TXT_FAILURE_4, TXT_FAILURE_5, TXT_SUCCESS_1, TXT_SUCCESS_2, TXT_SUCCESS_2a, TXT_SUCCESS_3, TXT_SUCCESS_3a, TXT_SUCCESS_4, TXT_SUCCESS_5, unexpectedAlertBehaviour, WARNING_MESSAGE, WARNING_OK_MESSAGE, warningStr, warningText

Constructor Summary

Constructors

Constructor and Description
CFFlexMenuBar()

Method Summary

Modifier and Type	Method and Description
protected void	doSelectMenubar(com.rational.test.ft.object.interfaces.TestObject menuObj, java.lang.String menuItemPath) Note: Called by selectMenuBar(), perform selecting menu item on Flex menu bar.
protected Tree	extractMenuItems(java.lang.Object obj, int level) Note: Overrides the superclass to extract a menu hierarchy from a FlexMenuBarTestObject.
protected com.rational.test.ft.object.interfaces.TestObject[]	getFlexMenuChildren(com.rational.test.ft.object.interfaces.TestObject menuObj) Purpose: Called by extractMenuItems() to get the children of a FlexOjectTestObject.
protected MenuTreeNode	getNewTreeNode(java.lang.Object userObject, int siblingCounter, int childrenCounter) Note: Needed to be overrided for other application than Swing.
protected java.lang.String	getPropertyText(com.rational.test.ft.object.interfaces.TestObject testObject) Note: Try to get The value of "text" property of a menuitem.
protected java.lang.String	getPropertyTextName()
protected java.lang.Integer	getSubMenuItemCount(com.rational.test.ft.object.interfaces.TestObject aMenuObj) Return the number of immediate child Menus or MenuItems from the provided JMenuBar or JMenu.
protected void	selectMenuBar(com.rational.test.ft.object.interfaces.TestObject menuObj, java.lang.String menuItemPath, boolean fuzzy, boolean verify) Note: Overrides the superclass
static Tree	staticExtractMenuItems(java.lang.Object obj, int level) Note: This method is used by the RDDGUIUtilities.java
protected void	verifyMenuBar(java.lang.Object anObj, java.lang.String menuItemPath, java.lang.String status, boolean fuzzy) Note: Overrides the superclass to handle a FlexMenuBarTestObject.

Methods inherited from class org.safs.rational.CFMenuBar

captureObjectData, convertToMap, getAbsoluteFileName, getPath, getStatus, getSubMenuItemFullPath, isMenuBar, isMenuItem, isPopupMenu, localProcess, selectMenuItem, selectMenuItemContains, selectMenuItemWithoutVerification, selectMenuItemWithVerification, selectUnverifiedMenuItem, selectUnverifiedPopupMenuItem, verifyMenuItem, verifyMenuItemContains, verifyPopupMenu

Methods inherited from class org.safs.rational.CFComponent

_maximize, _minimize, _restore, _setPosition, _setSize, captureObjectDataToFile, capturePropertiesToFile, capturePropertyToFile, clearAppMapCache, closeWindow, componentClick, convertObjectValueToString, exist, extractTreeItemsSub, findMenuBars, formatObjectData, getAppletsBrowser, getComponentRectangle, getComponentRectangleOnScreen, getHelpers, getKeepEncodingConsistent, getObjectProperty, getObjectPropertyFromProperties, getProperties, getPropertyObject, getUserObject, getWindowRectangleOnScreen, inputKeystrokes, isDotnetDomain, isFlexDomain, isHtmlDomain, isJavaDomain, isSwtDomain, isSWTWidget, isWinDomain, listAllProperties, listAllProperties, listMethods, listNonValueProperties, listProperties, matchedPathOfMenuItem, mouseClick, parseWhereInfo, performClick, performDrag, performHoverMouse, performScorll, process, selectMenuItem, sendEvent, sendFlexEvent, setKeepEncodingConsistent, setPropertyValue, tobj, verifyClipboardToFile, verifyFileToFile, verifyMenuItem, verifyObjectDataToFile, verifyPropertyContains, verifyPropertyToFile, verifyValueContains, verifyValues

Methods inherited from class org.safs.ComponentFunction

_close, action_ComputedStyle, action_getGuiImage, action_GetSaveTextFromGUI, action_showOnPage, action_verifyGuiImageToFile, assignPropertyVariable, captureObjectData, checkForCoord, checkForCoord, clearCache, close, componentExecutedFailureMessage, componentFailureMessage, componentProcess, componentSuccessMessage, convertCoords, convertLine, convertNum, convertWindowPosition, ConvertWindowPosition, deduceImageRect, dragTo, executeScript, getAlternateParams, getHelpersWorker, getPossibleMapItem, getProperty, getPropertyCollection, getPropertyCollection, getRectangleImage, getStringValue, getUUIDBoolean, guiDoesExist, hoverMouse, hoverScreenLocation, isPropertyExist, issueFileErrorFailure, issueParameterCountFailure, issueParameterCountFailure, issueParameterValueFailure, issuePassedSuccess, issuePassedSuccessUsing, issueUnknownErrorFailure, isSupportedRecordType, locateScreenImage, lookupAppMapCoordReference, lookupAppMapLineReference, lookupAppMapNumReference, lookupAppMapReference, maximize, minimize, normalizeFileEncoding, normalizePropertyCollection, restore, setIterator, setPosition, setRectVars, showComponentAsMuchPossible, updateFromTestRecordData, verifyPropertiesToFile, verifyProperty, waitForGUI, waitForObject

Methods inherited from class org.safs.Processor

activateBreakpoint, checkBreakpoints, checkMyBreakpoints, deduceBenchFile, deduceDiffFile, deduceProjectFile, deduceTestFile, delay, distributeConfigInformation, getAbsolutFileName, getAppMapItem, getChainedProcessor, getClassInstance, getClearProxiesAlways, getCustomProcClassNames, getCustomProcInstancePath, getLogUtilities, getParams, getProcClassNames, getProcInstance, getProcInstancePath, getRequiredField, getSecsWaitForComponent, getSecsWaitForWindow, getStandardErrorMessage, getTestRecordData, getUnexpectedAlertBehaviour, getVariable, hasChainedProcessor, initProcessorAndProcess, instanceProcessorAndProcess, isBreakpointsOn, isComponentFunctionRecord, isDriverCommandRecord, isEngineCommandRecord, isMyBreakpointsOn, isRecordProcessed, isRFSMCache, isRFSMOnly, issueActionFailure, issueActionOnXFailure, issueErrorPerformingAction, issueErrorPerformingActionOnX, issueErrorPerformingActionUsing, issueInputRecordFailure, issueInputRecordFailure, issuePassedSuccess, logFailureMessage, normalizeTestFileName, paramsFailedMsg, paramsFailedMsg, popTestRecord, processCustomProcessor, processSubclassProcessor, pushTestRecord, setAtEndOfProcess, setBreakpointsOn, setChainedProcessor, setClearProxiesAlways, setCommandLineBreakpoint, setCustomProcInstancePath, setLogUtilities, setMyBreakpointsOn, setParams, setProcInstance, setProcInstancePath, setRecordProcessed, setRFSMCache, setRFSMOnly, setSecsWaitForComponent, setSecsWaitForWindow, setTestDomains, setTestRecordData, setUnexpectedAlertBehaviour, setVariable, standardFailureMessage, substituteVariable, validateParamSize, validProcessorClassName

Methods inherited from class java.lang.Object

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

Constructor Detail

CFFlexMenuBar

public CFFlexMenuBar()

Method Detail

staticExtractMenuItems

public static Tree staticExtractMenuItems(java.lang.Object obj,
                                          int level)
                                   throws SAFSException

Note: This method is used by the RDDGUIUtilities.java

Throws:

SAFSException

doSelectMenubar

protected void doSelectMenubar(com.rational.test.ft.object.interfaces.TestObject menuObj,
                               java.lang.String menuItemPath)

Note: Called by selectMenuBar(), perform selecting menu item on Flex menu bar.

Parameters:

menuObj, - a FlexMenuBarTestObject

menuItemPath, - menu path like "File->Open"

selectMenuBar

protected void selectMenuBar(com.rational.test.ft.object.interfaces.TestObject menuObj,
                             java.lang.String menuItemPath,
                             boolean fuzzy,
                             boolean verify)
                      throws SAFSException

Note: Overrides the superclass

Overrides:

selectMenuBar in class CFMenuBar

Parameters:

menuObj - -- GuiSubItemTestObject representing a JMenuBar or JPopupMenu or JMenuItem or JMenu or MainMenu, MenuItem, MenuStrip, and ToolStripMenuItem

menuItemPath - -- String, path information to the final JMenu or JMenuItem or MenuItem or ToolStripMenuItem to be selected.

fuzzy - -- If false, match the given path exactly with the Menu. This parameter will not be used if verify is false.

verify - -- If true, verify existance of path before selecting.

Throws:

SAFSException

getSubMenuItemCount

protected java.lang.Integer getSubMenuItemCount(com.rational.test.ft.object.interfaces.TestObject aMenuObj)

Description copied from class: CFMenuBar

Return the number of immediate child Menus or MenuItems from the provided JMenuBar or JMenu. The routine will look for both the itemCount property and menuCount property--whichever it finds to be present.

Overrides:

getSubMenuItemCount in class CFMenuBar

Parameters:

aMenuObj - -- Typically a JMenuBar or JMenu proxy. Will be cast to TestObject.

Returns:

Integer -- the number of child Menus or MenuItems or 0.

getPropertyText

protected java.lang.String getPropertyText(com.rational.test.ft.object.interfaces.TestObject testObject)

Description copied from class: CFMenuBar

Note: Try to get The value of "text" property of a menuitem. Needed to be overrided for other application than Swing. For example: For java, "text" is the text property. But for .NET, "Text" is.

Overrides:

getPropertyText in class CFMenuBar

Returns:

The value of "text" property of a menuitem.

getPropertyTextName

protected java.lang.String getPropertyTextName()

Overrides:

getPropertyTextName in class CFMenuBar

getNewTreeNode

protected MenuTreeNode getNewTreeNode(java.lang.Object userObject,
                                      int siblingCounter,
                                      int childrenCounter)

Description copied from class: CFMenuBar

Note: Needed to be overrided for other application than Swing.

Overrides:

getNewTreeNode in class CFMenuBar

Returns:

An apporiate MenuTreeNode. For Example, a JavaMenuTreeNode for java application; a DotNetMenuTreeNode for .NET application.

getFlexMenuChildren

protected com.rational.test.ft.object.interfaces.TestObject[] getFlexMenuChildren(com.rational.test.ft.object.interfaces.TestObject menuObj)

Purpose: Called by extractMenuItems() to get the children of a FlexOjectTestObject. Among the children of a FlexMenuBarTestOjbect, only FlexMenuTestObject will be returned and others unnecessary are ignored.

Parameters:

menuObj, - a FlexObjectTestObject

Returns:

An array of TestObject found from menuObj

extractMenuItems

protected Tree extractMenuItems(java.lang.Object obj,
                                int level)
                         throws SAFSException

Note: Overrides the superclass to extract a menu hierarchy from a FlexMenuBarTestObject.

Overrides:

extractMenuItems in class CFMenuBar

Returns:

org.safs.Tree, the real instance is org.safs.rational.MenuTree

Throws:

SAFSException

verifyMenuBar

protected void verifyMenuBar(java.lang.Object anObj,
                             java.lang.String menuItemPath,
                             java.lang.String status,
                             boolean fuzzy)
                      throws SAFSException

Note: Overrides the superclass to handle a FlexMenuBarTestObject.

Overrides:

verifyMenuBar in class CFMenuBar

Parameters:

anObj - -- GuiSubItemTestObject representing a JMenuBar or JPopupMenu.

menuItemPath - -- String, the path to be selected

status - -- String, the menuItem status to be verified

fuzzy - -- If false, match the given path exactly with the Menu.

Throws:

SAFSException