org.safs.rational

Class DCDriverCommand

java.lang.Object

org.safs.Processor

org.safs.DriverCommand

org.safs.rational.DCDriverCommand

All Implemented Interfaces:

ITestRecordStackable, RuntimeDataInterface

public class DCDriverCommand
extends DriverCommand

Purpose: DCDriverCommand, process a default generic driver command
Lifetime: instantiated by DriverCommandProcessor

Since:

JUN 14, 2003

Author:

Doug Bauman

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CALLSCRIPT
static java.lang.String	CAPTUREMOUSEPOSITIONONSCREEN
static java.lang.String	CLEARAPPMAPCACHE
static java.lang.String	CLOSEAPPLICATION
static java.lang.String	DISABLE_DOMAIN
static java.lang.String	ENABLE_DOMAIN
static java.lang.String	GET_SECS_AFTER_WIN_ACTIVE
static java.lang.String	GET_SECS_BEFORE_MOUSE_DOWN
static java.lang.String	GET_SECS_BEFORE_MOUSE_UP
static java.lang.String	GET_SECS_DELAY_RETRY_COMPONENT
static java.lang.String	GET_SECS_SEEK_COMPONENT
static java.lang.String	LAUNCHAPPLICATION
static java.lang.String	ONGUIEXISTSGOTOBLOCKID
static java.lang.String	ONGUINOTEXISTGOTOBLOCKID
static java.lang.String	ONMENUITEMCONTAINSSTATEGOTOBLOCKID
protected RDDGUIUtilities	rgu A convenient GUIUtilities
static java.lang.String	SCROLLWHEEL
static java.lang.String	SET_SECS_AFTER_WIN_ACTIVE
static java.lang.String	SET_SECS_BEFORE_MOUSE_DOWN
static java.lang.String	SET_SECS_BEFORE_MOUSE_UP
static java.lang.String	SET_SECS_DELAY_RETRY_COMPONENT
static java.lang.String	SET_SECS_SEEK_COMPONENT
static java.lang.String	SETCONTEXT
static java.lang.String	SETFOCUS
static java.lang.String	WAITFORGUI
static java.lang.String	WAITFORGUIGONE
static java.lang.String	WAITFORPROPERTYVALUE
static java.lang.String	WAITFORPROPERTYVALUEGONE
static java.lang.String	WAITFORWEBPAGE

Fields inherited from class org.safs.DriverCommand

command, iterator, utils

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
DCDriverCommand() Purpose: constructor, calls super

Method Summary

Modifier and Type	Method and Description
protected boolean	checkGUIExistence(boolean expectedExist, java.lang.String mapNam, java.lang.String window, java.lang.String component, int timeoutInSeconds) Check the existence of the window/component and return the satisfaction of the existence. The satisfaction depends on component's existence and our expectation of its existence. Subclass only need to implement this method to get the following keywords work.
void	commandProcess() Purpose: process: process the testRecordData This is a driver command processor.
protected void	init() Convert the general GUIUtilities to a specific one.

Methods inherited from class org.safs.DriverCommand

getStandardFailureDetail, getStandardWarningDetail, interpretFields, issueActionUsingNegativeMessage, issueActionWarning, issueExecutionNegativeMessage, issueFileErrorFailure, issueGenericSuccess, issueGenericSuccess, issueGenericSuccessUsing, issueParameterCountFailure, issueParameterCountFailure, issueParameterValueFailure, issuePassedSuccess, issueUnknownErrorFailure, isSupportedRecordType, localProcess, process

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

CALLSCRIPT

public static final java.lang.String CALLSCRIPT

See Also:

Constant Field Values

WAITFORGUI

public static final java.lang.String WAITFORGUI

See Also:

Constant Field Values

WAITFORGUIGONE

public static final java.lang.String WAITFORGUIGONE

See Also:

Constant Field Values

CLEARAPPMAPCACHE

public static final java.lang.String CLEARAPPMAPCACHE

See Also:

Constant Field Values

CLOSEAPPLICATION

public static final java.lang.String CLOSEAPPLICATION

See Also:

Constant Field Values

LAUNCHAPPLICATION

public static final java.lang.String LAUNCHAPPLICATION

See Also:

Constant Field Values

WAITFORPROPERTYVALUE

public static final java.lang.String WAITFORPROPERTYVALUE

See Also:

Constant Field Values

WAITFORPROPERTYVALUEGONE

public static final java.lang.String WAITFORPROPERTYVALUEGONE

See Also:

Constant Field Values

WAITFORWEBPAGE

public static final java.lang.String WAITFORWEBPAGE

See Also:

Constant Field Values

SETCONTEXT

public static final java.lang.String SETCONTEXT

See Also:

