com.rational.test.ft.domain.html.generichtmlsubdomain

Class GenericHtmlGuiProxy

java.lang.Object

RegisteredObject

com.rational.test.ft.domain.ProxyTestObject

com.rational.test.ft.domain.html.HtmlProxy

com.rational.test.ft.domain.html.HtmlGuiProxy

com.rational.test.ft.domain.html.generichtmlsubdomain.GenericHtmlGuiProxy

All Implemented Interfaces:

IDataDriven, IGetInterestingRecogProsForDynFind, IHtmlCustomDomainEnablement, IInternalObjectStatus, IProxyBase, IQuickFind, IXPathFind

Direct Known Subclasses:

DojoAccordionPaneProxy, DojoAccordionProxy, DojoColorPaletteProxy, DojoContainerProxy, DojoEditorProxy, DojoFloatingPaneProxy, DojoGenericProxy, DojoGridCellProxy, DojoGridRowProxy, DojoPopupProxy, DojoSliderProxy, DojoSpinnerProxy, DojoSplitContainerSizerProxy, DojoTabContainerProxy, DojoTabPaneProxy, DojoTimeMenuProxy, DojoTitlePaneProxy, DojoTooltipProxy, GenericCalenderProxy, GenericCheckboxProxy, GenericComboboxDropdownProxy, GenericComboboxProxy, GenericDatatipProxy, GenericDefaultProxy, GenericDropdownMenuItemProxy, GenericDropdownMenuProxy, GenericItemListBoxProxy, GenericListItemProxy, GenericMenuItemProxy, GenericMenuProxy, GenericNavigationListProxy, GenericOptionProxy, GenericPopupTriggerProxy, GenericProgressIndicatorProxy, GenericPushbuttonProxy, GenericRadioButtonProxy, GenericScrollContainerProxy, GenericTableProxy, GenericTabStripProxy, GenericTextareaProxy, GenericThresholdsliderProxy, GenericToolbarProxy, GenericTreeExpandCollapseNodeProxy, GenericTreeNodeProxy, GenericTreeProxy

public class GenericHtmlGuiProxy
extends HtmlGuiProxy

This is the Lorenzo HTML GUI object proxies base class, all LORENZO HTML GUI proxies must extend this class. The abstract ProxyTestObject base class defines the non-GUI object properties required to implement a proxy object. This abstract class extends that definition with the additional properties needed for a GUI object.

This class further contains the default implementation of various base class methods that proxy implementations may need to extend or override.

• TestObject Interface: GuiTestObject
  
  
• Supported Test Data Types:
  

  Type	Desciption
  text	Visible Text	ITestDataText

  
  
• Default Recognition Properties:
  • .class
  • .classIndex
  • .id
  • .title
  
  
• Supported Canonical Properties:
  

  Property	Usage
  .bounds	A rectangle representing the bounding rectangle of the object in screen coordinates.
  .class	This is the test object class name, for example "HtmlTable" for a <Table> element.
  .id	This is the value of the id attribute of an element.
  .name	This is the value of the name attribute (Form elements and Frames only)
  .offsetHeight	The height of the element.
  .offsetLeft	The offset of the element from its offset parent in the DOM.
  .offsetTop	The offset of the element from its offset parent in the DOM.
  .offsetWidth	The width of the element.
  .tag	This is the Html tag for the element
  .text	This is the text inside of the HTML tags for bounding the element. For example, <A>This is an Anchor<IMG src=map.gif></a> the text property will return "This is an Anchor. All white space are combined and reduced to a single a blank character if consecutive white space characters are found.
  .title	This is the value of the title attribute of an element. This is frequently the text displayed when hovering over the element with the mouse.

  
  

Since:

2.0

Nested Class Summary

Nested classes/interfaces inherited from class com.rational.test.ft.domain.html.HtmlGuiProxy

