com.rational.test.ft.domain.html

Class EmbeddedBrowserProxy

java.lang.Object

com.rational.test.ft.sys.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.EmbeddedBrowserProxy

All Implemented Interfaces:

com.rational.test.ft.domain.IChannelObject, com.rational.test.ft.domain.IDataDriven, com.rational.test.ft.domain.IGetInterestingRecogProsForDynFind, com.rational.test.ft.domain.IHtmlCustomDomainEnablement, com.rational.test.ft.domain.IInternalObjectStatus, com.rational.test.ft.domain.IProxyBase, com.rational.test.ft.domain.IQuickFind, com.rational.test.ft.domain.IXPathFind, com.rational.test.ft.object.interfaces.IBrowserObject, com.rational.test.ft.object.interfaces.IGraphical

public class EmbeddedBrowserProxy
extends HtmlGuiProxy
implements com.rational.test.ft.object.interfaces.IBrowserObject

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 inherited from class com.rational.test.ft.domain.html.HtmlGuiProxy

COLON, COMMA, currentMethod, ESC_DBLQUOTE, GETSCREENSNAPSHOT, IS_WEB_PLAYER, JSON_CLOSE_BRACE, JSON_OPEN_BRACE, LEFT, MAXIMIZE, OFFSETHEIGHTPROPERTY, OFFSETLEFTPROPERTY, OFFSETRECTPROPERTY, OFFSETTOPPROPERTY, OFFSETWIDTHPROPERTY, ONCHANGE, ONMOUSEOVER, RESTORE, TEXT

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

BODYTAG, BOUNDSPROPERTY, channel, CLASSINDEX, CLASSPROPERTY, CLIENTRECTPROPERTY, debug, DISABLEDPROPERTY, DOCCLASSINDEX, dojoProps, domain, HTMLPROXYCHANNELRUNNABLE_TIMEOUTVALUE, IDPROPERTY, isSiebelActive, jswarapper, NAMEPROPERTY, OUTERTEXT, 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 class com.rational.test.ft.sys.RegisteredObject

theTestObject

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
EmbeddedBrowserProxy(HtmlTestDomainImplementation domain, com.rational.test.ft.domain.IChannel channel, long handle)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	back()
void	deleteCookies()
void	deleteCookies(java.lang.String cookie, boolean recursive)
boolean	forward()
java.lang.Object	getChildAtPoint(java.awt.Point pt) Finds the most interesting child object at the specified point.
com.rational.test.ft.object.interfaces.IGraphical	getClippingParent() Get the clipping parent for this object.
java.lang.String	getDescriptiveName() Returns a name that can be used to describe the associated UI object in a script.
HtmlDocumentProxy	getDocument() Return a Proxy to the Html Document that contains this element.
com.rational.test.ft.domain.ProxyTestObject	getElementWithFocus()
com.rational.test.ft.domain.ProxyTestObject	getMappableParent() Walks the HtmlProxy.getParent() relationship until a mappable parent is encountered.
com.rational.test.ft.domain.ProxyTestObject[]	getOwnedObjects()
com.rational.test.ft.domain.ProxyTestObject	getOwner() Returns null always because object relationships are not understood at this level of abstaction.
com.rational.test.ft.domain.ProxyTestObject	getParent() Returns null always because object relationships are not understood at this level of abstaction.
java.lang.String	getTestObjectClassName() The default GUI marshaller is returned.
com.rational.test.ft.domain.ProxyTestObject	getTopMappableParent() Returns getTopParent() which is the browser and is always mappable.
com.rational.test.ft.domain.ProxyTestObject	getTopParent() Returns a proxy object for the top parent of this object.
protected com.rational.test.ft.domain.ProxyTestObject	getTopParentInternal() Returns a proxy object for the top most parent of this object, or null if this object has no parent.
java.lang.String	getUniqueId()
boolean	home()
boolean	isShowing()
boolean	loadUrl(java.lang.String url)
boolean	loadUrl(java.lang.String url, java.lang.String target)
void	release()
boolean	shouldBeMapped() Returns false, by default only GUI test objects are mapped.

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

