org.safs.rational

Class REngineCommandProcessor

java.lang.Object

org.safs.Processor

org.safs.EngineCommandProcessor

org.safs.rational.REngineCommandProcessor

All Implemented Interfaces:

ITestRecordStackable, RuntimeDataInterface

public class REngineCommandProcessor
extends EngineCommandProcessor

REngineCommandProcessor works with RRobotJHook. Instantiated in RRobotJHook.initializeUtilities(). RGuiObjectVector (engine-specific) also is instantiated in RRobotJHook.initializeUtilities(). Engine commands that are not handled in this class, shall be handled by its parent class: EngineCommandProcessor.

Since:

AUG 14, 2008

Author:

JunwuMa AUG 14, 2008 Original Release One feature: Engine command 'highlightMatchingChildObject' is able to locate a target GUI object, and highlight it by drawing its border in red if found. This new engine command is called in STAFProcessContainer.
JunwuMa OCT 17, 3008 Add flex support.
JunwuMa NOV 07, 2008 Modified _highlightMatchingChildObject() supporting the top most GUI window can be highlighted.
JunwuMa OCT 22, 2009 Adding two commands getMatchingChildKeysAtPoint, highlightMatchingChildObjectByKey.
LeiWang NOV 02, 2010 Adding method _getComponentRectangle().
JunwuMa MAR 15, 2011 Fixed the issue of highlight not working with RFT8.2 against Flex applications loaded by AutomationModuleRFT.swf.
JunwuMa MAR 16, 2012 Adding support for 'getObjectRecognitionAtScreenCoords' in RFT engine.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COMMAND_CLEAR_HIGHLIGHTED_DIALOG clearHighlightedDialog
static java.lang.String	COMMAND_GET_COMPONET_RECTANGLE getComponentRectangle
static java.lang.String	COMMAND_GET_MATCHING_CHILDKEYS_ATPOINT getMatchingChildKeysAtPoint
static java.lang.String	COMMAND_GET_TOP_WINDOW_HANDLE getTopWindowHandle
static java.lang.String	COMMAND_HIGHLIGHT_MATCHING_CHILD_OBJECT highlightMatchingChildObject
static java.lang.String	COMMAND_HIGHLIGHT_MATCHING_CHILD_OBJECT_BYKEY highlightMatchingChildObjectByKey

Fields inherited from class org.safs.EngineCommandProcessor

command, COMMAND_ENABLE_DOMAINS, COMMAND_GET_ACCESSIBLENAME, COMMAND_GET_CAPTION, COMMAND_GET_CHILD_COUNT, COMMAND_GET_CHILDREN, COMMAND_GET_CLASSINDEX, COMMAND_GET_CLASSNAME, COMMAND_GET_DOMAINNAME, COMMAND_GET_ID, COMMAND_GET_LEVEL, COMMAND_GET_MATCHING_CHILD_OBJECTS, COMMAND_GET_MATCHING_PARENT_OBJECT, COMMAND_GET_MATCHING_PATH_OBJECT, COMMAND_GET_NAME, COMMAND_GET_NONACCESSIBLENAME, COMMAND_GET_OBJECTRECOGNITION_ATSCREENCOORDS, COMMAND_GET_PROPERTY, COMMAND_GET_PROPERTY_NAMES, COMMAND_GET_STRING_DATA, COMMAND_GET_SUPER_CLASSNAMES, COMMAND_GET_TEXT, COMMAND_GET_TOPLEVEL_COUNT, COMMAND_GET_TOPLEVEL_WINDOWS, COMMAND_IS_MATCHING_PATH, COMMAND_IS_SHOWING, COMMAND_IS_TOPLEVEL_POPUP_CONTAINER, COMMAND_IS_VALID, COMMAND_SET_ACTIVE_WINDOW

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
REngineCommandProcessor()

Method Summary