HtmlGuiProxy.Clicker, HtmlGuiProxy.DoubleClicker, HtmlGuiProxy.Dragger, HtmlGuiProxy.Hoverer, HtmlGuiProxy.nClickDragger, HtmlGuiProxy.nClicker, HtmlGuiProxy.PointIterator

Nested classes/interfaces inherited from class com.rational.test.ft.domain.html.HtmlProxy

HtmlProxy.GetObjectRunnable, HtmlProxy.HtmlElementEnumeration, HtmlProxy.IntegerByReference, HtmlProxy.InvalidNativeHandleException, HtmlProxy.JSObjectHtmlElementEnumeration, HtmlProxy.NativeProxyReleasedException

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String[]	defaultRecognitionProperty
static java.lang.String	DISPLAYPROPERTY
java.lang.String	subDomain

Fields inherited from class com.rational.test.ft.domain.html.HtmlGuiProxy

currentMethod, LEFT, OFFSETHEIGHTPROPERTY, OFFSETLEFTPROPERTY, OFFSETRECTPROPERTY, OFFSETTOPPROPERTY, OFFSETWIDTHPROPERTY

Fields inherited from class com.rational.test.ft.domain.html.HtmlProxy

BOUNDSPROPERTY, channel, CLASSINDEX, CLASSPROPERTY, CLIENTRECTPROPERTY, debug, DISABLEDPROPERTY, DOCCLASSINDEX, dojoProps, domain, HTMLPROXYCHANNELRUNNABLE_TIMEOUTVALUE, IDPROPERTY, isSiebelActive, jswarapper, NAMEPROPERTY, parentsTextDescendantsMayBeInteresting, READONLYPROPERTY, TAGPROPERTY, TESTDATA_TEXT, TEXTPROPERTY, TITLEPROPERTY, UNIQUEIDPROPERTY

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

BROWSERTABTESTOBJECT_CLASSNAME, BROWSERTESTOBJECT_CLASSNAME, COLORDIALOGTESTOBJECT_CLASSNAME, CROSSDOMAINCONTAINER_CLASSNAME, 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.IHtmlCustomDomainEnablement

CUSTOM_DOMAIN_LIST, DOJO_CUSTOM_DOMAIN_NAME, SAPWEBPORTAL_CUSTOM_DOMAIN_NAME

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

INCLUDE_ALL, INCLUDE_JUSTOBJECT, INCLUDE_SIBLINGS

Constructor Summary

Constructors

Constructor and Description
GenericHtmlGuiProxy(HtmlTestDomainImplementation domain, IChannel channel, long handle)
GenericHtmlGuiProxy(HtmlTestDomainImplementation domain, IChannel channel, long handle, IBrowserCommunicator jswrap)

Method Summary

Methods

Modifier and Type	Method and Description
protected java.lang.Boolean	calculateParentsTextDescendantsMayBecomeInteresting()
static long	getAncestorAtLevel(HtmlProxy proxy, long origHandle, int numOfLevels)
static long	getAncestorHandleMatchingByPropertyNames(HtmlProxy proxy, java.lang.String regexClassMatch, java.util.ArrayList propertyNames, int maxLevels)
static long	getAncestorHandleMatchingProperty(HtmlProxy proxy, java.lang.String[] regexArray, java.lang.String propertyName, int maxLevels)
static long	getAncestorHandleMatchingProperty(HtmlProxy proxy, java.lang.String regexClassMatch, java.lang.String propertyName, int maxLevels)
static long	getAncestorHandleMatchingProperty(HtmlProxy proxy, java.lang.String regexClassMatch, java.lang.String propertyName, int maxLevels, long startingHandle)
static long	getAncestorHandleMatchingProperty(HtmlProxy proxy, java.lang.String regexClassMatch, java.lang.String regexClassNotMatch, java.lang.String propertyName, int maxLevels)
ProxyTestObject[]	getHtmlChildren()
ProxyTestObject	getHtmlParent()
java.lang.String	getObjectCustomClassName() Returns the custom class name of the associated object.
java.lang.Object	getProperty(java.lang.String propertyName) Get the value for a specific property.
java.lang.String	getSubDomain()
java.lang.String	getVisibleTextProperty() Returns an enumeration of properties used to uniquely identify the associated test object in the SUT.
boolean	isEnabled()
boolean	isVisible()
protected java.util.Vector	setClickArgs(int modifiers, java.util.Vector clickArgs) Set args for click (depends on clickArgs member variable set by getActionArgs in PRE_DOWN)
protected java.util.Vector	setDownPointArgs(int modifiers, java.util.Vector clickArgs)
protected void	setMethodSpecification(ProxyTestObject proxy, IMouseActionInfo action, java.lang.String method, java.util.Vector args)
protected void	setMethodSpecification(ProxyTestObject proxy, IMouseActionInfo action, java.lang.String method, java.util.Vector args, ScriptCommandFlags flags)
boolean	setSubDomain(java.lang.String subDomain)
boolean	shouldBeMapped() Always returns true, because all HTML LORENZO GUI objects are interesting.

