java.lang
Class IllegalStateException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by java.lang.IllegalStateException

@TransactionType(value=NOT_SUPPORTED)
public class IllegalStateException
extends RuntimeException

Signals that a method has been invoked at an illegal or inappropriate time. In other words, the Java environment or Java application is not in an appropriate state for the requested operation.

This Java Card class is a subset of the JDK 1.5 IllegalStateException class. Some interfaces, methods and/or variables have been pruned, and/or other methods simplified, in an effort to reduce the size of this class and/or eliminate dependencies on unsupported features.

Direct instances of this exception class are not bound to any context and can be passed between contexts without any restrictions. Objects created and returned by the methods of this class are owned by the caller. In particular, a call to the Throwable.getMessage() returns a String instance bound to the owner context of the caller.

See Runtime Environment Specification for the Java Card Platform, Connected Edition, chapter 7 for details regarding transfer of ownership.

Since:
JDK1.1, Java Card 3.0

Constructor Summary
IllegalStateException()
          Constructs an IllegalStateException with no detail message.
IllegalStateException(String s)
          Constructs an IllegalStateException with the specified detail message.
 
Method Summary
 
Methods inherited from class java.lang.Throwable
getMessage, printStackTrace, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

IllegalStateException

public IllegalStateException()
Constructs an IllegalStateException with no detail message. A detail message is a String that describes this particular exception.


IllegalStateException

public IllegalStateException(String s)
Constructs an IllegalStateException with the specified detail message. A detail message is a String that describes this particular exception.

Parameters:
s - the String that contains a detailed message


Copyright (c) 2009 Sun Microsystems, Inc. All rights reserved.