Package javacard.framework

Provides a framework of classes and interfaces for building, communicating with and working with Java Card technology-based applets. These classes and interfaces provide the minimum required functionality for a Java Card environment. If additional functionality is desired, for example to specialize the card for a particular market, other frameworks would need to be added.

The key classes and interfaces in this package are:

• AID-encapsulates the Application Identifier (AID) associated with an applet.
• APDU-provides methods for controlling card input and output.
• Applet-the base class for all Java Card technology-based applets on the card. It provides methods for working with applets to be loaded onto, installed into and executed on a Java Card technology-compliant smart card.
• CardException, CardRuntimeException-provide functionality similar to java.lang.Exception and java.lang.RuntimeException in the standard Java programming language, but specialized for the card environment.
• ISO7816-provides important constants for working with input and output data.
• JCSystem-provides methods for controlling system functions such as transaction management, transient objects, object deletion mechanism, resource management, and inter-applet object sharing.
• MultiSelectable-provides methods that support advanced programming techniques with logical channels.
• Shareable-provides a mechanism that lets objects that implement this interface be shared across an applet firewall.
• Util-provides convenient methods for working with arrays and array data.

Interface Summary

Interface	Description
AppletEvent	The AppletEvent interface provides a callback interface for the Java Card runtime environment to inform the applet about life cycle events.
ISO7816	ISO7816 encapsulates constants related to ISO 7816-3 and ISO 7816-4.
MultiSelectable	The MultiSelectable interface identifies the implementing Applet subclass as being capable of concurrent selections.
OwnerPINx	The OwnerPINx interface represents an Owner PIN, extends Personal Identification Number functionality as defined in the PIN interface, and provides the ability to update the PIN, update the try limit and try counter and thus owner functionality.
OwnerPINxWithPredecrement	The OwnerPINxWithPredecrement interface represents an Owner PIN, extends Personal Identification Number functionality as defined in the PIN interface, and provides the ability to update the PIN, update the try limit and try counter and thus owner functionality.
PIN	This interface represents a PIN.
Shareable	The Shareable interface serves to identify all shared objects.

Class Summary

Class	Description
AID	This class encapsulates the Application Identifier (AID) associated with an applet.
APDU	Application Protocol Data Unit (APDU) is the communication format between the card and the off-card applications.
Applet	This abstract class defines an Java Card technology-based applet.
JCSystem	The JCSystem class includes a collection of methods to control applet execution, resource management, atomic transaction management, object deletion mechanism and inter-applet object sharing in the Java Card environment.
OwnerPIN	This class represents an Owner PIN, implements Personal Identification Number functionality as defined in the PIN interface, and provides the ability to update the PIN and thus owner functionality.
OwnerPINBuilder	The OwnerPINBuilder class is factory for Owner PIN objects.
Resources	An instance of Resources provides means to read the resources accessible to the caller code.
SensitiveArrays	The SensitiveArrays class provides methods for creating and handling integrity-sensitive array objects.
Util	The Util class contains common utility functions.

Exception Summary

Exception	Description
APDUException	APDUException represents an APDU related exception.
CardException	The CardException class defines a field reason and two accessor methods getReason() and setReason().
CardRuntimeException	The CardRuntimeException class defines a field reason and two accessor methods getReason() and setReason().
ISOException	ISOException class encapsulates an ISO 7816-4 response status word as its reason code.
PINException	PINException represents a OwnerPIN class or OwnerPINx -implementing class access-related exception.
SystemException	SystemException represents a JCSystem class related exception.
TransactionException	TransactionException represents an exception in the transaction subsystem.
UserException	UserException represents a User exception.