Methods inherited from class com.rational.test.ft.domain.html.HtmlGuiProxy

activateTopWindow, click, click, click, clickAtScreenPoint, clickWithMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouseN, convertFromScreenToOffset, doScroll, doubleClick, doubleClick, doubleClick, doubleClickAtScreenPoint, drag, drag, drag, drag, dragAtScreenPoint, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, ensureObjectIsVisible, getActionArgs, getChildAtPoint, getChildAtPoint, getChildAtPointN, getChildrenHandlesMatchingProperty, getClippedScreenRectangle, getClippingParent, getClippingParentRectangle, getCurrentMethod, getDefaultActionArgs, getDefaultPointToClick, getDefaultPointToClick, getMethodName, getMethodSpecForPoint, getPointFromAction, getPointOnObject, getPointToClick, getScreenCenter, getScreenPoint, getScreenPoint, getScreenRectangle, getTargetChildHandles, getTargetChildItem, getTargetChildItem, getTargetChildItems, getTestObjectClassName, getVisualClippableParent, hasFocus, hover, hover, hover, hover, hoverAtScreenPoint, isInView, isInView, isOpaque, isPointInObject, isPointInObject, isShowing, mouseMove, mouseMove, nClick, nClick, nClickAtScreenPoint, nClickDrag, nClickDragAtScreenPoint, nClickDragToScreenPoint, performAction, performClick, performClick, performDoubleClick, performSelect, performSetText, processHoverMouseEvent, processMouseEvent, processPreDownMouseEvent, processPreUpMouseEvent, proxyGetChildAtPoint, restoreTopLevelWindow, scrollIntoView, scrollIntoView, scrollIntoView, scrollIntoViewN, scrollIntoViewWithDirection, scrollIntoViewWithDirectionN, setClickArgs, setCurrentMethod, setDownPointArgs, setDrag, setMethodSpecification, setMethodSpecification, setMultiClickAction, snapToRectangle

Methods inherited from class com.rational.test.ft.domain.html.HtmlProxy

