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, 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

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.