com.rational.test.ft.domain.flex

Class FlexDomainProxy

java.lang.Object

RegisteredObject

com.rational.test.ft.domain.ProxyTestObject

com.rational.test.ft.domain.DomainProxy

com.rational.test.ft.domain.flex.FlexDomainProxy

All Implemented Interfaces:

IDataDriven, IProxyBase

public class FlexDomainProxy
extends DomainProxy

Field Summary

Fields inherited from class com.rational.test.ft.domain.ProxyTestObject

BROWSERTABTESTOBJECT_CLASSNAME, BROWSERTESTOBJECT_CLASSNAME, COLORDIALOGTESTOBJECT_CLASSNAME, CROSSDOMAINCONTAINER_CLASSNAME, debug, DOCUMENTTESTOBJECT_CLASSNAME, DOMAINTESTOBJECT_CLASSNAME, ECLIPSETOPLEVELTESTOBJECT_CLASSNAME, EMBEDDEDBROWSERTESTOBJECT_CLASSNAME, FILEDIALOGTESTOBJECT_CLASSNAME, FRAMESUBITEMTESTOBJECT_CLASSNAME, FRAMETESTOBJECT_CLASSNAME, GEFEDITPARTTESTOBJECT_CLASSNAME, GUISUBITEMTESTOBJECT_CLASSNAME, GUITESTOBJECT_CLASSNAME, INTERNALFRAMETESTOBJECT_CLASSNAME, MESSAGEBOXTESTOBJECT_CLASSNAME, PALETTEGUISUBITEMTESTOBJECT_CLASSNAME, PROCESSTESTOBJECT_CLASSNAME, SCROLLSUBITEMTESTOBJECT_CLASSNAME, SCROLLTESTOBJECT_CLASSNAME, SELECTGUISUBITEMTESTOBJECT_CLASSNAME, SELECTSCROLLGUISUBITEMTESTOBJECT_CLASSNAME, SHELLTESTOBJECT_CLASSNAME, STATELESSGUISUBITEMTESTOBJECT_CLASSNAME, SUBITEMTESTOBJECT_CLASSNAME, TABITEMTESTOBJECT_CLASSNAME, TESTOBJECT_CLASSNAME, TEXTGUISUBITEMTESTOBJECT_CLASSNAME, TEXTGUITESTOBJECT_CLASSNAME, TEXTSCROLLTESTOBJECT_CLASSNAME, TEXTSELECTGUISUBITEMTESTOBJECT_CLASSNAME, TIMEOUTTESTOBJECT_CLASSNAME, TOGGLEGUITESTOBJECT_CLASSNAME, TOGGLETESTOBJECT_CLASSNAME, TOPLEVELSUBITEMTESTOBJECT_CLASSNAME, TOPLEVELTESTOBJECT_CLASSNAME, TRACKBARTESTOBJECT_CLASSNAME, vomClippedRectangle

Fields inherited from interface com.rational.test.ft.domain.IDataDriven

INCLUDE_ALL, INCLUDE_JUSTOBJECT, INCLUDE_SIBLINGS

Constructor Summary

Constructors

Constructor and Description
FlexDomainProxy(FlexTestDomainImplementation theDomain)

Method Summary

Methods

Modifier and Type	Method and Description
java.util.Hashtable	getProperties() Returns a complete set of properties for the associated test object.
java.lang.Object	getProperty(java.lang.String propertyName) Gets the value for a specific property defined in getProperties() or getRecognitionProperties().
MethodSpecification	getProxyEvents()
java.util.Hashtable	getRecognitionProperties() Returns an enumeration of properties used to identify the associated test object.
int	getRecognitionPropertyWeight(java.lang.String propertyName) Returns an indication of how useful this property is for recognition.
java.util.Hashtable	getStandardProperties() Returns a complete set of consistent properties for the associated test object.
java.util.Hashtable	getTestDataTypes() Returns a hashtable of data type descriptions of the verification point data available with the associated object.
TestDomainImplementation	getTestDomain() Returns the TestDomain that this proxy object is associated with.
void	PrepareDomainsForRecording()
void	prepareToStop() Prepare the domain to stop while stopping the recorder.
void	readyToStop() Prepare the domain to stop while stopping the recorder.
void	setProperty(java.lang.String propertyName, java.lang.Object value) Sets the value for a specific property defined in getProperties() or getRecognitionProperties().
boolean	shouldBeMapped() Determines whether the object is interesting from a persistent testability sense and should therefore be added to the object map.

