com.rational.test.ft.domain.html

Class ActiveXProxy

java.lang.Object

com.rational.test.ft.sys.RegisteredObject

com.rational.test.ft.domain.ProxyTestObject

com.rational.test.ft.domain.html.ActiveXProxy

All Implemented Interfaces:

com.rational.test.ft.domain.IChannelObject, com.rational.test.ft.domain.IDataDriven, com.rational.test.ft.domain.IProxyBase

public class ActiveXProxy
extends com.rational.test.ft.domain.ProxyTestObject

This is the proxy for COM objects embedded in HTML. It is a non-GUI proxy.

• TestObject Interface: TestObject
  

Since:

RFT1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	ActiveXProxy.InvalidNativeHandleException
class	ActiveXProxy.NativeProxyReleasedException
class	ActiveXProxy.ReleaseElementHandleRunnable

Field Summary

Fields

Modifier and Type	Field and Description
protected com.rational.test.ft.domain.IChannel	channel
protected static com.rational.test.ft.util.FtDebug	debug
protected com.rational.test.ft.domain.ProxyTestObject	tempParent
protected static java.lang.String	TESTDATA_TEXT

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.IDataDriven

INCLUDE_ALL, INCLUDE_JUSTOBJECT, INCLUDE_SIBLINGS

Constructor Summary

Constructors

Constructor and Description
ActiveXProxy(long handle)

Method Summary

Modifier and Type	Method and Description
void	addRecognitionProperty(java.lang.String property, java.lang.Object value, int weight) Not implemented
long	detach() Detach the native proxy and return its handle.
boolean	equals(java.lang.Object obj) Overrides the object-level equals with an equality against the handles of the underlying test objects.
HtmlProxy	findElementWithName(java.lang.String name) Element does not have children.
protected java.lang.Object	getAddedRecognitionPropertyValue(java.lang.String propertyName)
com.rational.test.ft.domain.IChannel	getChannel() Return the channel associated with this object.
com.rational.test.ft.domain.ProxyTestObject[]	getChildren() Objects have no children
java.util.Enumeration	getChildrenEnumeration() Objects have no children
java.lang.String	getDescriptiveName()
protected long	getHandle()
java.lang.Object	getIndexer(java.lang.String name, java.lang.Object[] indexes) Gets the value of an indexed property
com.rational.test.ft.value.IndexerInfo[]	getIndexers() Gets information about a TestObject's indexed properties
com.rational.test.ft.domain.ProxyTestObject[]	getMappableChildren() Objects have no children
com.rational.test.ft.domain.ProxyTestObject	getMappableParent() Returns null always because object relationships are not applicable.
protected com.rational.test.ft.domain.ProxyTestObject	getMappableParentInternal() Returns null always because object relationships are not applicable.
com.rational.test.ft.value.MethodInfo[]	getMethods() Returns an array of MethodInfos
com.rational.test.ft.sys.MethodSpecification	getMethodSpecForPoint(java.awt.Point pt)
java.util.Hashtable	getNonValueProperties() return the properties that are not supported because of the return value
java.lang.Object	getObject()
java.lang.String	getObjectClassName()
com.rational.test.ft.domain.ProxyTestObject[]	getOwnedObjects() Returns null always
com.rational.test.ft.domain.ProxyTestObject	getOwner() Returns null always
com.rational.test.ft.domain.ProxyTestObject	getParent() Returns null always because object relationships are not applicable.
java.util.Hashtable	getProperties()
java.lang.Object	getProperty(java.lang.String propertyName) Get the value for a specific property.
java.lang.Object	getPropertyInternal(java.lang.String propertyName) Get the value for a specific property.
java.util.Hashtable	getRecognitionProperties() Not a GUI object so does not have any recogntion properties
int	getRecognitionPropertyWeight(java.lang.String propertyName)
int	getRefCount()
int	getRefCount(long handle)
java.lang.String	getRole() Returns TestObjectRole.ROLE_OBJECT.
com.rational.test.ft.script.ScriptCommandFlags	getScriptCommandFlags()
java.util.Hashtable	getStandardProperties()
com.rational.test.ft.vp.ITestData	getTestData(java.lang.String testDataType) This method constructs the specified verification data object.
java.util.Hashtable	getTestDataTypes() Returns a hashtable of data type descriptions of the verification point data available with the associated object in the SUT.
com.rational.test.ft.domain.TestDomainImplementation	getTestDomain() Return the TestDomainImplementation that this proxy object is associated with.
java.lang.String	getTestObjectClassName()
java.lang.String	getText() Element does not have associated text.
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 null always because object relationships are not applicable.
java.lang.String	getUniqueId() Return a unique string for the associated object.
boolean	hasAddedRecognitionProperties()
void	initialize(HtmlTestDomainImplementation domain, com.rational.test.ft.domain.IChannel channel)
boolean	isReleaseRequired()
boolean	isSameObject(java.lang.Object obj)
long	marshalInterface()
long	marshalInterface(long handle)
void	processMouseEvent(com.rational.test.ft.domain.IMouseActionInfo action)
void	release()
protected void	release(long nativeHandle)
void	releaseElementHandle(long handle)
void	releaseMeow(long meowHandle)
void	releaseMeow(long handle, long meowHandle)
void	setIndexer(java.lang.String name, java.lang.Object[] indexes, java.lang.Object val) Sets the value of an indexed property
void	setProperty(java.lang.String propertyName, java.lang.Object value) Set the value for a specific property.
boolean	shouldBeMapped() Returns false, by default only GUI test objects are mapped.
com.rational.test.ft.vp.ITestData	updateTestData(java.lang.String testDataType, com.rational.test.ft.vp.ITestData testData) This method updates the supplied test data object and returns it.

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

