public class SystemException extends CardRuntimeException
SystemException
represents a JCSystem
class
related exception. It is also thrown by the
javacard.framework.Applet.register()
methods and by the
AID
class constructor.
These API classes throw Java Card runtime environment-owned instances of
SystemException
.
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.
Modifier and Type | Field and Description |
---|---|
static short |
ILLEGAL_AID
This reason code is used by the
javacard.framework.Applet.register() method to indicate
that the input AID parameter is not a legal AID value. |
static short |
ILLEGAL_TRANSIENT
This reason code is used to indicate that the request to create a
transient object is not allowed in the current applet context.
|
static short |
ILLEGAL_USE
This reason code is used to indicate that the requested function is not
allowed.
|
static short |
ILLEGAL_VALUE
This reason code is used to indicate that one or more input parameters is
out of allowed bounds.
|
static short |
NO_RESOURCE
This reason code is used to indicate that there is insufficient resource
in the Card for the request.
|
static short |
NO_TRANSIENT_SPACE
This reason code is used by the
makeTransient..() methods
to indicate that no room is available in volatile memory for the
requested object. |
Constructor and Description |
---|
SystemException(short reason)
Constructs a SystemException.
|
Modifier and Type | Method and Description |
---|---|
static void |
throwIt(short reason)
Throws the Java Card runtime environment-owned instance of
SystemException with the specified reason. |
getReason, setReason
public static final short ILLEGAL_VALUE
public static final short NO_TRANSIENT_SPACE
makeTransient..()
methods
to indicate that no room is available in volatile memory for the
requested object.public static final short ILLEGAL_TRANSIENT
public static final short ILLEGAL_AID
javacard.framework.Applet.register()
method to indicate
that the input AID parameter is not a legal AID value.public static final short NO_RESOURCE
For example, the Java Card Virtual Machine may throw
this
exception reason when there is insufficient heap space to create a new
instance.
public static final short ILLEGAL_USE
JCSystem.requestObjectDeletion()
method throws this exception if the object deletion mechanism is not
implemented.public SystemException(short reason)
throwIt()
to use the Java Card runtime environment-owned
instance of this class.reason
- the reason for the exceptionpublic static void throwIt(short reason) throws SystemException
SystemException
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.
reason
- the reason for the exceptionSystemException
- alwaysCopyright © 1998, 2015, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms