oracle.forms.jdapi
Class JdapiIllegalStateException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--java.lang.RuntimeException
                    |
                    +--oracle.forms.jdapi.JdapiException
                          |
                          +--oracle.forms.jdapi.JdapiIllegalStateException
All Implemented Interfaces:
java.io.Serializable

public class JdapiIllegalStateException
extends JdapiException

This exception thrown when calling methods on invalid forms objects.

The Jdapi classes are only thin wrappers over the Forms objects. When you create a Block, you really create a Block in Forms memory and have a Java class that references it. If the Block in Forms memory is destroyed, for example, by calling destroy on its owning Form, then all of its objects are removed from Forms memory. You still have a reference to the Block object, the Block object still exists, but it refernces invalid memory. In this case, if you call a method such as getName() on the Block, it it will throw this exception.

If you have an object of questionable validity, you can prevent this error by calling isValidFormsObject on the object before you attempt to use it.

See Also:
Serialized Form

Constructor Summary
JdapiIllegalStateException()
          Create a new JdapiIllegalStateException with a null message.
JdapiIllegalStateException(java.lang.String message)
          Constructor taking message as argument.
JdapiIllegalStateException(java.lang.Throwable t)
          Constructor taking another throwable as argument.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

JdapiIllegalStateException

public JdapiIllegalStateException()
Create a new JdapiIllegalStateException with a null message.

JdapiIllegalStateException

public JdapiIllegalStateException(java.lang.String message)
Constructor taking message as argument.
Parameters:
message - Message describing the exception.

JdapiIllegalStateException

public JdapiIllegalStateException(java.lang.Throwable t)
Constructor taking another throwable as argument.
Parameters:
Throwable - object.