addAdditionalRecognitionProperties, addChildrenHandlesToVector, addChildrenToVector, addChildrenToVector, addDataDrivableCommands, addDojoDomain, addRecognitionProperty, adjustCustomDomains, callJqueryFind, clearAllSubdomains, clearCustomSubdomains, detach, disableAllHtmlCustomDomains, disableHtmlCustomDomain, disableHtmlCustomDomains, enableAllHtmlCustomDomains, enableHtmlCustomDomain, enableHtmlCustomDomains, equals, fetchProperties, find, findElementsByXpath, findElementsDirectly, findElementsViaQuery, findElementWithDynamicFind, findElementWithName, getAddedRecognitionProperty, getAddedRecognitionPropertyValue, getAddedRecognitionPropertyWeight, getBrowserAppVersion, getCachedData, getChannel, getChildren, getChildren, getChildren, getChildrenEnumeration, getChildrenEnumeration, getChildrenHandleEnumeration, getChildrenHandles, getChildrenN, getChildrenWithTagType, getClassIndex, getCustomClassProperty, getCustomClassPropertyValue, getCustomDomainName, getCustomDomainName, getCustomDomainName, getCustomDomainNameForChildren, getCustomDomainNameForParent, getCustomObject, getDataDrivableCommand, getDescriptiveName, getDisabledProperty, getDocClassIndex, getDocument, getDocument, getDocumentHandle, getDocumentWindow, getDomain, getElementHandlesByTag, getElementObjectsByTag, getElementsByNameInProxyTestObjects, getElementsByTag, getElementsByTag, getElementsByTagEnumeration, getElementsByTagInProxyTestObjects, getElementsByTagN, getElementsByXpath, getElementsByXpath, getElementsByXpathEnumeration, getElementsDirectly, getHandle, getHtmlTag, getHtmlTagNameFromClassProperty, getIgnorableProperties, getIndexer, getIndexers, getInterestingRecogPropsForDynFind, getJsProps, getJswarapper, getMappableChildren, getMappableChildren, getMappableElementsByNameInProxyTestObjects, getMappableElementsByTagInProxyTestObjects, getMappableParent, getMappableParent, getMethods, getNonValueProperties, getObject, getObjectClassName, getOwnedObjects, getOwnedObjects, getOwner, getParent, getParent, getParentN, getProperties, getProperties, getProperty, getPropertyInternal, getPropertyInternalRunnable, getPropertyN, getProxyTestObjectsFromEnumeration, getReadOnlyProperty, getRecognitionProperties, getRecognitionPropertyWeight, getRole, getSavedDescriptiveName, getScriptCommandFlags, getStandardProperties, getStandardProperties, getTestData, getTestDataTypes, getTestDomain, getText, getTopMappableParent, getTopParent, getTopParent, getTopParentInternal, getTopParentN, getUniqueId, getValueProperty, getVisualTopParent, hasAddedRecognitionProperties, isClassIndexConsidered, isClassIndexPropertyAndValueDefined, isClassIndexSet, isContextObjectSet, isContextObjectSet, isDocClassIndexSet, isEqual, isFindOptimized, isObjectDead, isPropertyOptimizable, isReleaseRequired, isSameObject, isScoreForFindBYIdorName, isValidRecognitionProperty, isXpathSupported, matches, release, release, release, release, release, release, releaseElementHandle, releaseN, replaceAll, restoreAllCustomSubDomains, restoreCustomSubDomains, setCachedData, setClass, setClassIndex, setClassIndex, setClassIndex, setClassIndex, setClassIndex, setClassIndexOfChild, setCustomClassProperty, setCustomClassPropertyValue, setCustomDomainInContext, setDocClassIndex, setDocClassIndex, setDocClassIndex, setDocClassIndex, setDomain, setIndexer, setJswarapper, setProperty, setProperty, setSavedDescriptiveName, shouldDocumentBeAdded, split, updateTestData

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

baseClassMatch, canTakeVP, findChildrenWithProperties, findChildrenWithPropertiesAndInvoke, getDataDrivableCommands, getElementWithFocus, getField, getProxy, getScriptCommandAnchor, getVisualClippedRectangle, getVisualMappableChildren, getVOMSpecificProperty, hasSpecialFrameState, isValidObject, ping, suppressKeyAction

Methods inherited from class java.lang.Object

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

Field Detail

subDomain

public java.lang.String subDomain

DISPLAYPROPERTY

public static final java.lang.String DISPLAYPROPERTY

See Also:

Constant Field Values

defaultRecognitionProperty

public java.lang.String[] defaultRecognitionProperty

Constructor Detail

GenericHtmlGuiProxy

public GenericHtmlGuiProxy(HtmlTestDomainImplementation domain,
                   IChannel channel,
                   long handle,
                   IBrowserCommunicator jswrap)

GenericHtmlGuiProxy