Modifier and Type	Method and Description
static com.rational.test.ft.object.interfaces.GuiTestObject	_getChildAtPoint(com.rational.test.ft.object.interfaces.TestObject anObject, java.awt.Point pt) Attempt to locate the child GuiTestObject at a specific point.
protected java.lang.String	genIdInformation(com.rational.test.ft.object.interfaces.TestObject obj, GuiObjectRecognition gor)
protected boolean	getRecogPropertyWithTopWeight(com.rational.test.ft.object.interfaces.TestObject obj, java.lang.StringBuffer rtlkey, java.lang.StringBuffer rtlvalue)
void	process() By default executes setRecordProcessed(false) if no chainedProcessor is present.
protected java.lang.String	recognitionOfObjectAtPoint(int x, int y)

Methods inherited from class org.safs.EngineCommandProcessor

_getObjectRecognitionAtScreenCoords, convertToDelimitedString, getEngineCommand, getGuiObjectVector, interpretFields, isSupportedRecordType, setGuiObjectVector

Methods inherited from class org.safs.Processor

activateBreakpoint, checkBreakpoints, checkMyBreakpoints, deduceBenchFile, deduceDiffFile, deduceProjectFile, deduceTestFile, delay, distributeConfigInformation, getAbsolutFileName, getAlternateParams, 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

Field Detail

COMMAND_HIGHLIGHT_MATCHING_CHILD_OBJECT

public static final java.lang.String COMMAND_HIGHLIGHT_MATCHING_CHILD_OBJECT

highlightMatchingChildObject

See Also:

Constant Field Values

COMMAND_HIGHLIGHT_MATCHING_CHILD_OBJECT_BYKEY

public static final java.lang.String COMMAND_HIGHLIGHT_MATCHING_CHILD_OBJECT_BYKEY

highlightMatchingChildObjectByKey

See Also:

Constant Field Values

COMMAND_CLEAR_HIGHLIGHTED_DIALOG

public static final java.lang.String COMMAND_CLEAR_HIGHLIGHTED_DIALOG

clearHighlightedDialog

See Also:

Constant Field Values

COMMAND_GET_MATCHING_CHILDKEYS_ATPOINT

public static final java.lang.String COMMAND_GET_MATCHING_CHILDKEYS_ATPOINT

getMatchingChildKeysAtPoint

See Also:

Constant Field Values

COMMAND_GET_COMPONET_RECTANGLE

public static final java.lang.String COMMAND_GET_COMPONET_RECTANGLE

getComponentRectangle

See Also:

Constant Field Values

COMMAND_GET_TOP_WINDOW_HANDLE

public static final java.lang.String COMMAND_GET_TOP_WINDOW_HANDLE

getTopWindowHandle

See Also:

Constant Field Values

Constructor Detail

REngineCommandProcessor

public REngineCommandProcessor()

Method Detail

process

public void process()

Description copied from class: EngineCommandProcessor

By default executes setRecordProcessed(false) if no chainedProcessor is present.

Overrides:

process in class EngineCommandProcessor

_getChildAtPoint

public static com.rational.test.ft.object.interfaces.GuiTestObject _getChildAtPoint(com.rational.test.ft.object.interfaces.TestObject anObject,
                                                                                    java.awt.Point pt)

Attempt to locate the child GuiTestObject at a specific point. It is assumed anObject is a parent container of the desired child at some level. anObject is normally a GuiTestObject, but can also be a CrossDomainContainer.

Parameters:

anObject - -- normally a GuiTestObject or CrossDomainContainer

Returns:

the child at the point or null.

recognitionOfObjectAtPoint

protected java.lang.String recognitionOfObjectAtPoint(int x,
                                                      int y)

Overrides:

recognitionOfObjectAtPoint in class EngineCommandProcessor

genIdInformation

protected java.lang.String genIdInformation(com.rational.test.ft.object.interfaces.TestObject obj,
                                            GuiObjectRecognition gor)

getRecogPropertyWithTopWeight

protected boolean getRecogPropertyWithTopWeight(com.rational.test.ft.object.interfaces.TestObject obj,
                                                java.lang.StringBuffer rtlkey,
                                                java.lang.StringBuffer rtlvalue)