Methods inherited from class com.rational.test.ft.domain.DomainProxy

addRecognitionProperty, getChildren, getDescriptiveName, getImplementationName, getIndexer, getIndexers, getMappableChildren, getMappableParent, getMethods, getMethodSpecForPoint, getName, getNonValueProperties, getOwnedObjects, getOwner, getParent, getTestObjectClassName, getTopMappableParent, getTopObjects, getTopParent, getUniqueId, hasAddedRecognitionProperties, hasImageVPSupport, invokeConstructor, invokeStaticMethod, prepareDomainsForRecording, processMouseEvent, setIndexer

Methods inherited from class com.rational.test.ft.domain.ProxyTestObject

addDataDrivableCommands, baseClassMatch, canTakeVP, equals, findChildrenWithProperties, findChildrenWithPropertiesAndInvoke, getChannel, getChildren, getDataDrivableCommand, getDataDrivableCommands, getElementWithFocus, getField, getIgnorableProperties, getMappableChildren, getMappableParent, getObjectClassName, getObjectCustomClassName, getOwnedObjects, getParent, getProxy, getRole, getScriptCommandAnchor, getScriptCommandFlags, getTestData, getVisualClippableParent, getVisualClippedRectangle, getVisualMappableChildren, getVisualTopParent, getVOMSpecificProperty, hasSpecialFrameState, isClassIndexConsidered, isSameObject, isValidObject, ping, suppressKeyAction, updateTestData

Methods inherited from class java.lang.Object

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

Constructor Detail

FlexDomainProxy

public FlexDomainProxy(FlexTestDomainImplementation theDomain)

Method Detail

getProperties

public java.util.Hashtable getProperties()

Description copied from class: ProxyTestObject

Returns a complete set of properties for the associated test object. The meaning of a property is specific to the test domain and the test object. Typically, this is a set of name/value pairs that describe the test object and its active state. Properties such as font, colors, and coordinate information are typically associated with a GUI test object. Associated data and state information can also be returned, depending on the test object.

This method does not return properties whose values are references to objects. The method ProxyTestObject.getNonValueProperties() returns information about such properties.

Specified by:

getProperties in class ProxyTestObject

Returns:

The set of known properties associated with a test object.

See Also:

ProxyTestObject.getProperty(String), ProxyTestObject.setProperty(String,Object), ProxyTestObject.getStandardProperties(), ProxyTestObject.getNonValueProperties()

getProperty

public java.lang.Object getProperty(java.lang.String propertyName)

Description copied from class: ProxyTestObject

Gets the value for a specific property defined in getProperties() or getRecognitionProperties(). If the property is not defined by either of these methods, this method throws PropertyNotFoundException.

Specified by:

getProperty in class ProxyTestObject

Parameters:

propertyName - The name of the property to fetch.

Returns:

The active value of the specified property for the associated test object.

See Also:

ProxyTestObject.getProperties(), ProxyTestObject.setProperty(String,Object), ProxyTestObject.getRecognitionProperties(), ProxyTestObject.addRecognitionProperty(String,Object,int)

getRecognitionProperties

public java.util.Hashtable getRecognitionProperties()

Description copied from class: ProxyTestObject

Returns an enumeration of properties used to identify the associated test object. Useful recognition properties are properties such as the programmatic name or a persistent description. Less interesting are the visible text on a button or label, or the tooltip text, or the foreground color. Uninteresting properties are the transient properties such as hasFocus or isShowing.

Specified by:

getRecognitionProperties in class ProxyTestObject

Returns:

An enumeration of recognition properties. The returned objects are of class TestObjectProperty.

See Also:

ProxyTestObject.getRecognitionPropertyWeight(String), ProxyTestObject.getProperty(String), ProxyTestObject.addRecognitionProperty(String,Object,int)

getRecognitionPropertyWeight

public int getRecognitionPropertyWeight(java.lang.String propertyName)

Description copied from class: ProxyTestObject

Returns an indication of how useful this property is for recognition. A value of 0 indicates not useful at all, and a value of 100 indicates that the property is extremely useful for recognition. This method must return a value greater than or equal to zero and less than or equal to 100.

Specified by:

getRecognitionPropertyWeight in class ProxyTestObject

Parameters:

propertyName - The name of the recognition property to return a weight value for.

See Also:

ProxyTestObject.getRecognitionProperties()

getStandardProperties

public java.util.Hashtable getStandardProperties()

Description copied from class: ProxyTestObject

