Class JdapiIllegalStateException

All Implemented Interfaces:
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:
  • Constructor Details

    • JdapiIllegalStateException

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

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

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