public GenericHtmlGuiProxy(HtmlTestDomainImplementation domain,
                   IChannel channel,
                   long handle)

Method Detail

getAncestorHandleMatchingProperty

public static long getAncestorHandleMatchingProperty(HtmlProxy proxy,
                                     java.lang.String regexClassMatch,
                                     java.lang.String propertyName,
                                     int maxLevels)

getAncestorHandleMatchingByPropertyNames

public static long getAncestorHandleMatchingByPropertyNames(HtmlProxy proxy,
                                            java.lang.String regexClassMatch,
                                            java.util.ArrayList propertyNames,
                                            int maxLevels)

getAncestorHandleMatchingProperty

public static long getAncestorHandleMatchingProperty(HtmlProxy proxy,
                                     java.lang.String regexClassMatch,
                                     java.lang.String propertyName,
                                     int maxLevels,
                                     long startingHandle)

getAncestorHandleMatchingProperty

public static long getAncestorHandleMatchingProperty(HtmlProxy proxy,
                                     java.lang.String[] regexArray,
                                     java.lang.String propertyName,
                                     int maxLevels)

getAncestorHandleMatchingProperty

public static long getAncestorHandleMatchingProperty(HtmlProxy proxy,
                                     java.lang.String regexClassMatch,
                                     java.lang.String regexClassNotMatch,
                                     java.lang.String propertyName,
                                     int maxLevels)

getAncestorAtLevel

public static long getAncestorAtLevel(HtmlProxy proxy,
                      long origHandle,
                      int numOfLevels)

getObjectCustomClassName

public java.lang.String getObjectCustomClassName()

Description copied from class: ProxyTestObject

Returns the custom class name of the associated object. The default implementation returns the java class name of the associated object.

Overrides:

getObjectCustomClassName in class ProxyTestObject

Returns:

CustomClass name.

getVisibleTextProperty

public java.lang.String getVisibleTextProperty()

Returns an enumeration of properties used to uniquely identify the associated test object in the SUT. Really good recognition properties are properties like the programmatic name or a persistent description. Less interesting might be the visible text on a button or label, or the tooltip text, or possibly the foreground color.

Returns:

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

shouldBeMapped

public boolean shouldBeMapped()

Always returns true, because all HTML LORENZO GUI objects are interesting.

Overrides:

shouldBeMapped in class HtmlProxy

Returns:

false

Since:

RFT1.0

isEnabled

public boolean isEnabled()

Overrides:

isEnabled in class HtmlGuiProxy

setMethodSpecification

protected void setMethodSpecification(ProxyTestObject proxy,
                          IMouseActionInfo action,
                          java.lang.String method,
                          java.util.Vector args)

setMethodSpecification

protected void setMethodSpecification(ProxyTestObject proxy,
                          IMouseActionInfo action,
                          java.lang.String method,
                          java.util.Vector args,
                          ScriptCommandFlags flags)

setClickArgs

protected java.util.Vector setClickArgs(int modifiers,
                            java.util.Vector clickArgs)

Set args for click (depends on clickArgs member variable set by getActionArgs in PRE_DOWN)

setDownPointArgs

protected java.util.Vector setDownPointArgs(int modifiers,
                                java.util.Vector clickArgs)

getProperty

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

Description copied from class: HtmlProxy

Get the value for a specific property.

Overrides:

getProperty in class HtmlProxy

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)

isVisible

public boolean isVisible()

getHtmlChildren

public ProxyTestObject[] getHtmlChildren()

getHtmlParent

public ProxyTestObject getHtmlParent()

setSubDomain

public boolean setSubDomain(java.lang.String subDomain)

getSubDomain

public java.lang.String getSubDomain()

calculateParentsTextDescendantsMayBecomeInteresting

protected java.lang.Boolean calculateParentsTextDescendantsMayBecomeInteresting()

Overrides:

calculateParentsTextDescendantsMayBecomeInteresting in class HtmlProxy