addDataDrivableCommands, baseClassMatch, canTakeVP, findChildrenWithProperties, findChildrenWithPropertiesAndInvoke, getChildren, getDataDrivableCommand, getDataDrivableCommands, getElementWithFocus, getField, getIgnorableProperties, getMappableChildren, getMappableParent, getObjectCustomClassName, getOwnedObjects, getParent, getProxy, getScriptCommandAnchor, getVisualClippableParent, getVisualClippedRectangle, getVisualMappableChildren, getVisualTopParent, getVOMSpecificProperty, hasSpecialFrameState, isClassIndexConsidered, 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

Field Detail

debug

protected static com.rational.test.ft.util.FtDebug debug

channel

protected com.rational.test.ft.domain.IChannel channel

tempParent

protected com.rational.test.ft.domain.ProxyTestObject tempParent

TESTDATA_TEXT

protected static final java.lang.String TESTDATA_TEXT

See Also:

Constant Field Values

Constructor Detail

ActiveXProxy

public ActiveXProxy(long handle)

Method Detail

initialize

public void initialize(HtmlTestDomainImplementation domain,
                       com.rational.test.ft.domain.IChannel channel)

getChannel

public com.rational.test.ft.domain.IChannel getChannel()

Return the channel associated with this object.

Specified by:

getChannel in interface com.rational.test.ft.domain.IChannelObject

Overrides:

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

getHandle

protected long getHandle()

equals

public boolean equals(java.lang.Object obj)

Overrides the object-level equals with an equality against the handles of the underlying test objects.

Overrides:

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

Parameters:

obj - The object to compare against. If obj is a ProxyTestObject, the comparison is made with the underlying object.

Returns:

true if the underlying test objects are equal.

Since:

RFT1.0

isSameObject

public boolean isSameObject(java.lang.Object obj)

Overrides:

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

getTestObjectClassName

public java.lang.String getTestObjectClassName()

Specified by:

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

Specified by:

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

getTestDomain

public final com.rational.test.ft.domain.TestDomainImplementation getTestDomain()

Return the TestDomainImplementation that this proxy object is associated with. This method should not be overriden.

Specified by:

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

Specified by:

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

Returns:

The associated TestDomainImplementation.

getDescriptiveName

public java.lang.String getDescriptiveName()

Specified by:

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

getRole

public java.lang.String getRole()

Returns TestObjectRole.ROLE_OBJECT.

Overrides:

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

Returns:

A brief type name that describes the role this object plays in the UI.

Since:

RFT1.0

processMouseEvent

public void processMouseEvent(com.rational.test.ft.domain.IMouseActionInfo action)

Specified by:

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

getUniqueId

public java.lang.String getUniqueId()

Return a unique string for the associated object. This string needs to be identical for each call to this method for the same instance of the UI object. This value must also be as unique as possible.

Specified by:

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

Returns:

Return a unique and repeatable identifier for the object being evaluated.

shouldBeMapped

public boolean shouldBeMapped()

Returns false, by default only GUI test objects are mapped.

Specified by:

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

Returns:

false not a mappable object type

getObject

public java.lang.Object getObject()

Overrides:

getObject in class com.rational.test.ft.sys.RegisteredObject

getObjectClassName

public java.lang.String getObjectClassName()

Overrides:

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

getParent

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

Returns null always because object relationships are not applicable.

Specified by:

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

Returns:

null, no known parent.

getMappableParent

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

Returns null always because object relationships are not applicable.

Specified by:

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

Returns:

null, no known parent.

getMappableParentInternal

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

Returns null always because object relationships are not applicable.

getTopParent

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

Returns null always because object relationships are not applicable.

Specified by:

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

getTopMappableParent

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

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

Specified by:

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

Returns:

null, no known parent.

getChildrenEnumeration

