javacard.framework
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 JCRE owned instances of TransactionException.

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) Specification, section 6.2.1 for details.

See Also:

JCSystem

Field Summary

static short	BUFFER_FULL This reason code is used during a transaction to indicate that the commit buffer is full.
static short	IN_PROGRESS This reason code is used by the beginTransaction method to indicate a transaction is already in progress.
static short	INTERNAL_FAILURE This reason code is used during a transaction to indicate an internal JCRE problem (fatal error).
static short	NOT_IN_PROGRESS This reason code is used by the abortTransaction and commitTransaction methods when a transaction is not in progress.

Constructor Summary

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

Method Summary

static void

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

Methods inherited from class javacard.framework.CardRuntimeException

getReason, setReason

Methods inherited from class java.lang.Object

equals

Field Detail

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:

Constant Field Values

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:

Constant Field Values

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:

Constant Field Values

INTERNAL_FAILURE

public static final short INTERNAL_FAILURE

This reason code is used during a transaction to indicate an internal JCRE problem (fatal error).

See Also:

Constant Field Values

Constructor Detail

TransactionException

public TransactionException(short reason)

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

Method Detail

throwIt

public static void throwIt(short reason)

Throws the JCRE owned instance of TransactionException 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) Specification, section 6.2.1 for details.

Throws:

TransactionException - always.