activateTopWindow, click, click, click, click, clickAtScreenPoint, clickWithMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouseN, convertFromScreenToOffset, doScroll, doubleClick, doubleClick, doubleClick, doubleClick, doubleClickAtScreenPoint, drag, drag, drag, drag, dragAtScreenPoint, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, ensureObjectIsVisible, getActionArgs, getChildAtPoint, getChildAtPointN, getChildrenHandlesMatchingProperty, getClippedScreenRectangle, getClippingParentRectangle, getCurrentMethod, getDefaultActionArgs, getDefaultPointToClick, getDefaultPointToClick, getMappableDocument, getMethodName, getMethodSpecForPoint, getPointFromAction, getPointOnObject, getPointToClick, getScreenCenter, getScreenPoint, getScreenPoint, getScreenRectangle, getScreenSnapshot, getTargetChildHandles, getTargetChildItem, getTargetChildItem, getTargetChildItems, getVisualClippableParent, hasFocus, hover, hover, hover, hover, hoverAtScreenPoint, isEnabled, isInView, isInView, isOpaque, isPointInObject, isPointInObject, mouseMove, mouseMove, nClick, nClick, nClickAtScreenPoint, nClickDrag, nClickDragAtScreenPoint, nClickDragToScreenPoint, performAction, performClick, performClick, performDoubleClick, performSelect, performSetText, performWindowAction, 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, calculateParentsTextDescendantsMayBecomeInteresting, callJqueryFind, clearAllSubdomains, clearCustomSubdomains, detach, disableAllHtmlCustomDomains, disableHtmlCustomDomain, disableHtmlCustomDomains, enableAllHtmlCustomDomains, enableHtmlCustomDomain, enableHtmlCustomDomains, equals, exists, fetchProperties, filterProxiesBasedOnProps, find, findElementsByXpath, findElementsDirectly, findElementsViaQuery, findElementWithDynamicFind, findElementWithName, getAddedRecognitionProperty, getAddedRecognitionPropertyValue, getAddedRecognitionPropertyWeight, getBrowserAppVersion, getBrowserProcessId, getCachedData, getChannel, getChildren, getChildren, getChildren, getChildrenEnumeration, getChildrenEnumeration, getChildrenHandleEnumeration, getChildrenHandles, getChildrenN, getChildrenWithTagType, getClassIndex, getCustomClassProperty, getCustomClassPropertyValue, getCustomDomainName, getCustomDomainName, getCustomDomainName, getCustomDomainNameForChildren, getCustomDomainNameForParent, getCustomObject, getDataDrivableCommand, getDisabledProperty, getDocClassIndex, getDocument, getDocumentHandle, getDocumentWindow, 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, getMethods, getNonValueProperties, getObject, getObjectClassName, getOwnedObjects, getParent, getParent, getParentN, getProperties, getProperties, getProperty, getProperty, getPropertyInternal, getPropertyInternalRunnable, getPropertyN, getProxyTestObjectsFromEnumeration, getReadOnlyProperty, getRecognitionProperties, getRecognitionPropertyWeight, getRole, getSavedDescriptiveName, getScriptCommandFlags, getStandardProperties, getStandardProperties, getTestData, getTestDataTypes, getTestDomain, getText, getTopParent, getTopParentN, getValueProperty, getVisualTopParent, hasAddedRecognitionProperties, isClassIndexConsidered, isClassIndexPropertyAndValueDefined, isClassIndexSet, isContextObjectSet, isContextObjectSet, isDocClassIndexSet, isEqual, isFindOptimized, isObjectDead, isPropertyOptimizable, isReleaseRequired, isSameObject, isScoreForFindBYIdorName, isValidRecognitionProperty, isXpathSupported, matches, 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, getField, getObjectCustomClassName, getProxy, getScriptCommandAnchor, getVisualClippedRectangle, getVisualMappableChildren, getVOMSpecificProperty, hasSpecialFrameState, isValidObject, ping, suppressKeyAction

Methods inherited from class com.rational.test.ft.sys.RegisteredObject

addProxyReference, dereference, getRegisteredId, getTransactionId, isReferenced, register, registerTransiently, toString, unregister

Methods inherited from class java.lang.Object

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

Constructor Detail

EmbeddedBrowserProxy

public EmbeddedBrowserProxy(HtmlTestDomainImplementation domain,
                    com.rational.test.ft.domain.IChannel channel,
                    long handle)

Method Detail

getElementWithFocus

public com.rational.test.ft.domain.ProxyTestObject getElementWithFocus()

Overrides:

getElementWithFocus in class com.rational.test.ft.domain.ProxyTestObject

release

public void release()

Overrides:

release in class HtmlProxy

getTestObjectClassName

public java.lang.String getTestObjectClassName()

Description copied from class: HtmlProxy

The default GUI marshaller is returned. More specific marshallers are returned by more constrained proxy classes. This level of support is always required.

Specified by:

getTestObjectClassName in interface com.rational.test.ft.domain.IProxyBase

Overrides:

getTestObjectClassName in class HtmlGuiProxy

Returns:

The default mashaller class full name.

getDescriptiveName

public java.lang.String getDescriptiveName()

Description copied from class: HtmlProxy

Returns a name that can be used to describe the associated UI object in a script. This name may be further adjusted to be made unique to the script, but will act as the base for the name used in the script. Only characters used in Html identifiers should be returned (alphabetic, numeric or underscore characters). Non-identifier characters will cause script compilation failures. An example of what to return may be "OKButton" for a Html.BUTTON with the text "OK" on it.

Overrides:

getDescriptiveName in class HtmlProxy

Returns:

A descriptive object name.

getUniqueId

