Class TransactionException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
javacard.framework.CardRuntimeException
javacard.framework.TransactionException
public class TransactionException extends CardRuntimeException
TransactionException represents an exception in the transaction subsystem. The methods referred to in this class are in the JCSystem class.

The JCSystem class and the transaction facility throw Java Card runtime environment-owned instances of TransactionException.

Java Card runtime environment-owned instances of exception classes are temporary Java Card runtime environment 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 Runtime Environment Specification, Java Card Platform, Classic Edition, section 6.2.1 for details.

See Also:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final short
    BUFFER_FULL
    This reason code is used during a transaction to indicate that the commit buffer is full.
    static final short
    ILLEGAL_USE
    This reason code is used by the transaction methods to indicate that the method is not available in the caller's environment.
    static final short
    IN_PROGRESS
    This reason code is used by the beginTransaction method to indicate a transaction is already in progress.
    static final short
    INTERNAL_FAILURE
    This reason code is used during a transaction to indicate an internal Java Card runtime environment problem (fatal error).
    static final short
    NOT_IN_PROGRESS
    This reason code is used by the abortTransaction and commitTransaction methods when a transaction is not in progress.

  • Constructor Summary

    Constructors
    Constructor
    Description
    TransactionException(short reason)
    Constructs a TransactionException with the specified reason.

  • Method Summary

    Modifier and Type
    Method
    Description
    static void
    throwIt(short reason)
    Throws the Java Card runtime environment-owned instance of TransactionException with the specified reason.

    Methods inherited from class CardRuntimeException

    getReason, setReason
    Modifier and Type
    Method
    Description
    short
    getReason()
    Gets the reason code
    void
    setReason(short reason)
    Sets the reason code.

    Methods inherited from class Object

    equals
    Modifier and Type
    Method
    Description
    boolean
    equals(Object obj)
    Compares two Objects for equality.

  • Field Details

    • IN_PROGRESS

      public static final short IN_PROGRESS
      This reason code is used by the beginTransaction method to indicate a transaction is already in progress.
      See Also:

    • NOT_IN_PROGRESS

      public static final short NOT_IN_PROGRESS
      This reason code is used by the abortTransaction and commitTransaction methods when a transaction is not in progress.
      See Also:

    • BUFFER_FULL

      public static final short BUFFER_FULL
      This reason code is used during a transaction to indicate that the commit buffer is full.
      See Also:

    • INTERNAL_FAILURE

      public static final short INTERNAL_FAILURE
      This reason code is used during a transaction to indicate an internal Java Card runtime environment problem (fatal error).
      See Also:

    • ILLEGAL_USE

      public static final short ILLEGAL_USE
      This reason code is used by the transaction methods to indicate that the method is not available in the caller's environment.
      See Also:

  • Constructor Details

    • TransactionException

      public TransactionException(short reason)
      Constructs a TransactionException with the specified reason. To conserve on resources use throwIt() to use the Java Card runtime environment-owned instance of this class.
      Parameters:
      reason - the reason for the exception

  • Method Details

    • throwIt

      public static void throwIt(short reason)
      Throws the Java Card runtime environment-owned instance of TransactionException with the specified reason.

      Java Card runtime environment-owned instances of exception classes are temporary Java Card runtime environment 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 Runtime Environment Specification, Java Card Platform, Classic Edition, section 6.2.1 for details.

      Parameters:
      reason - the reason for the exception
      Throws:
      TransactionException - always