Constant Field Values

SETFOCUS

public static final java.lang.String SETFOCUS

See Also:

Constant Field Values

CAPTUREMOUSEPOSITIONONSCREEN

public static final java.lang.String CAPTUREMOUSEPOSITIONONSCREEN

See Also:

Constant Field Values

ONGUIEXISTSGOTOBLOCKID

public static final java.lang.String ONGUIEXISTSGOTOBLOCKID

See Also:

Constant Field Values

ONGUINOTEXISTGOTOBLOCKID

public static final java.lang.String ONGUINOTEXISTGOTOBLOCKID

See Also:

Constant Field Values

ENABLE_DOMAIN

public static final java.lang.String ENABLE_DOMAIN

See Also:

Constant Field Values

DISABLE_DOMAIN

public static final java.lang.String DISABLE_DOMAIN

See Also:

Constant Field Values

ONMENUITEMCONTAINSSTATEGOTOBLOCKID

public static final java.lang.String ONMENUITEMCONTAINSSTATEGOTOBLOCKID

See Also:

Constant Field Values

SET_SECS_SEEK_COMPONENT

public static final java.lang.String SET_SECS_SEEK_COMPONENT

See Also:

Constant Field Values

SET_SECS_DELAY_RETRY_COMPONENT

public static final java.lang.String SET_SECS_DELAY_RETRY_COMPONENT

See Also:

Constant Field Values

SET_SECS_AFTER_WIN_ACTIVE

public static final java.lang.String SET_SECS_AFTER_WIN_ACTIVE

See Also:

Constant Field Values

GET_SECS_SEEK_COMPONENT

public static final java.lang.String GET_SECS_SEEK_COMPONENT

See Also:

Constant Field Values

GET_SECS_DELAY_RETRY_COMPONENT

public static final java.lang.String GET_SECS_DELAY_RETRY_COMPONENT

See Also:

Constant Field Values

GET_SECS_AFTER_WIN_ACTIVE

public static final java.lang.String GET_SECS_AFTER_WIN_ACTIVE

See Also:

Constant Field Values

SCROLLWHEEL

public static final java.lang.String SCROLLWHEEL

See Also:

Constant Field Values

GET_SECS_BEFORE_MOUSE_UP

public static final java.lang.String GET_SECS_BEFORE_MOUSE_UP

See Also:

Constant Field Values

GET_SECS_BEFORE_MOUSE_DOWN

public static final java.lang.String GET_SECS_BEFORE_MOUSE_DOWN

See Also:

Constant Field Values

SET_SECS_BEFORE_MOUSE_UP

public static final java.lang.String SET_SECS_BEFORE_MOUSE_UP

See Also:

Constant Field Values

SET_SECS_BEFORE_MOUSE_DOWN

public static final java.lang.String SET_SECS_BEFORE_MOUSE_DOWN

See Also:

Constant Field Values

rgu

protected RDDGUIUtilities rgu

A convenient GUIUtilities

Constructor Detail

DCDriverCommand

public DCDriverCommand()

Purpose: constructor, calls super

Method Detail

init

protected void init()
             throws SAFSException

Convert the general GUIUtilities to a specific one.

Overrides:

init in class DriverCommand

Throws:

SAFSException

commandProcess

public void commandProcess()

Purpose: process: process the testRecordData
This is a driver command processor.
Side Effects: Processor.testRecordData statusCode is set based on the result of the processing; processedCommand is set to false if we do not recognize this command
State Read: Processor.testRecordData, Processor.params
Assumptions: none

Overrides:

commandProcess in class DriverCommand

checkGUIExistence

protected boolean checkGUIExistence(boolean expectedExist,
                                    java.lang.String mapNam,
                                    java.lang.String window,
                                    java.lang.String component,
                                    int timeoutInSeconds)
                             throws SAFSException

Description copied from class: DriverCommand

Check the existence of the window/component and return the satisfaction of the existence.
The satisfaction depends on component's existence and our expectation of its existence.
Subclass only need to implement this method to get the following keywords work.

• OnGUIExistsGotoBlockID
• OnGUINotExistGotoBlockID

Overrides:

checkGUIExistence in class DriverCommand

Parameters:

expectedExist - boolean, the expected existence of the window/component.
when true is provided, if the component is present within timeout, then it return true; otherwise return false;
when false is provided, if the component is not present or disappears within timeout, then it return true; otherwise return false;

mapNam - String, the map name

window - String, the window's name

component - String, the component's name

timeoutInSeconds - int, the timeout in seconds

Returns:

boolean, true if the expected presence is satisfied

Throws:

SAFSException - is thrown out if there is something wrong.

See Also:

DriverCommand.onGUIGotoCommands(boolean)