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 theJCSystem
class.The
JCSystem
class and the transaction facility throw Java Card runtime environment-owned instances ofTransactionException
.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:
JCSystem
-
-
Field Summary
Fields Modifier and Type Field Description static short
BUFFER_FULL
This reason code is used during a transaction to indicate that the commit buffer is full.static 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 short
IN_PROGRESS
This reason code is used by thebeginTransaction
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 Java Card runtime environment problem (fatal error).static short
NOT_IN_PROGRESS
This reason code is used by theabortTransaction
andcommitTransaction
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
All Methods Static Methods Concrete Methods Modifier and Type Method Description static void
throwIt(short reason)
Throws the Java Card runtime environment-owned instance ofTransactionException
with the specified reason.-
Methods inherited from class javacard.framework.CardRuntimeException
getReason, setReason
-
-
-
-
Field Detail
-
IN_PROGRESS
public static final short IN_PROGRESS
This reason code is used by thebeginTransaction
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 theabortTransaction
andcommitTransaction
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 Java Card runtime environment problem (fatal error).- See Also:
- Constant Field Values
-
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:
- Constant Field Values
-
-
Constructor Detail
-
TransactionException
public TransactionException(short reason)
Constructs a TransactionException with the specified reason. To conserve on resources usethrowIt()
to use the Java Card runtime environment-owned instance of this class.- Parameters:
reason
- the reason for the exception
-
-
Method Detail
-
throwIt
public static void throwIt(short reason)
Throws the Java Card runtime environment-owned instance ofTransactionException
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
-
-