public java.util.Enumeration getChildrenEnumeration()

Objects have no children

Returns:

null

getChildren

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

Objects have no children

Specified by:

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

Returns:

null

getMappableChildren

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

Objects have no children

Specified by:

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

Returns:

null

getOwner

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

Returns null always

Specified by:

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

Returns:

null, no known parent.

getOwnedObjects

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

Returns null always

Specified by:

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

Returns:

null, no known parent.

getMethodSpecForPoint

public com.rational.test.ft.sys.MethodSpecification getMethodSpecForPoint(java.awt.Point pt)

Specified by:

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

getRecognitionProperties

public java.util.Hashtable getRecognitionProperties()

Not a GUI object so does not have any recogntion properties

Specified by:

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

getRecognitionPropertyWeight

public int getRecognitionPropertyWeight(java.lang.String propertyName)

Specified by:

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

addRecognitionProperty

public void addRecognitionProperty(java.lang.String property,
                                   java.lang.Object value,
                                   int weight)

Not implemented

Specified by:

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

hasAddedRecognitionProperties

public boolean hasAddedRecognitionProperties()

Specified by:

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

getAddedRecognitionPropertyValue

protected java.lang.Object getAddedRecognitionPropertyValue(java.lang.String propertyName)

getProperties

public java.util.Hashtable getProperties()

Specified by:

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

getStandardProperties

public java.util.Hashtable getStandardProperties()

Specified by:

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

getNonValueProperties

public java.util.Hashtable getNonValueProperties()

return the properties that are not supported because of the return value

Specified by:

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

getIndexer

public java.lang.Object getIndexer(java.lang.String name,
                                   java.lang.Object[] indexes)

Gets the value of an indexed property

Specified by:

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

getIndexers

public com.rational.test.ft.value.IndexerInfo[] getIndexers()

Gets information about a TestObject's indexed properties

Specified by:

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

setIndexer

public void setIndexer(java.lang.String name,
                       java.lang.Object[] indexes,
                       java.lang.Object val)

Sets the value of an indexed property

Specified by:

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

getMethods

public com.rational.test.ft.value.MethodInfo[] getMethods()

Returns an array of MethodInfos

Specified by:

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

getProperty

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

Get the value for a specific property.

Specified by:

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

getPropertyInternal

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

Get the value for a specific property. Internal, no exceptions thrown.

setProperty

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

Set the value for a specific property.

Specified by:

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

getScriptCommandFlags

public com.rational.test.ft.script.ScriptCommandFlags getScriptCommandFlags()

Overrides:

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

detach

public long detach()

Detach the native proxy and return its handle. This is used to pass ownership of the handle to another proxy instance.

isReleaseRequired

public boolean isReleaseRequired()

Overrides:

isReleaseRequired in class com.rational.test.ft.sys.RegisteredObject

release

public void release()

Overrides:

release in class com.rational.test.ft.sys.RegisteredObject

releaseElementHandle

public void releaseElementHandle(long handle)

release

protected void release(long nativeHandle)

getText

public java.lang.String getText()

Element does not have associated text.

findElementWithName

public HtmlProxy findElementWithName(java.lang.String name)

Element does not have children.

getTestDataTypes

public java.util.Hashtable getTestDataTypes()

Returns a hashtable of data type descriptions of the verification point data available with the associated object in the SUT. 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 defferent then 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 com.rational.test.ft.domain.ProxyTestObject

Returns:

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

See Also:

getTestData(String), ITestData

getTestData

public com.rational.test.ft.vp.ITestData getTestData(java.lang.String testDataType)

This method constructs the specified verification data object. The testDataType parameter is one of the hashtable keys returned by getTestDataTypes.

Overrides:

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

Parameters:

testDataType - A test data type supplied by getTestDataTypes.

Returns:

The verification data for the supplied type.

See Also:

getTestDataTypes(), ITestData

updateTestData

public com.rational.test.ft.vp.ITestData updateTestData(java.lang.String testDataType,
                                                        com.rational.test.ft.vp.ITestData testData)

This method updates the supplied test data object and returns it. The testDataType parameter is one of the hashtable keys returned by getTestDataTypes. The testData is a previously supplied ITestData object that needs to be updated to reflect the current state of the associated test object.

Overrides:

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

Parameters:

testDataType - A test data type supplied by getTestDataTypes.

testData - The test data base object that requires updating.

Returns:

The testData passed in with appropriate updates.

See Also:

getTestDataTypes(), ITestData

marshalInterface

public long marshalInterface()

releaseMeow

public void releaseMeow(long meowHandle)

getRefCount

public int getRefCount()

marshalInterface

public long marshalInterface(long handle)

releaseMeow

public void releaseMeow(long handle,
                        long meowHandle)

getRefCount

public int getRefCount(long handle)