IBM Rational Functional Tester
Version 8.1.1000
IBM Rational Functional Tester API Reference

Project Version 2.3

com.rational.test.ft.object.interfaces
Class DomainTestObject

java.lang.Object   extended by com.rational.test.ft.object.interfaces.TestObject
      extended by com.rational.test.ft.object.interfaces.DomainTestObject

public class DomainTestObject
extends TestObject

Provides access to an object domain. An object domain provides information about a class of objects. A domain has a name and an implementation name. For example, all Java objects are in the Java domain, and the domain implementation can be named Java 1.2.2.

Since:
RFT1.0

Field Summary
 
Fields inherited from class com.rational.test.ft.object.interfaces.TestObject
ref
 
Constructor Summary
DomainTestObject(com.rational.test.ft.sys.RegisteredObjectReference ror)
          For internal use.
DomainTestObject(com.rational.test.ft.sys.RemoteProxyReference rpr)
          For internal use.
DomainTestObject(com.rational.test.ft.sys.TestContext.Reference tcRef, java.lang.String domainName)
          For internal use.
DomainTestObject(com.rational.test.ft.object.TestObjectReference ref)
          For internal use.
 
Method Summary
 java.lang.Object getImplementationName()
          Returns the name of the domain implementation.
 java.lang.Object getName()
          Returns the name of the domain.
 com.rational.test.ft.sys.TestContext.Reference getTestContextReference()
          Returns the testContextReference.
 TestObject[] getTopObjects()
          Returns an array of references to the top objects in the domain.
 java.lang.Object invokeConstructor(java.lang.String className)
          Invokes a constructor for a class in the context of the domain.
 java.lang.Object invokeConstructor(java.lang.String className, java.lang.String signature, java.lang.Object[] args)
          Invokes a constructor for a class in the context of the domain.
 java.lang.Object invokeStaticMethod(java.lang.String className, java.lang.String method)
          Invokes a static method on a class in the context of the domain.
 java.lang.Object invokeStaticMethod(java.lang.String className, java.lang.String method, java.lang.String signature, java.lang.Object[] args)
          Invokes a static method on a class in the context of the domain.
 
Methods inherited from class com.rational.test.ft.object.interfaces.TestObject
compare, compare, compareAndLog, compareAndLog, equals, exists, find, find, find, findAndInvoke, findAndInvoke, findAndInvokeProxy, getActualData, getChildren, getDescribedObject, getDescribedObjects, getDescriptiveName, getDomain, getField, getIndexer, getIndexer, getIndexers, getMappableChildren, getMappableParent, getMapProperties, getMethods, getNameInScript, getNonValueProperties, getObjectClassName, getObjectCustomClassName, getObjectReference, getOwnedObjects, getOwner, getParent, getProcess, getProperties, getProperty, getPropertyFromMap, getRecognitionProperties, getRecognitionPropertyWeight, getScriptCommandFlags, getStandardProperties, getTestData, getTestDataTypes, getTopMappableParent, getTopParent, hashCode, invoke, invoke, invokeProxy, invokeProxy, isMappedObject, isSameObject, isScreenTestObject, isTopLevelTestObject, performTest, performTest, performTest, performTest, setIndexer, setIndexer, setMapProperties, setProperty, toString, unregister, updateTestData, waitForExistence, waitForExistence
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

DomainTestObject

public DomainTestObject(com.rational.test.ft.sys.RemoteProxyReference rpr)
For internal use.

Since:
RFT1.0

DomainTestObject

public DomainTestObject(com.rational.test.ft.sys.RegisteredObjectReference ror)
For internal use.

Since:
RFT1.0

DomainTestObject

public DomainTestObject(com.rational.test.ft.object.TestObjectReference ref)
For internal use.

Since:
RFT1.0

DomainTestObject

public DomainTestObject(com.rational.test.ft.sys.TestContext.Reference tcRef,                         java.lang.String domainName)
For internal use.

Since:
RFT1.0
Method Detail

getName

public java.lang.Object getName()
Returns the name of the domain.

Since:
RFT1.0

getImplementationName

public java.lang.Object getImplementationName()
Returns the name of the domain implementation.

Since:
RFT1.0

getTestContextReference

public com.rational.test.ft.sys.TestContext.Reference getTestContextReference()
Returns the testContextReference.

Since:
RFT1.0

getTopObjects

public TestObject[] getTopObjects()
Returns an array of references to the top objects in the domain. The objects returned can be derived from the TestObject and can support more methods. The references to the objects are released by calling one of the unregister methods. Returns a 0-length array if no top objects are available.

Since:
RFT1.0
See Also:
TestObject.unregister(), RationalTestScript.unregister(Object[]), RationalTestScript.unregisterAll(), RationalTestScript.getRegisteredTestObjects()

invokeStaticMethod

public java.lang.Object invokeStaticMethod(java.lang.String className,                                            java.lang.String method,                                            java.lang.String signature,                                            java.lang.Object[] args)
Invokes a static method on a class in the context of the domain. If the returned object is not a value class, invokeStaticMethod returns a reference to the object in the software under test. References to these objects must be released by calling one of the unregister methods.

Parameters:
className - the name of the class containing the static method
method - the name of the static method on a class in the context of the domain
signature - the signature of the static method being invoked
args - the parameters of the static method being invoked
Returns:
A value class, or a reference to the object in the software under test
Since:
RFT1.0
See Also:
TestObject.unregister(), RationalTestScript.unregister(Object[]), RationalTestScript.unregisterAll(), RationalTestScript.getRegisteredTestObjects()

invokeStaticMethod

public java.lang.Object invokeStaticMethod(java.lang.String className,                                            java.lang.String method)
Invokes a static method on a class in the context of the domain. If the returned object is not a value class, invokeStaticMethod returns a reference to the object in the software under test. References to these objects are released by calling one of the unregister methods.

Parameters:
className - the name of the class containing the static method
method - the name of the static method on a class in the context of the domain
Returns:
A value class, or a reference to the object in the software under test
Since:
RFT1.0
See Also:
TestObject.unregister(), RationalTestScript.unregister(Object[]), RationalTestScript.unregisterAll(), RationalTestScript.getRegisteredTestObjects()

invokeConstructor

public java.lang.Object invokeConstructor(java.lang.String className,                                           java.lang.String signature,                                           java.lang.Object[] args)
Invokes a constructor for a class in the context of the domain. If the returned object is not a value class, invokeConstructor returns a reference to the object in the software under test. Referenced objects must be released by calling one of the unregister methods. Note that using invokeConstructor to construct a value class object in the software under test is not efficient because you can create value class objects locally.

Parameters:
className - the name of the class containing the static method
signature - the signature of the static method being invoked
args - the parameters of the static method being invoked
Returns:
A value class, or a reference to the object in the software under test
Since:
RFT1.0
See Also:
TestObject.unregister(), RationalTestScript.unregister(Object[]), RationalTestScript.unregisterAll(), RationalTestScript.getRegisteredTestObjects()

invokeConstructor

public java.lang.Object invokeConstructor(java.lang.String className)
Invokes a constructor for a class in the context of the domain. If the returned object is not a value class, invokeConstructor returns a reference to the object in the software under test. Referenced objects must be released by calling one of the unregister methods. Note that using invokeConstructor to construct a value class object in the software under test is not efficient because value class objects can be created locally.

Parameters:
className - the name of the class in the context of the domain
Returns:
A value class, or a reference to the object in the software under test
Since:
RFT1.0
See Also:
TestObject.unregister(), RationalTestScript.unregister(Object[]), RationalTestScript.unregisterAll(), RationalTestScript.getRegisteredTestObjects()