public java.lang.String getUniqueId()

Overrides:

getUniqueId in class HtmlProxy

shouldBeMapped

public boolean shouldBeMapped()

Description copied from class: HtmlProxy

Returns false, by default only GUI test objects are mapped. If the generic Html element has an id or name (which probably indicates that it is used in a script) then return true, otherwise ignore it.

Overrides:

shouldBeMapped in class HtmlProxy

Returns:

true element has an id or name. false not a supported HTML object type

getClippingParent

public com.rational.test.ft.object.interfaces.IGraphical getClippingParent()

Description copied from class: HtmlGuiProxy

Get the clipping parent for this object. The clipping parent is the object whose rectangle will clip all of its children, usually the browser or a frame. Unfortunately, it can also be a div tag in the object hierarchy, so going directly to the document does not worl

Overrides:

getClippingParent in class HtmlGuiProxy

getDocument

public HtmlDocumentProxy getDocument()

Description copied from class: HtmlProxy

Return a Proxy to the Html Document that contains this element.

Overrides:

getDocument in class HtmlProxy

getChildAtPoint

public java.lang.Object getChildAtPoint(java.awt.Point pt)

Description copied from class: HtmlGuiProxy

Finds the most interesting child object at the specified point. Note that the point is relative to the top left corner of the screen, and not the component itself or its parent.

If this object has no children, it should return null.

Specified by:

getChildAtPoint in interface com.rational.test.ft.object.interfaces.IGraphical

Overrides:

getChildAtPoint in class HtmlGuiProxy

Parameters:

pt - Screen relative point to check.

Returns:

The object at the point or null if no child object is found.

See Also:

HtmlGuiProxy.getScreenRectangle()

getParent

public com.rational.test.ft.domain.ProxyTestObject getParent()

Description copied from class: HtmlProxy

Returns null always because object relationships are not understood at this level of abstaction.

Overrides:

getParent in class HtmlProxy

Returns:

null, no known parent.

getMappableParent

public com.rational.test.ft.domain.ProxyTestObject getMappableParent()

Description copied from class: HtmlProxy

Walks the HtmlProxy.getParent() relationship until a mappable parent is encountered.

Overrides:

getMappableParent in class HtmlProxy

Returns:

The first mappable parent located.

getTopParent

public com.rational.test.ft.domain.ProxyTestObject getTopParent()

Description copied from class: HtmlProxy

Returns a proxy object for the top parent of this object. Returns itself if this object has no parent.

Overrides:

getTopParent in class HtmlProxy

Returns:

The proxy for the top parent test object or itself for a top level object.

getTopParentInternal

protected com.rational.test.ft.domain.ProxyTestObject getTopParentInternal()

Description copied from class: HtmlProxy

Returns a proxy object for the top most parent of this object, or null if this object has no parent.

Overrides:

getTopParentInternal in class HtmlProxy

Returns:

The proxy for the top most parent test object or null if this has no parent.

getTopMappableParent

public com.rational.test.ft.domain.ProxyTestObject getTopMappableParent()

Description copied from class: HtmlProxy

Returns getTopParent() which is the browser and is always mappable.

Overrides:

getTopMappableParent in class HtmlProxy

Returns:

The proxy for the top mappable parent test object or itself for a top level object.

getOwner

public com.rational.test.ft.domain.ProxyTestObject getOwner()

Description copied from class: HtmlProxy

Returns null always because object relationships are not understood at this level of abstaction.

Overrides:

getOwner in class HtmlProxy

Returns:

null, no known parent.

getOwnedObjects

public com.rational.test.ft.domain.ProxyTestObject[] getOwnedObjects()

Overrides:

getOwnedObjects in class HtmlProxy

isShowing

public boolean isShowing()

Specified by:

isShowing in interface com.rational.test.ft.object.interfaces.IGraphical

Overrides:

isShowing in class HtmlGuiProxy

back

public boolean back()

Specified by:

back in interface com.rational.test.ft.object.interfaces.IBrowserObject

forward

public boolean forward()

Specified by:

forward in interface com.rational.test.ft.object.interfaces.IBrowserObject

home

public boolean home()

Specified by:

home in interface com.rational.test.ft.object.interfaces.IBrowserObject

loadUrl

public boolean loadUrl(java.lang.String url,
              java.lang.String target)

Specified by:

loadUrl in interface com.rational.test.ft.object.interfaces.IBrowserObject

loadUrl

public boolean loadUrl(java.lang.String url)

Specified by:

loadUrl in interface com.rational.test.ft.object.interfaces.IBrowserObject

deleteCookies

public void deleteCookies()

Specified by:

deleteCookies in interface com.rational.test.ft.object.interfaces.IBrowserObject

deleteCookies

public void deleteCookies(java.lang.String cookie,
                 boolean recursive)

Specified by:

deleteCookies in interface com.rational.test.ft.object.interfaces.IBrowserObject