com.ibm.rational.test.lt.kernel.services
Class OutOfScopeException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjava.lang.RuntimeException
              extended bycom.ibm.rational.test.lt.kernel.services.OutOfScopeException
All Implemented Interfaces:
java.io.Serializable

public class OutOfScopeException
extends java.lang.RuntimeException

OutOfScopeException indicates that an object created by ITestExecutionServices has been referenced outside of its intended scope.

Some of the objects returned by ITestExecutionServices methods retain a WeakReference to other kernel objects to provide the correct functionality. While unlikely, it is possible to save such an object so that it would be accessible after the referenced kernel objects have been disposed. Any time one of these weak references produces a null value, the Test Execution Services method throws an OutOfScopeException instead of a NullPointerException.

The custom code user should not need to catch this exception, as this situation should not occur in normal usage. However, if this does occur,the kernel will catch the exception and put a message event in the TestLog where it occurred and will log a message to the PDLog containing a stack trace.

See Also:
Serialized Form

Constructor Summary
OutOfScopeException()
           
OutOfScopeException(java.lang.String message)
           
OutOfScopeException(java.lang.String message, java.lang.Throwable cause)
           
OutOfScopeException(java.lang.Throwable cause)
           
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

OutOfScopeException

public OutOfScopeException()

OutOfScopeException

public OutOfScopeException(java.lang.String message)
Parameters:
message -

OutOfScopeException

public OutOfScopeException(java.lang.String message,
                           java.lang.Throwable cause)
Parameters:
message -
cause -

OutOfScopeException

public OutOfScopeException(java.lang.Throwable cause)
Parameters:
cause -


Copyright (c) IBM Corp. and others 2005. All rights reserved