javacard.framework
Class UserException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--javacard.framework.CardException
                    |
                    +--javacard.framework.UserException

public class UserException

extends CardException

UserException represents a User exception. This class also provides a resource-saving mechanism (the throwIt() method) for user exceptions by using a JCRE owned instance.

JCRE owned instances of exception classes are temporary JCRE Entry Point Objects and can be accessed from any applet context. References to these temporary objects cannot be stored in class variables or instance variables or array components. See Java Card Runtime Environment (JCRE) 2.1 Specification for details.

Constructor Summary

UserException()
Constructs a UserException with reason = 0.

UserException(short reason)
Constructs a UserException with the specified reason.

Method Summary

static void

throwIt(short reason) Throws the JCRE owned instance of UserException with the specified reason.

Methods inherited from class javacard.framework.CardException

getReason, setReason

Methods inherited from class java.lang.Object

equals

Constructor Detail

UserException

public UserException()

Constructs a UserException with reason = 0. To conserve on resources use throwIt() to use the JCRE owned instance of this class.

UserException

public UserException(short reason)

Constructs a UserException with the specified reason. To conserve on resources use throwIt() to use the JCRE owned instance of this class.

Parameters:

reason - the reason for the exception.

Method Detail

throwIt

public static void throwIt(short reason)
                    throws UserException

Throws the JCRE owned instance of UserException with the specified reason.

JCRE owned instances of exception classes are temporary JCRE Entry Point Objects and can be accessed from any applet context. References to these temporary objects cannot be stored in class variables or instance variables or array components. See Java Card Runtime Environment (JCRE) 2.1 Specification for details.

Parameters:

reason - the reason for the exception.

Throws:

UserException - always.