Returns a complete set of consistent properties for the associated test object. Consistent properties are those properties that exist regardless of the platform the test object is running on. Domains that do not support the notion of standard properties should implement this method identically to ProxyTestObject.getProperties(). The HTML domain supports standard properties and returns properties that are consistent across browser versions. The Java domain does not support this notion of standard properties. In this domain, getStandardProperties, and getProperties do the same thing. For HTML, standard properties are a subset of the properties returned by getProperties(). The meaning of a property is specific to the test domain and the test object. Typically, this is a set of name/value pairs that describe the test object and its active state. Properties such as font, colors, and coordinate information are typically associated with a GUI test object. Associated data and state information can also be returned, depending on the test object.

Specified by:

getStandardProperties in class ProxyTestObject

Returns:

The set of standard properties associated with a test object.

See Also:

ProxyTestObject.getProperty(String), ProxyTestObject.setProperty(String,Object), ProxyTestObject.getProperties(), ProxyTestObject.getNonValueProperties()

getTestDataTypes

public java.util.Hashtable getTestDataTypes()

Description copied from class: ProxyTestObject

Returns a hashtable of data type descriptions of the verification point data available with the associated object. The hashtable keys are String objects that are used as the VP type in the associated test data. The type is a simple value that is different from other type values associated with this object under test. The type keys map to a verbose description of the test data, reasonable for presentation to a user.

Specified by:

getTestDataTypes in class ProxyTestObject

Returns:

An hashtable of type/description pairs used to describe the verification data available from this proxy.

See Also:

ProxyTestObject.getTestData(String), com.rational.test.ft.vp.ITestData

setProperty

public void setProperty(java.lang.String propertyName,
               java.lang.Object value)

Description copied from class: ProxyTestObject

Sets the value for a specific property defined in getProperties() or getRecognitionProperties(). Properties not defined by either of these methods, and properties whose values cannot be modified throw an appropriately populated PropertyNotFoundException.

Specified by:

setProperty in class ProxyTestObject

Parameters:

propertyName - The name of the property to redefine. This name is the same as that returned by getProperties().

See Also:

ProxyTestObject.getProperties(), ProxyTestObject.getProperty(String)

shouldBeMapped

public boolean shouldBeMapped()

Description copied from class: ProxyTestObject

Determines whether the object is interesting from a persistent testability sense and should therefore be added to the object map. An object is considered interesting under one or more of the following conditions:

• Significant user actions can be performed against the object.
• The object contains testable properties.
• The object has interesting data associated with it.

Examples of objects that are not interesting include:

• Simple container objects with no interesting data.
• Decorative objects with no interesting side effects.
• Duplicate objects (mirroring data from another available object).

Note that if the object is a container, the children are examined even if this method returns false.

Specified by:

shouldBeMapped in class ProxyTestObject

Returns:

true if the represented control is interesting other than for nested objects.

getProxyEvents

public MethodSpecification getProxyEvents()

PrepareDomainsForRecording

public void PrepareDomainsForRecording()

prepareToStop

public void prepareToStop()

Description copied from class: DomainProxy

Prepare the domain to stop while stopping the recorder. For Domains like SAP we have to flush the events in the automation event queue before stopping the recorder, otherwise some of the user recorded actions will not get recorded. Domains that implement prepareToStop has to notify the recorder by invoking recorder.setPrepareToStopDomain() when it is finished with the logic to flush the events. Once the recorder is notified of domain that are in prepare to stop state, the recorder will once again call the domains before stopping the recorder by calling readyToStop() in domains. IMPORTANT : Whoever implementing the prepareToStop() should also implement the routine readyToStop() in domains and should notify the recorder that it is done by invoking recorder.setReadyToStopDomain().

Overrides:

prepareToStop in class DomainProxy

readyToStop

public void readyToStop()

Description copied from class: DomainProxy

Prepare the domain to stop while stopping the recorder. For Domains like SAP we have to flush the events in the automation event queue before stopping the recorder, otherwise some of the user recorded actions will not get recorded. This routine be implemented only if prepareToStop() has been implemeted in the domains. This routine makes sure that all the flushing has been happend by the logic implemented in the prepareToStop() and it notifies the recorder that it can go ahead with the stopping of the recorder by invoking recorder.setReadyToStopDomain()

Overrides:

readyToStop in class DomainProxy

getTestDomain

public TestDomainImplementation getTestDomain()

Description copied from class: DomainProxy

Returns the TestDomain that this proxy object is associated with.

Specified by:

getTestDomain in interface IProxyBase

Overrides:

getTestDomain in class DomainProxy

Returns:

The associated TestDomain.