RMI Client Application Programming Interface

Transcription

1 RMI Client Application Programming Interface Java Card Platform, Version Sun Microsystems, Inc

2 Copyright 2006 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product that is described in this document. In particular, and without limitation, these intellectual property rights may include one or more of the U.S. patents listed at and one or more additional patents or pending patent applications in the U.S. and in other countries. Use is subject to license terms. Sun, Sun Microsystems, the Sun logo, Java, and Java Card are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open Company, Ltd. Products covered by and information contained in this service manual are controlled by U.S. Export Control laws and may be subject to the export or import laws in other countries. Nuclear, missile, chemical biological weapons or nuclear maritime end uses or end users, whether direct or indirect, are strictly prohibited. Export or reexport to countries subject to U.S. embargo or to entities identified on U.S. export exclusion lists, including, but not limited to, the denied persons and specially designated nationals lists is strictly prohibited. DOCUMENTATION IS PROVIDED "AS IS" AND ALL EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON- INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH DISCLAIMERS ARE HELD TO BE LEGALLY INVALID. Copyright 2006 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, Etats-Unis. Tous droits réservés. Sun Microsystems, Inc. détient les droits de propriété intellectuels relatifs à la technologie incorporée dans le produit qui est décrit dans ce document. En particulier, et ce sans limitation, ces droits de propriété intellectuelle peuvent inclure un ou plus des brevets américains listés à l'adresse et un ou les brevets supplémentaires ou les applications de brevet en attente aux Etats - Unis et dans les autres pays. L'utilisation est soumise aux termes de la Licence. Sun, Sun Microsystems, le logo Sun, Java, et Java Card sont des marques de fabrique ou des marques déposées de Sun Microsystems, Inc. aux Etats-Unis et dans d'autres pays. UNIX est une marque déposée aux Etats-Unis et dans d'autres pays et licenciée exlusivement par X/Open Company, Ltd. Ce produit est soumis à la législation américaine en matière de contrôle des exportations et peut être soumis à la règlementation en vigueur dans d'autres pays dans le domaine des exportations et importations. Les utilisations, ou utilisateurs finaux, pour des armes nucléaires, des missiles, des armes biologiques et chimiques ou du nucléaire maritime, directement ou indirectement, sont strictement interdites. Les exportations ou reexportations vers les pays sous embargo américain, ou vers des entités figurant sur les listes d'exclusion d'exportation américaines, y compris, mais de manière non exhaustive, la liste de personnes qui font objet d'un ordre de ne pas participer, d'une façon directe ou indirecte, aux exportations des produits ou des services qui sont régis par la législation américaine en matière de contrôle des exportations et la liste de ressortissants spécifiquement désignés, sont rigoureusement interdites. LA DOCUMENTATION EST FOURNIE "EN L'ETAT" ET TOUTES AUTRES CONDITIONS, DECLARATIONS ET GARANTIES EXPRESSES OU TACITES SONT FORMELLEMENT EXCLUES, DANS LA MESURE AUTORISEE PAR LA LOI APPLICABLE, Y COMPRIS NOTAMMENT TOUTE GARANTIE IMPLICITE RELATIVE A LA QUALITE MARCHANDE, A L'APTITUDE A UNE UTILISATION PARTICULIERE OU A L'ABSENCE DE CONTREFACON.

3 Contents 1. Client-Side API for RMI on the Java Card Platform 1 Basic Features 1 Client Application Interfaces 2 CardAccessor Interface 2 JCRMIConnect Class 2 ApduIOCardAccessor Class 3 Format of the jcclient.properties File 3 Securing the Transport Layer 4 Stub/Proxy Generation 4 Exceptions 5 2. API Documentation 7 iii

4 iv RMI Client Application Programming Interface, Java Card Platform, Version March 2006

5 CHAPTER 1 Client-Side API for RMI on the Java Card Platform A Java Card remote method invocation (Java Card RMI) client application runs on a Card Acceptance Device (CAD) terminal that supports a Java Platform, Standard Edition (Java SE) or Java Platform, Micro Edition (Java ME). The client application requires a portable and platform independent mechanism to access the Java Card RMI server applet executing on the smart card. This client-side architecture currently focuses on a Java SE client running on a JDK version 1.2 or higher environment. The client interfaces are designed to be independent of the card access framework. The interfaces therefore only provide Java Card RMI-specific access mechanisms and allow the client application to use its preferred card access mechanisms for its basic card interaction needs. The example in Sun Microsystem s reference implementation uses the APDU I/O library for card access. See the Development Kit User s Guide, Java Card Platform, Version provided with this release. The Java ME environment is more limited, and since most Java ME profiles do not support the Java Card RMI machinery at this time, it is not discussed in detail. The design of the Java Card RMI client-side architecture ensures that it does not preclude the Java ME client. Basic Features The Java Card RMI client side architecture caters to the following: Provides the client application mechanisms to initialize and initiate an RMI session with a Java Card applet. Provides the client application access to the initial remote reference. 1

6 Allows the client application to customize the message packet during communication with a Java Card technology-compliant smart card to introduce transport level security. Allows the CAD terminal developer to customize the card access mechanisms for the specifics of the communications hardware. Allows the CAD terminal developer to customize the stub generation mechanism for one that is best suited to the platform capabilities. Client Application Interfaces These classes provide the basic Java Card RMI client application with the front-end mechanisms to connect to the Java Card applet and obtain an initial reference to invoke remote methods. CardAccessor Interface The CardAccessor interface is used by the Java Card RMI client framework to communicate with the card. It defines the following methods: public byte[] exchangeapdu( byte[] command ) The Java Card RMI client framework uses this method to send a command APDU to the card and receive the response APDU. public void closecard() This method closes connection with the card and powers down the card. In the Java Card RMI example provided in this release (see Chapter 3 of the Development Kit User s Guide, Java Card Platform, Version 2.2.2), the client application instantiates the ApduIOCardAccessor, which implements the CardAccessor interface. JCRMIConnect Class The client application uses the JCRMIConnect class to initiate the Java Card RMI session and obtain the initial remote reference from the card. Constructor: public JCRMIConnect(CardAccessor ca) 2 RMI Client Application Programming Interface, Java Card Platform, Version March 2006

7 The client constructs an instance of the JCRMIConnect class, initializing it with a CardAccessor object. The methods of JCRMIConnect are: public byte[] selectapplet(byte[] appletaid, byte format) The client starts a Java Card RMI session with the Java Card applet on the card using this method. The second parameter specifies the format of the remote references and can be either of two constants defined in this class: REF_WITH_CLASS_NAME or REF_WITH_INTERFACE_NAMES. public Remote getinitialreference() To begin a Java Card RMI-based dialog, the client obtains the first remote object reference via this method and then casts it to the appropriate remote interface type. ApduIOCardAccessor Class This class implements a CardAccessor object using the ApduIO library. It has a default constructor, which takes initialization parameters from the file jcclient.properties, which must be located in one of the directories listed in the CLASSPATH. Format of the jcclient.properties File The jcclient.properties file contains a set of parameters for the ApduIOCardAccessor. Each line of the file is in the format parameter=value. Comments are preceded with the # symbol. All parameter names and values are case-sensitive. The parameter connection is mandatory, with possible values of TCP, SERIAL, PCSC, for example: connection = TCP If the connection is TCP or SERIAL, the parameter protocol is required, with possible values of T0 and T1, for example: protocol = T1 If the connection is TCP, the parameters TCP_HOST and TCP_PORT are required, for example: TCP_HOST = localhost TCP_PORT = 9025 If the connection is SERIAL, the parameter SERIAL_PORT is required, for example: Chapter 1 Client-Side API for RMI on the Java Card Platform 3

8 SERIAL_PORT = COM1 Note: If parameter connection is set to PCSC, no other parameters are necessary. The ApduIOCardAccessor will attempt to use default sections of the card reader's driver. Securing the Transport Layer A simple Java Card RMI client application would only depend on the above methods for a remote method based card session with a Java Card applet. The Java Card applet might need to layer additional security services to protect the message transport data for integrity and privacy. In order to do this, the client application (or security service provider) could develop its own version of the CardAccessor class with the exchangeapdu method performing data transformation. The Java Card RMI example provided in this release contains the CustomCardAccessor class, which shows how to perform such a task within its exchangeapdu method. Stub/Proxy Generation The client does not usually interact with the client side stub generation classes. It is used by the JCRMIConnect class to instantiate the initial remote stub object and subsequently the stub objects themselves to instantiate other remote stub objects. The client library includes the class JCCardObjectFactory that encapsulates the mechanism used to instantiate stubs on the client. The JCCardObjectFactory class uses the SELECT REF_FORMAT_CLASS format, locates the pre-compiled stub class corresponding to the implementation class name returned in the remote reference descriptor from the card, and then instantiates it. The client library also includes the class JCCardProxyFactory, which uses the SELECT REF_FORMAT_INTERFACES format. The dynamic proxy generation mechanism, defined by JDK version 1.3, generates the proxy instances according to the list of remote interfaces implemented by the remote class. 4 RMI Client Application Programming Interface, Java Card Platform, Version March 2006

9 Exceptions The remote method invoked on the card may throw an exception to signal that an unexpected condition has been detected. The RMIService class on the card catches the exception and returns this information to the client. If the exception thrown on the card is an exception defined in the Java Card API version 2.2.2, the same exception is re-thrown by the stub object back to the client application. The client can access the reason code associated with Java Card platform-specific exceptions using the standard getreason() method. If the exception thrown on the card is a subclass of an exception defined in the Java Card API version 2.2.2, a client subclass of the closest exception defined in the API (along with the reason code, if applicable) is re-thrown to the client by the stub object. The exception object will contain the following error message string: A subclass was thrown on the card. Apart from the exceptions thrown by the remote method itself, errors during communication, marshalling, protocol, unmarshalling, stub generation and so forth related to the Java Card RMI method invocation results in a RemoteException exception being thrown to the client application with appropriate error message strings which include the following: Applet selection failed, SW =... Incorrect (too short) response received from the card Invalid format requested by the factory Invoke operation failed, SW =... Method not found Object not exported Out of param resources Out of response resources Protocol error reported by the card Signature mismatch Thrown on the card Unexpected exception received while instantiating the stub Unsupported APPLICATION tag Unsupported error type received from the card Unsupported exception type received from the card Unsupported FCI tag Unsupported Java Card RMI tag Unsupported Java Card RMI version Unsupported subclass exception type received from the card Unsupported tag Chapter 1 Client-Side API for RMI on the Java Card Platform 5

10 6 RMI Client Application Programming Interface, Java Card Platform, Version March 2006

11 CHAPTER 2 API Documentation A typical Java Card RMI client application would commonly use the following classes from the client-side API. See the RMI-based demos included with the Java Card platform, version development kit for examples of usage of these classes. package com.sun.javacard.clientlib CardAccessor - as an interface, which must be implemented by any custom card accessor. ApduIOCardAccessor - as a base class or as a source code to implement a custom card accessor. package com.sun.javacard.rmiclientlib JCRMIConnect - to select a card applet and to obtain an initial reference. The remainder of this whitepaper contains a compilation of the API documentation generated by the Javadoc tool for the client-side Java Card RMI application programming interface packages. It includes the classes and interfaces mentioned above, as well as classes that represent various exceptions that may be thrown on the card and re-thrown on the client. Please note the "FRAMES" feature is not supported in this version. 7

12 8 RMI Client Application Programming Interface, Java Card Platform, Version March 2006

13 All Classes Packages com.sun.javacard.clientlib com.sun.javacard.javax.smartcard. rmiclient com.sun.javacard.rmiclientlib javacard.framework javacard.framework.service javacard.security javacardx.biometry javacardx.external javacardx.framework.tlv javacardx.framework.util Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES Packages com.sun. javacard. clientlib com.sun. javacard. javax. smartcard. rmiclient Provides a framework for building client applications capable of exchanging APDUs with Java Cards. Provides framework of classes and interfaces for a Java Card technology-based client. com.sun. javacard. rmiclientlib Provides a framework of classes and interfaces for building Java Card RMI-based client applications. All Classes APDUException APDUExceptionSubclass ApduIOCardAccessor BioException BioExceptionSubclass CardAccessor CardException CardExceptionSubclass CardObjectFactory CardRuntimeException CardRuntimeExceptionSubclass CryptoException CryptoExceptionSubclass ExternalException ExternalExceptionSubclass ISOException ISOExceptionSubclass JCCardObjectFactory JCCardProxyFactory JCRemoteRefImpl JCRMIConnect PINException PINExceptionSubclass ServiceException ServiceExceptionSubclass SystemException SystemExceptionSubclass TLVException TLVExceptionSubclass TransactionException TransactionExceptionSubclass UserException UserExceptionSubclass UtilException UtilExceptionSubclass javacard. framework javacard. framework. service javacard. security javacardx. biometry javacardx. external javacardx. framework. tlv javacardx. framework. util Provides Java Card API exceptions that may be re-thrown on the client. Provides Java Card API exceptions that may be re-thrown on the client. Provides Java Card API exceptions that may be re-thrown on the client. Provides Java Card API exceptions that may be re-thrown on the client. Provides Java Card API exceptions that may be re-thrown on the client. Provides Java Card API exceptions that may be re-thrown on the client. Provides Java Card API exceptions that may be re-thrown on the client. Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES

14

15 All Classes APDUException APDUExceptionSubclass ApduIOCardAccessor BioException BioExceptionSubclass CardAccessor CardException CardExceptionSubclass CardObjectFactory CardRuntimeException CardRuntimeExceptionSubclass CryptoException CryptoExceptionSubclass ExternalException ExternalExceptionSubclass ISOException ISOExceptionSubclass JCCardObjectFactory JCCardProxyFactory JCRemoteRefImpl JCRMIConnect PINException PINExceptionSubclass ServiceException ServiceExceptionSubclass SystemException SystemExceptionSubclass TLVException TLVExceptionSubclass TransactionException TransactionExceptionSubclass UserException UserExceptionSubclass UtilException UtilExceptionSubclass

16 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework Class APDUException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.apduexception All Implemented Interfaces: Direct Known Subclasses: APDUExceptionSubclass public class APDUException extends CardRuntimeException APDUException represents an APDU related exception. See Also: Field Summary static short BAD_LENGTH This reason code is used by the APDU.setOutgoingLength() method to indicate that the length parameter is greater that 256 or if non BLOCK CHAINED data transfer is requested and len is greater than (IFSD-2), where IFSD is the Outgoing Block Size.

17 static short BUFFER_BOUNDS This reason code is used by the APDU.sendBytes() method to indicate that the sum of buffer offset parameter and the byte length parameter exceeds the APDU buffer size. static short ILLEGAL_USE This APDUException reason code indicates that the method should not be invoked based on the current state of the APDU. static short IO_ERROR This reason code indicates that an unrecoverable error occurred in the I/O transmission layer. static short NO_T0_GETRESPONSE This reason code indicates that during T=0 protocol, the CAD did not return a GET RESPONSE command in response to a <61xx> response status to send additional data. static short NO_T0_REISSUE This reason code indicates that during T=0 protocol, the CAD did not reissue the same APDU command with the corrected length in response to a <6Cxx> response status to request command reissue with the specified length. static short T1_IFD_ABORT This reason code indicates that during T=1 protocol, the CAD returned an ABORT S-Block command and aborted the data transfer. Constructor Summary APDUException(short reason) Constructs an APDUException. Method Summary static void throwit(short reason) Throws an instance of APDUException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable

18 fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Field Detail ILLEGAL_USE public static final short ILLEGAL_USE This APDUException reason code indicates that the method should not be invoked based on the current state of the APDU. See Also: Constant Field Values BUFFER_BOUNDS public static final short BUFFER_BOUNDS This reason code is used by the APDU.sendBytes() method to indicate that the sum of buffer offset parameter and the byte length parameter exceeds the APDU buffer size. See Also: Constant Field Values BAD_LENGTH public static final short BAD_LENGTH

19 This reason code is used by the APDU.setOutgoingLength() method to indicate that the length parameter is greater that 256 or if non BLOCK CHAINED data transfer is requested and len is greater than (IFSD-2), where IFSD is the Outgoing Block Size. See Also: Constant Field Values IO_ERROR public static final short IO_ERROR This reason code indicates that an unrecoverable error occurred in the I/O transmission layer. See Also: Constant Field Values NO_T0_GETRESPONSE public static final short NO_T0_GETRESPONSE This reason code indicates that during T=0 protocol, the CAD did not return a GET RESPONSE command in response to a <61xx> response status to send additional data. The outgoing transfer has been aborted. No more data or status can be sent to the CAD in this APDU.process() method. See Also: Constant Field Values T1_IFD_ABORT public static final short T1_IFD_ABORT This reason code indicates that during T=1 protocol, the CAD returned an ABORT S-Block

20 command and aborted the data transfer. The incoming or outgoing transfer has been aborted. No more data can be received from the CAD. No more data or status can be sent to the CAD in this APDU.process() method. See Also: Constant Field Values NO_T0_REISSUE public static final short NO_T0_REISSUE This reason code indicates that during T=0 protocol, the CAD did not reissue the same APDU command with the corrected length in response to a <6Cxx> response status to request command reissue with the specified length. The outgoing transfer has been aborted. No more data or status can be sent to the CAD in this APDU.process() method. See Also: Constant Field Values Constructor Detail APDUException public APDUException(short reason) Constructs an APDUException. Parameters: reason - the reason for the exception. Method Detail throwit public static void throwit(short reason)

21 Throws an instance of APDUException with the specified reason. Parameters: reason - the reason for the exception. Throws: APDUException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

22 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Packages com.sun. javacard.clientlib com.sun. javacard.javax. smartcard. rmiclient com.sun. javacard. rmiclientlib javacard. framework javacard. framework. service javacard.security javacardx. biometry javacardx. external javacardx. framework.tlv javacardx. framework.util Provides a framework for building client applications capable of exchanging APDUs with Java Cards. Provides framework of classes and interfaces for a Java Card technology-based client. Provides a framework of classes and interfaces for building Java Card RMIbased client applications. Provides Java Card API exceptions that may be re-thrown on the client. Provides Java Card API exceptions that may be re-thrown on the client. Provides Java Card platform exceptions that may be re-thrown on the client. Extension package that contains functionality for implementing a biometric framework on the Java Card platform. Extension package that provides mechanisms to access memory subsystems which are not directly addressable by the Java Card runtime environment(java Card RE) on the Java Card platform. Extension package that contains functionality, for managing storage for BER TLV formatted data, based on the ASN.1 BER encoding rules of ISO/IEC :2002, as well as parsing and editing BER TLV formatted data in I/O buffers. Extension package that contains common utility functions for manipulating arrays of primitive components - byte, short or int.

23 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

24 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Hierarchy For All Packages Package Hierarchies: com.sun.javacard.clientlib, com.sun.javacard.javax.smartcard.rmiclient, com.sun.javacard. rmiclientlib, javacard.framework, javacard.framework.service, javacard.security, javacardx. biometry, javacardx.external, javacardx.framework.tlv, javacardx.framework.util Class Hierarchy java.lang.object com.sun.javacard.clientlib.apduiocardaccessor (implements com.sun.javacard. clientlib.cardaccessor) com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory com.sun.javacard.rmiclientlib.jccardobjectfactory com.sun.javacard.rmiclientlib.jccardproxyfactory com.sun.javacard.rmiclientlib.jcremoterefimpl (implements java.lang.reflect. InvocationHandler, java.rmi.server.remoteref) com.sun.javacard.rmiclientlib.jcrmiconnect java.lang.throwable java.lang.exception javacard.framework.cardexception com.sun.javacard.javax.smartcard.rmiclient. CardExceptionSubclass javacard.framework.userexception com.sun.javacard.javax.smartcard.rmiclient. UserExceptionSubclass java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.apduexception com.sun.javacard.javax.smartcard.rmiclient. APDUExceptionSubclass javacardx.biometry.bioexception com.sun.javacard.javax.smartcard.rmiclient.

25 BioExceptionSubclass com.sun.javacard.javax.smartcard.rmiclient. CardRuntimeExceptionSubclass javacard.security.cryptoexception com.sun.javacard.javax.smartcard.rmiclient. CryptoExceptionSubclass javacardx.external.externalexception com.sun.javacard.javax.smartcard.rmiclient. ExternalExceptionSubclass javacard.framework.isoexception com.sun.javacard.javax.smartcard.rmiclient. ISOExceptionSubclass javacard.framework.pinexception com.sun.javacard.javax.smartcard.rmiclient. PINExceptionSubclass javacard.framework.service.serviceexception com.sun.javacard.javax.smartcard.rmiclient. ServiceExceptionSubclass javacard.framework.systemexception com.sun.javacard.javax.smartcard.rmiclient. SystemExceptionSubclass javacardx.framework.tlv.tlvexception com.sun.javacard.javax.smartcard.rmiclient. TLVExceptionSubclass javacard.framework.transactionexception com.sun.javacard.javax.smartcard.rmiclient. TransactionExceptionSubclass javacardx.framework.util.utilexception com.sun.javacard.javax.smartcard.rmiclient. UtilExceptionSubclass Interface Hierarchy com.sun.javacard.clientlib.cardaccessor Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

26 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Deprecated API Contents Deprecated Methods Deprecated Methods com.sun.javacard.rmiclientlib.jcremoterefimpl.done(remotecall) com.sun.javacard.rmiclientlib.jcremoterefimpl.invoke(remotecall) com.sun.javacard.rmiclientlib.jcremoterefimpl.newcall(remoteobject, Operation[], int, long) Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

27 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes A B C D E F G I J M N P R S T U W A APDUException - Exception in javacard.framework APDUException represents an APDU related exception. APDUException(short) - Constructor for exception javacard.framework.apduexception Constructs an APDUException. APDUExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a card subclass of APDUException. APDUExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax. smartcard.rmiclient.apduexceptionsubclass Constructs an APDUExceptionSubclass with the specified reason and specified error message. ApduIOCardAccessor - Class in com.sun.javacard.clientlib Implementation of CardAccessor using ApduIO library ApduIOCardAccessor() - Constructor for class com.sun.javacard.clientlib.apduiocardaccessor Creates a new instance of ApduIOCardAccessor B BAD_LENGTH - Static variable in exception javacard.framework.apduexception This reason code is used by the APDU.setOutgoingLength() method to indicate that the length parameter is greater that 256 or if non BLOCK CHAINED data transfer is requested and len is greater than (IFSD-2), where IFSD is the Outgoing Block Size. BioException - Exception in javacardx.biometry The BioException class encapsulates specific exceptions which can be thrown by the methods of the javacardx.biometry package in case of error. BioException(short) - Constructor for exception javacardx.biometry.bioexception Construct a new biometric exception using a provided reason code. BioExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient The BioException class encapsulates specific exceptions which can be thrown by the methods of the javacardx.biometry package in case of error. BioExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax.smartcard. rmiclient.bioexceptionsubclass

28 BUFFER_BOUNDS - Static variable in exception javacard.framework.apduexception This reason code is used by the APDU.sendBytes() method to indicate that the sum of buffer offset parameter and the byte length parameter exceeds the APDU buffer size. BUFFER_FULL - Static variable in exception javacard.framework.transactionexception This reason code is used during a transaction to indicate that the commit buffer is full. C cad - Variable in class com.sun.javacard.clientlib.apduiocardaccessor Reference to underlying ApduIO object. CANNOT_ACCESS_IN_COMMAND - Static variable in exception javacard.framework.service. ServiceException This reason code is used to indicate that the command in the APDU object cannot be accessed for input processing. CANNOT_ACCESS_OUT_COMMAND - Static variable in exception javacard.framework.service. ServiceException This reason code is used to indicate that the command in the APDU object cannot be accessed for output processing. CardAccessor - Interface in com.sun.javacard.clientlib The CardAccessor interface represents a generic smartcard communication API. CardException - Exception in javacard.framework The CardException class defines a field reason and two accessor methods getreason () and setreason(). CardException(short) - Constructor for exception javacard.framework.cardexception Construct a CardException instance with the specified reason. CardExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a subclass of CardException on the card. CardExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax.smartcard. rmiclient.cardexceptionsubclass Construct a CardExceptionSubclass instance with the specified reason and the specified error message. CardObjectFactory - Class in com.sun.javacard.javax.smartcard.rmiclient This CardObjectFactory abstract class represents the base class for Java Card RMI version stub generation implementations. CardObjectFactory() - Constructor for class com.sun.javacard.javax.smartcard.rmiclient. CardObjectFactory Creates a new CardObjectFactory for this RMI session

29 CardRuntimeException - Exception in javacard.framework The CardRuntimeException class defines a field reason and two accessor methods getreason() and setreason(). CardRuntimeException(short) - Constructor for exception javacard.framework. CardRuntimeException Construct a CardRuntimeException instance with the specified reason. CardRuntimeExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a subclass of CardRuntimeException on the card. CardRuntimeExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax. smartcard.rmiclient.cardruntimeexceptionsubclass Construct a CardRuntimeExceptionSubclass instance with the specified reason and the specified error message. closecard() - Method in class com.sun.javacard.clientlib.apduiocardaccessor Close and powerdown the card. closecard() - Method in interface com.sun.javacard.clientlib.cardaccessor This method closes and resets the card com.sun.javacard.clientlib - package com.sun.javacard.clientlib Provides a framework for building client applications capable of exchanging APDUs with Java Cards. com.sun.javacard.javax.smartcard.rmiclient - package com.sun.javacard.javax.smartcard.rmiclient Provides framework of classes and interfaces for a Java Card technology-based client. com.sun.javacard.rmiclientlib - package com.sun.javacard.rmiclientlib Provides a framework of classes and interfaces for building Java Card RMI-based client applications. COMMAND_DATA_TOO_LONG - Static variable in exception javacard.framework.service. ServiceException This reason code is used to indicate that the incoming data for a command in the APDU object does not fit in the APDU buffer. COMMAND_IS_FINISHED - Static variable in exception javacard.framework.service. ServiceException This reason code is used to indicate that the command in the APDU object has been completely processed. CryptoException - Exception in javacard.security CryptoException represents a cryptography-related exception. CryptoException(short) - Constructor for exception javacard.security.cryptoexception Constructs a CryptoException with the specified reason. CryptoExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a card subclass of CryptoException. CryptoExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax. smartcard.rmiclient.cryptoexceptionsubclass

30 Constructs an CryptoExceptionSubclass with the specified reason and specified error message. D DISPATCH_TABLE_FULL - Static variable in exception javacard.framework.service. ServiceException This reason code is used to indicate that a dispatch table is full done(remotecall) - Method in class com.sun.javacard.rmiclientlib.jcremoterefimpl Deprecated. E EMPTY_TAG - Static variable in exception javacardx.framework.tlv.tlvexception This reason code is used to indicate that the Tag object is empty EMPTY_TLV - Static variable in exception javacardx.framework.tlv.tlvexception This reason code is used to indicate that the TLV object is empty exchangeapdu(byte[]) - Method in class com.sun.javacard.clientlib.apduiocardaccessor Implementation of exchangeapdu method of CardAccessor interface exchangeapdu(byte[]) - Method in interface com.sun.javacard.clientlib.cardaccessor This method sends the specified data to the smartcard, waits for the response and returns the response in the return data. ExternalException - Exception in javacardx.external ExternalException represents an external subsystem related exception. ExternalException(short) - Constructor for exception javacardx.external.externalexception Constructs a ExternalException with the specified reason. ExternalExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient ExternalException represents an external subsystem related exception. ExternalExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax. smartcard.rmiclient.externalexceptionsubclass F

31 format - Variable in class com.sun.javacard.rmiclientlib.jcrmiconnect Format of the remote references. G getinitialreference() - Method in class com.sun.javacard.rmiclientlib.jcrmiconnect Parses the R-APDU which was returned during selecting an applet, returns a reference to an initial remote object getinsbyte() - Method in class com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory returns the configured ISO command INS byte to be used in the Java Card platform remote method invocation command getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. APDUExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. BioExceptionSubclass getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. CardExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. CardRuntimeExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. CryptoExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. ExternalExceptionSubclass getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. ISOExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. PINExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. ServiceExceptionSubclass Returns the error message string of this throwable object.

32 getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. SystemExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. TLVExceptionSubclass getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. TransactionExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. UserExceptionSubclass Returns the error message string of this throwable object. getmessage() - Method in exception com.sun.javacard.javax.smartcard.rmiclient. UtilExceptionSubclass getobject(byte[], int, Class, CardAccessor) - Method in class com.sun.javacard.javax.smartcard. rmiclient.cardobjectfactory This abstract method returns the instance of the card object corresponding to the value returned from the card. getreason() - Method in exception javacard.framework.cardexception Get reason code getreason() - Method in exception javacard.framework.cardruntimeexception Get reason code getrefclass(objectoutput) - Method in class com.sun.javacard.rmiclientlib.jcremoterefimpl Unsupported operation. getremoteobject(byte[], int, CardAccessor) - Method in class com.sun.javacard.javax.smartcard. rmiclient.cardobjectfactory This abstract method instantiates a stub or proxy object corresponding to the remote reference returned from the card getremoteobject(byte[], int, CardAccessor) - Method in class com.sun.javacard.rmiclientlib. JCCardObjectFactory Creates the stub instance for object reference returned from the card, assuming the card returned a reference with class name. getremoteobject(byte[], int, CardAccessor) - Method in class com.sun.javacard.rmiclientlib. JCCardProxyFactory Creates the stub instance for object reference returned from the card, assuming the card returned a reference with list of interface names. getremoterefformat() - Method in class com.sun.javacard.javax.smartcard.rmiclient. CardObjectFactory returns the format of Java Card RMI remote object reference descriptor supported.

33 getremoterefformat() - Method in class com.sun.javacard.rmiclientlib.jccardobjectfactory Returns constant REF_FORMAT_CLASS defined in class CardObjectFactory. getremoterefformat() - Method in class com.sun.javacard.rmiclientlib.jccardproxyfactory Returns constant REF_FORMAT_INTERFACES defined in class CardObjectFactory. I ILLEGAL_AID - Static variable in exception javacard.framework.systemexception 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. ILLEGAL_PARAM - Static variable in exception javacard.framework.service.serviceexception This reason code is used to indicate that an input parameter is not allowed. ILLEGAL_SIZE - Static variable in exception javacardx.framework.tlv.tlvexception This reason code is used to indicate that the size of a TLV or Tag representation in the input parameter is greater than the supported size or will result in in a TLV struture of greater than supported size ILLEGAL_TRANSIENT - Static variable in exception javacard.framework.systemexception This reason code is used to indicate that the request to create a transient object is not allowed in the current applet context. ILLEGAL_USE - Static variable in exception javacard.framework.apduexception This APDUException reason code indicates that the method should not be invoked based on the current state of the APDU. ILLEGAL_USE - Static variable in exception javacard.framework.systemexception This reason code is used to indicate that the requested function is not allowed. ILLEGAL_USE - Static variable in exception javacard.security.cryptoexception This reason code is used to indicate that the signature or cipher algorithm does not pad the incoming message and the input message is not block aligned. ILLEGAL_USE - Static variable in exception javacardx.biometry.bioexception This reason code is used to indicate that the method should not be invoked based on the current state of the card. ILLEGAL_VALUE - Static variable in exception javacard.framework.pinexception This reason code is used to indicate that one or more input parameters is out of allowed bounds. ILLEGAL_VALUE - Static variable in exception javacard.framework.systemexception This reason code is used to indicate that one or more input parameters is out of allowed bounds. ILLEGAL_VALUE - Static variable in exception javacard.security.cryptoexception This reason code is used to indicate that one or more input parameters is out of allowed bounds. ILLEGAL_VALUE - Static variable in exception javacardx.biometry.bioexception This reason code is used to indicate that one or more input parameters is out of allowed bounds.

34 ILLEGAL_VALUE - Static variable in exception javacardx.framework.util.utilexception This reason code is used to indicate that one or more input parameters is not the correct type or is out of allowed bounds. IN_PROGRESS - Static variable in exception javacard.framework.transactionexception This reason code is used by the begintransaction method to indicate a transaction is already in progress. INSUFFICIENT_STORAGE - Static variable in exception javacardx.framework.tlv.tlvexception This reason code is used to indicate that the configured storage capacity of the object will be exceeded INTERNAL_ERROR - Static variable in exception javacardx.external.externalexception This reason code is used to indicate that an unrecoverable external access error occurred. INTERNAL_FAILURE - Static variable in exception javacard.framework.transactionexception This reason code is used during a transaction to indicate an internal Java Card runtime environment problem (fatal error). INVALID_DATA - Static variable in exception javacardx.biometry.bioexception This reason code is used to indicate that the data the system encountered is illegible. INVALID_INIT - Static variable in exception javacard.security.cryptoexception This reason code is used to indicate that the signature or cipher object has not been correctly initialized for the requested operation. INVALID_PARAM - Static variable in exception javacardx.external.externalexception This reason code is used to indicate that an input parameter is invalid. INVALID_PARAM - Static variable in exception javacardx.framework.tlv.tlvexception This reason code is used to indicate that one or more input parameters is invalid. invoke(remote, Method, Object[], long) - Method in class com.sun.javacard.rmiclientlib. JCRemoteRefImpl This method is used by rmic-generated stubs. invoke(remotecall) - Method in class com.sun.javacard.rmiclientlib.jcremoterefimpl Deprecated. invoke(object, Method, Object[]) - Method in class com.sun.javacard.rmiclientlib. JCRemoteRefImpl This method is used by dynamically generated proxies. IO_ERROR - Static variable in exception javacard.framework.apduexception This reason code indicates that an unrecoverable error occurred in the I/O transmission layer. ISOException - Exception in javacard.framework ISOException class encapsulates an ISO response status word as its reason code. ISOException(short) - Constructor for exception javacard.framework.isoexception Constructs an ISOException instance with the specified status word. ISOExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a card subclass of ISOException. ISOExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax.smartcard.

35 rmiclient.isoexceptionsubclass Constructs an ISOExceptionSubclass with the specified reason and specified error message. J javacard.framework - package javacard.framework Provides Java Card API exceptions that may be re-thrown on the client. javacard.framework.service - package javacard.framework.service Provides Java Card API exceptions that may be re-thrown on the client. javacard.security - package javacard.security Provides Java Card platform exceptions that may be re-thrown on the client. javacardx.biometry - package javacardx.biometry Extension package that contains functionality for implementing a biometric framework on the Java Card platform. javacardx.external - package javacardx.external Extension package that provides mechanisms to access memory subsystems which are not directly addressable by the Java Card runtime environment(java Card RE) on the Java Card platform. javacardx.framework.tlv - package javacardx.framework.tlv Extension package that contains functionality, for managing storage for BER TLV formatted data, based on the ASN.1 BER encoding rules of ISO/IEC :2002, as well as parsing and editing BER TLV formatted data in I/O buffers. javacardx.framework.util - package javacardx.framework.util Extension package that contains common utility functions for manipulating arrays of primitive components - byte, short or int. JCCardObjectFactory - Class in com.sun.javacard.rmiclientlib Processes the data returned from the card in the format defined for Java Card RMI. JCCardObjectFactory() - Constructor for class com.sun.javacard.rmiclientlib.jccardobjectfactory The constructor. JCCardProxyFactory - Class in com.sun.javacard.rmiclientlib Processes the data returned from the card in the format defined for Java Card RMI. JCCardProxyFactory() - Constructor for class com.sun.javacard.rmiclientlib.jccardproxyfactory Constructor for the factory. JCRemoteRefImpl - Class in com.sun.javacard.rmiclientlib Represents a reference to a card object. JCRemoteRefImpl(short, String, CardAccessor, CardObjectFactory) - Constructor for class com. sun.javacard.rmiclientlib.jcremoterefimpl Creates new JCRemoteRefImpl

36 JCRMIConnect - Class in com.sun.javacard.rmiclientlib The main class of the Java Card RMI client API. JCRMIConnect(CardAccessor) - Constructor for class com.sun.javacard.rmiclientlib. JCRMIConnect Creates a new instance of JCRMIConnect M MALFORMED_TAG - Static variable in exception javacardx.framework.tlv.tlvexception This reason code is used to indicate that the tag representation is not a well-formed BER Tag MALFORMED_TLV - Static variable in exception javacardx.framework.tlv.tlvexception This reason code is used to indicate that the TLV representation is not a well-formed BER TLV N newcall(remoteobject, Operation[], int, long) - Method in class com.sun.javacard.rmiclientlib. JCRemoteRefImpl Deprecated. NO_RESOURCE - Static variable in exception javacard.framework.systemexception This reason code is used to indicate that there is insufficient resource in the Card for the request. NO_SUCH_ALGORITHM - Static variable in exception javacard.security.cryptoexception This reason code is used to indicate that the requested algorithm or key type is not supported. NO_SUCH_BIO_TEMPLATE - Static variable in exception javacardx.biometry.bioexception This reason code is used to indicate that the provided bio template type is not supported by the template builder. NO_SUCH_SUBSYSTEM - Static variable in exception javacardx.external.externalexception This reason code is used to indicate that specified external subsystem is not available. NO_T0_GETRESPONSE - Static variable in exception javacard.framework.apduexception This reason code indicates that during T=0 protocol, the CAD did not return a GET RESPONSE command in response to a <61xx> response status to send additional data. NO_T0_REISSUE - Static variable in exception javacard.framework.apduexception This reason code indicates that during T=0 protocol, the CAD did not reissue the same APDU command with the corrected length in response to a <6Cxx> response status to request command reissue with the specified length. NO_TEMPLATES_ENROLLED - Static variable in exception javacardx.biometry.bioexception

37 This reason code is used to indicate that no reference template is available for matching, or that the reference template is uninitialized. NO_TRANSIENT_SPACE - Static variable in exception javacard.framework.systemexception This reason code is used by the maketransient..() methods to indicate that no room is available in volatile memory for the requested object. NOT_IN_PROGRESS - Static variable in exception javacard.framework.transactionexception This reason code is used by the aborttransaction and committransaction methods when a transaction is not in progress. P PINException - Exception in javacard.framework PINException represents a OwnerPIN class access-related exception. PINException(short) - Constructor for exception javacard.framework.pinexception Constructs a PINException. PINExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a card subclass of PINException. PINExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax.smartcard. rmiclient.pinexceptionsubclass Constructs an PINExceptionSubclass with the specified reason and specified error message. R readexternal(objectinput) - Method in class com.sun.javacard.rmiclientlib.jcremoterefimpl Unsupported operation. REF_FORMAT_CLASS - Static variable in class com.sun.javacard.javax.smartcard.rmiclient. CardObjectFactory This value (=1) is used to signify that the CardObjectFactory implementation suppports the Java Card RMI remote reference format using the name of the card implementation remote class. REF_FORMAT_INTERFACES - Static variable in class com.sun.javacard.javax.smartcard. rmiclient.cardobjectfactory This value (=2) is used to signify that the CardObjectFactory implementation suppports the Java Card RMI remote reference format using the names of the remote interfaces implemented by the card implementation remote class. REF_FORMAT_NONE - Static variable in class com.sun.javacard.javax.smartcard.rmiclient.

38 CardObjectFactory This value (=0) is used to signify that the CardObjectFactory implementation does not suppport any Java Card RMI remote reference descriptor formats. REF_WITH_CLASS_NAME - Static variable in class com.sun.javacard.rmiclientlib.jcrmiconnect Constant used as the 2nd parameter to selectapplet method. REF_WITH_INTERFACE_NAMES - Static variable in class com.sun.javacard.rmiclientlib. JCRMIConnect Constant used as the 2nd parameter to selectapplet method. REMOTE_OBJECT_NOT_EXPORTED - Static variable in exception javacard.framework.service. ServiceException This reason code is used by RMIService to indicate that the remote method returned an remote object which has not been exported. remoteequals(remoteref) - Method in class com.sun.javacard.rmiclientlib.jcremoterefimpl Compares two remote objects for being identical. remotehashcode() - Method in class com.sun.javacard.rmiclientlib.jcremoterefimpl Unsupported operation. remotetostring() - Method in class com.sun.javacard.rmiclientlib.jcremoterefimpl String representation of remote object. S selectapplet(byte[], byte) - Method in class com.sun.javacard.rmiclientlib.jcrmiconnect Selects an applet, requesting initial reference in the format specified by the 2nd parameter. selectresponse - Variable in class com.sun.javacard.rmiclientlib.jcrmiconnect Response to the SELECT command is stored in this field. ServiceException - Exception in javacard.framework.service ServiceException represents a service framework related exception. ServiceException(short) - Constructor for exception javacard.framework.service.serviceexception Constructs a ServiceException. ServiceExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a card subclass of ServiceException. ServiceExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax. smartcard.rmiclient.serviceexceptionsubclass Constructs an ServiceExceptionSubclass with the specified reason and specified error message. setinsbyte(byte) - Method in class com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory Sets the ISO header INS byte to use for Java Card RMI method invocation commands. setreason(short) - Method in exception javacard.framework.cardexception Set reason code.

39 setreason(short) - Method in exception javacard.framework.cardruntimeexception Set reason code. SystemException - Exception in javacard.framework SystemException represents a JCSystem class related exception. SystemException(short) - Constructor for exception javacard.framework.systemexception Constructs a SystemException. SystemExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a card subclass of SystemException. SystemExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax. smartcard.rmiclient.systemexceptionsubclass Constructs an SystemExceptionSubclass with the specified reason and specified error message. T T1_IFD_ABORT - Static variable in exception javacard.framework.apduexception This reason code indicates that during T=1 protocol, the CAD returned an ABORT S-Block command and aborted the data transfer. TAG_NUMBER_GREATER_THAN_ Static variable in exception javacardx.framework.tlv. TLVException This reason code is used to indicate that the tag number value greater than TAG_SIZE_GREATER_THAN_127 - Static variable in exception javacardx.framework.tlv. TLVException This reason code is used to indicate that the size of the tag representation is greater than 127 bytes throwit(short) - Static method in exception javacard.framework.apduexception Throws an instance of APDUException with the specified reason. throwit(short) - Static method in exception javacard.framework.cardexception Throw an instance of CardException class with the specified reason. throwit(short) - Static method in exception javacard.framework.cardruntimeexception Throw an instance of the CardRuntimeException class with the specified reason. throwit(short) - Static method in exception javacard.framework.isoexception Throws an instance of the ISOException class with the specified status word. throwit(short) - Static method in exception javacard.framework.pinexception Throws an instance of PINException with the specified reason. throwit(short) - Static method in exception javacard.framework.service.serviceexception Throws an instance of ServiceException with the specified reason. throwit(short) - Static method in exception javacard.framework.systemexception Throws an instance of SystemException with the specified reason.

40 throwit(short) - Static method in exception javacard.framework.transactionexception Throws an instance of TransactionException with the specified reason. throwit(short) - Static method in exception javacard.framework.userexception Throws an instance of UserException with the specified reason. throwit(short) - Static method in exception javacard.security.cryptoexception Throws an instance of CryptoException with the specified reason. throwit(short) - Static method in exception javacardx.biometry.bioexception Throws the Java Card runtime environment owned instance of BioException with the specified reason. throwit(short) - Static method in exception javacardx.external.externalexception Throws the Java Card runtime environment-owned instance of ExternalException with the specified reason. throwit(short) - Static method in exception javacardx.framework.tlv.tlvexception Throws the Java Card runtime environment-owned instance of TLVException with the specified reason. throwit(short) - Static method in exception javacardx.framework.util.utilexception Throws the Java Card runtime environment-owned instance of UtilException with the specified reason. TLV_LENGTH_GREATER_THAN_ Static variable in exception javacardx.framework.tlv. TLVException This reason code is used to indicate that the Length component value in the TLV is greater than TLV_SIZE_GREATER_THAN_ Static variable in exception javacardx.framework.tlv. TLVException This reason code is used to indicate that the TLV requires more that bytes to represent TLVException - Exception in javacardx.framework.tlv TLVException represents a TLV-related exception. TLVException(short) - Constructor for exception javacardx.framework.tlv.tlvexception Constructs a TLVException with the specified reason. TLVExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient TLVException represents a TLV-related exception. TLVExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax.smartcard. rmiclient.tlvexceptionsubclass TransactionException - Exception in javacard.framework TransactionException represents an exception in the transaction subsystem. TransactionException(short) - Constructor for exception javacard.framework.transactionexception Constructs a TransactionException with the specified reason. TransactionExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a card subclass of TransactionException.

41 TransactionExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax. smartcard.rmiclient.transactionexceptionsubclass Constructs an TransactionExceptionSubclass with the specified reason and specified error message. TYPE_MISMATCHED - Static variable in exception javacardx.framework.util.utilexception This reason code is used to indicate that input parameters are not the same type. U UNINITIALIZED_KEY - Static variable in exception javacard.security.cryptoexception This reason code is used to indicate that the key is uninitialized. UserException - Exception in javacard.framework UserException represents a User exception. UserException() - Constructor for exception javacard.framework.userexception Constructs a UserException with reason = 0. UserException(short) - Constructor for exception javacard.framework.userexception Constructs a UserException with the specified reason. UserExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient This exception class represents a card subclass of UserException. UserExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax.smartcard. rmiclient.userexceptionsubclass Constructs an UserExceptionSubclass with the specified reason and specified error message. UtilException - Exception in javacardx.framework.util UtilException represents a util related exception. UtilException(short) - Constructor for exception javacardx.framework.util.utilexception Constructs a UtilException with the specified reason. UtilExceptionSubclass - Exception in com.sun.javacard.javax.smartcard.rmiclient UtilException represents a util related exception. UtilExceptionSubclass(String, short) - Constructor for exception com.sun.javacard.javax.smartcard. rmiclient.utilexceptionsubclass W writeexternal(objectoutput) - Method in class com.sun.javacard.rmiclientlib.jcremoterefimpl

42 Unsupported operation. A B C D E F G I J M N P R S T U W Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

43 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes How This API Document Is Organized This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows. Overview Package The Overview page is the front page of this API document and provides a list of all packages with a summary for each. This page can also contain an overall description of the set of packages. Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain four categories: Interfaces (italic) Classes Enums Exceptions Errors Annotation Types Class/Interface Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions: Class inheritance diagram Direct Subclasses All Known Subinterfaces All Known Implementing Classes Class/interface declaration Class/interface description

44 Nested Class Summary Field Summary Constructor Summary Method Summary Field Detail Constructor Detail Method Detail Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer. Annotation Type Each annotation type has its own separate page with the following sections: Annotation Type declaration Annotation Type description Required Element Summary Optional Element Summary Element Detail Enum Each enum has its own separate page with the following sections: Enum declaration Enum description Enum Constant Summary Enum Constant Detail Tree (Class Hierarchy) There is a Class Hierarchy page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with java.lang.object. The interfaces do not inherit from java.lang.object. When viewing the Overview page, clicking on "Tree" displays the hierarchy for

45 all packages. When viewing a particular package, class or interface page, clicking "Tree" displays the hierarchy for only that package. Deprecated API Index Prev/Next The Deprecated API page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations. The Index contains an alphabetic list of all classes, interfaces, constructors, methods, and fields. These links take you to the next or previous class, interface, package, or related page. Frames/No Frames These links show and hide the HTML frames. All pages are available with or without frames. Constant Field Values The Constant Field Values page lists the static final fields and their values. This help file applies to API documentation generated using the standard doclet. Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

46 All Classes APDUException APDUExceptionSubclass ApduIOCardAccessor BioException BioExceptionSubclass CardAccessor CardException CardExceptionSubclass CardObjectFactory CardRuntimeException CardRuntimeExceptionSubclass CryptoException CryptoExceptionSubclass ExternalException ExternalExceptionSubclass ISOException ISOExceptionSubclass JCCardObjectFactory JCCardProxyFactory JCRemoteRefImpl JCRMIConnect PINException PINExceptionSubclass ServiceException ServiceExceptionSubclass SystemException SystemExceptionSubclass TLVException TLVExceptionSubclass TransactionException TransactionExceptionSubclass UserException UserExceptionSubclass UtilException UtilExceptionSubclass

47 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package javacard.framework Provides Java Card API exceptions that may be re-thrown on the client. See: Description Exception Summary APDUException CardException CardRuntimeException ISOException PINException SystemException TransactionException UserException APDUException represents an APDU related exception. The CardException class defines a field reason and two accessor methods getreason() and setreason(). The CardRuntimeException class defines a field reason and two accessor methods getreason() and setreason(). ISOException class encapsulates an ISO response status word as its reason code. PINException represents a OwnerPIN class access-related exception. SystemException represents a JCSystem class related exception. TransactionException represents an exception in the transaction subsystem. UserException represents a User exception. Package javacard.framework Description Provides Java Card API exceptions that may be re-thrown on the client. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

48 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Package Hierarchies: All Packages Hierarchy For Package javacard.framework Class Hierarchy java.lang.object java.lang.throwable java.lang.exception javacard.framework.cardexception javacard.framework.userexception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.apduexception javacard.framework.isoexception javacard.framework.pinexception javacard.framework.systemexception javacard.framework.transactionexception Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

49 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Hierarchy For Package com.sun.javacard.rmiclientlib Package Hierarchies: All Packages Class Hierarchy java.lang.object com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory com.sun.javacard.rmiclientlib.jccardobjectfactory com.sun.javacard.rmiclientlib.jccardproxyfactory com.sun.javacard.rmiclientlib.jcremoterefimpl (implements java.lang.reflect. InvocationHandler, java.rmi.server.remoteref) com.sun.javacard.rmiclientlib.jcrmiconnect Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

50 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package com.sun.javacard.rmiclientlib Provides a framework of classes and interfaces for building Java Card RMI-based client applications. See: Description Class Summary JCCardObjectFactory JCCardProxyFactory JCRemoteRefImpl JCRMIConnect Processes the data returned from the card in the format defined for Java Card RMI. Processes the data returned from the card in the format defined for Java Card RMI. Represents a reference to a card object. The main class of the Java Card RMI client API. Package com.sun.javacard.rmiclientlib Description Provides a framework of classes and interfaces for building Java Card RMI-based client applications. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

51 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package com.sun.javacard.javax.smartcard.rmiclient Provides framework of classes and interfaces for a Java Card technology-based client. See: Description Class Summary CardObjectFactory This CardObjectFactory abstract class represents the base class for Java Card RMI version stub generation implementations. Exception Summary APDUExceptionSubclass BioExceptionSubclass CardExceptionSubclass CardRuntimeExceptionSubclass CryptoExceptionSubclass ExternalExceptionSubclass ISOExceptionSubclass PINExceptionSubclass This exception class represents a card subclass of APDUException. The BioException class encapsulates specific exceptions which can be thrown by the methods of the javacardx. biometry package in case of error. This exception class represents a subclass of CardException on the card. This exception class represents a subclass of CardRuntimeException on the card. This exception class represents a card subclass of CryptoException. ExternalException represents an external subsystem related exception. This exception class represents a card subclass of ISOException. This exception class represents a card subclass of PINException.

52 ServiceExceptionSubclass SystemExceptionSubclass TLVExceptionSubclass TransactionExceptionSubclass UserExceptionSubclass UtilExceptionSubclass This exception class represents a card subclass of ServiceException. This exception class represents a card subclass of SystemException. TLVException represents a TLV-related exception. This exception class represents a card subclass of TransactionException. This exception class represents a card subclass of UserException. UtilException represents a util related exception. Package com.sun.javacard.javax.smartcard.rmiclient Description Provides framework of classes and interfaces for a Java Card technology-based client. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

53 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Hierarchy For Package com.sun.javacard.javax.smartcard. rmiclient Package Hierarchies: All Packages Class Hierarchy java.lang.object com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory java.lang.throwable java.lang.exception javacard.framework.cardexception com.sun.javacard.javax.smartcard.rmiclient. CardExceptionSubclass javacard.framework.userexception com.sun.javacard.javax.smartcard.rmiclient. UserExceptionSubclass java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.apduexception com.sun.javacard.javax.smartcard.rmiclient. APDUExceptionSubclass javacardx.biometry.bioexception com.sun.javacard.javax.smartcard.rmiclient. BioExceptionSubclass com.sun.javacard.javax.smartcard.rmiclient. CardRuntimeExceptionSubclass javacard.security.cryptoexception com.sun.javacard.javax.smartcard.rmiclient. CryptoExceptionSubclass javacardx.external.externalexception com.sun.javacard.javax.smartcard.rmiclient.

54 ExternalExceptionSubclass javacard.framework.isoexception com.sun.javacard.javax.smartcard.rmiclient. ISOExceptionSubclass javacard.framework.pinexception com.sun.javacard.javax.smartcard.rmiclient. PINExceptionSubclass javacard.framework.service.serviceexception com.sun.javacard.javax.smartcard.rmiclient. ServiceExceptionSubclass javacard.framework.systemexception com.sun.javacard.javax.smartcard.rmiclient. SystemExceptionSubclass javacardx.framework.tlv.tlvexception com.sun.javacard.javax.smartcard.rmiclient. TLVExceptionSubclass javacard.framework.transactionexception com.sun.javacard.javax.smartcard.rmiclient. TransactionExceptionSubclass javacardx.framework.util.utilexception com.sun.javacard.javax.smartcard.rmiclient. UtilExceptionSubclass Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

55 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Hierarchy For Package com.sun.javacard.clientlib Package Hierarchies: All Packages Class Hierarchy java.lang.object com.sun.javacard.clientlib.apduiocardaccessor (implements com.sun.javacard. clientlib.cardaccessor) Interface Hierarchy com.sun.javacard.clientlib.cardaccessor Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

56 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package com.sun.javacard.clientlib Provides a framework for building client applications capable of exchanging APDUs with Java Cards. See: Description Interface Summary CardAccessor The CardAccessor interface represents a generic smartcard communication API. Class Summary ApduIOCardAccessor Implementation of CardAccessor using ApduIO library Package com.sun.javacard.clientlib Description Provides a framework for building client applications capable of exchanging APDUs with Java Cards. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

57 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class APDUExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.apduexception com.sun.javacard.javax.smartcard.rmiclient. APDUExceptionSubclass All Implemented Interfaces: public class APDUExceptionSubclass extends APDUException This exception class represents a card subclass of APDUException. APDUException represents an APDU related exception on the card. See Also: Field Summary Fields inherited from class javacard.framework.apduexception BAD_LENGTH, BUFFER_BOUNDS, ILLEGAL_USE, IO_ERROR, NO_T0_GETRESPONSE, NO_T0_REISSUE, T1_IFD_ABORT

58 Constructor Summary APDUExceptionSubclass(java.lang.String msg, short reason) Constructs an APDUExceptionSubclass with the specified reason and specified error message. Method Summary java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.apduexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail APDUExceptionSubclass public APDUExceptionSubclass(java.lang.String msg, short reason) Constructs an APDUExceptionSubclass with the specified reason and specified error message.

59 Parameters: msg - the associated message string reason - the reason for the exception. Method Detail getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

60 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class BioExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.biometry.bioexception com.sun.javacard.javax.smartcard.rmiclient. BioExceptionSubclass All Implemented Interfaces: public class BioExceptionSubclass extends BioException The BioException class encapsulates specific exceptions which can be thrown by the methods of the javacardx.biometry package in case of error. See Also: Field Summary Fields inherited from class javacardx.biometry.bioexception ILLEGAL_USE, ILLEGAL_VALUE, INVALID_DATA, NO_SUCH_BIO_TEMPLATE, NO_TEMPLATES_ENROLLED

61 Constructor Summary BioExceptionSubclass(java.lang.String msg, short reason) Method Summary java. lang. String getmessage() Methods inherited from class javacardx.biometry.bioexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail BioExceptionSubclass public BioExceptionSubclass(java.lang.String msg, short reason)

62 Method Detail getmessage public java.lang.string getmessage() Overrides: getmessage in class java.lang.throwable Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

63 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class CardExceptionSubclass java.lang.object java.lang.throwable java.lang.exception javacard.framework.cardexception com.sun.javacard.javax.smartcard.rmiclient. CardExceptionSubclass All Implemented Interfaces: public class CardExceptionSubclass extends CardException This exception class represents a subclass of CardException on the card. The CardException class on the card defines a field reason and two accessor methods getreason() and setreason(). The reason field encapsulates the exception cause identifier in the Java Card API All Java Card API checked Exception classes on the card should extend CardException. See Also: Constructor Summary CardExceptionSubclass(java.lang.String msg, short reason) Construct a CardExceptionSubclass instance with the specified reason and the specified error message.

64 Method Summary java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.cardexception getreason, setreason, throwit Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail CardExceptionSubclass public CardExceptionSubclass(java.lang.String msg, short reason) Construct a CardExceptionSubclass instance with the specified reason and the specified error message. Parameters: msg - the associated message string reason - the reason for the exception Method Detail getmessage

65 public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

66 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class CardObjectFactory java.lang.object com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory Direct Known Subclasses: JCCardObjectFactory, JCCardProxyFactory public abstract class CardObjectFactory extends java.lang.object This CardObjectFactory abstract class represents the base class for Java Card RMI version stub generation implementations. An instance of this class is associated with one Java Card applet selection session. Field Summary static byte REF_FORMAT_CLASS This value (=1) is used to signify that the CardObjectFactory implementation suppports the Java Card RMI remote reference format using the name of the card implementation remote class. static byte REF_FORMAT_INTERFACES This value (=2) is used to signify that the CardObjectFactory implementation suppports the Java Card RMI remote reference format using the names of the remote interfaces implemented by the card implementation remote class. static byte REF_FORMAT_NONE This value (=0) is used to signify that the CardObjectFactory implementation does not suppport any Java Card RMI remote reference descriptor formats. Constructor Summary CardObjectFactory() Creates a new CardObjectFactory for this RMI session

67 Method Summary byte getinsbyte() returns the configured ISO command INS byte to be used in the Java Card platform remote method invocation command java. lang. Object protected abstract java.rmi. Remote abstract byte getobject(byte[] buffer, int tagoffset, java.lang.class type, CardAccessor cardaccessor) This abstract method returns the instance of the card object corresponding to the value returned from the card. getremoteobject(byte[] buffer, int tagoffset, CardAccessor cardaccessor) This abstract method instantiates a stub or proxy object corresponding to the remote reference returned from the card getremoterefformat() returns the format of Java Card RMI remote object reference descriptor supported. void setinsbyte(byte ins) Sets the ISO header INS byte to use for Java Card RMI method invocation commands. Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait Field Detail REF_FORMAT_NONE public static final byte REF_FORMAT_NONE This value (=0) is used to signify that the CardObjectFactory implementation does not suppport any Java Card RMI remote reference descriptor formats. See Also: Constant Field Values REF_FORMAT_CLASS

68 public static final byte REF_FORMAT_CLASS This value (=1) is used to signify that the CardObjectFactory implementation suppports the Java Card RMI remote reference format using the name of the card implementation remote class. See Also: Constant Field Values REF_FORMAT_INTERFACES public static final byte REF_FORMAT_INTERFACES This value (=2) is used to signify that the CardObjectFactory implementation suppports the Java Card RMI remote reference format using the names of the remote interfaces implemented by the card implementation remote class. See Also: Constant Field Values Constructor Detail CardObjectFactory public CardObjectFactory() Creates a new CardObjectFactory for this RMI session Method Detail getobject public java.lang.object getobject(byte[] buffer, int tagoffset, java.lang.class type, CardAccessor cardaccessor) throws java.rmi.remoteexception, java.rmi.stubnotfoundexception, java.lang.exception This abstract method returns the instance of the card object corresponding to the value returned from the card. The value returned by the card may be any of the valid return types in Java Card RMI version 2.2

69 protocol format. In particular the return type may be a primitive, an array type or a remote reference descriptor or null. The method delegates processing to getremoteobject(...) when the response tag is normal and expected type is a remote reference. Parameters: cardaccessor - used to instantiate stubs or proxies of remote objects buffer - the byte array containing the Java Card RMI version 2.2 response data tagoffset - the offset within the array where the response tag is located type - the expected return type in the response data Returns: the object associated with the response data. Primitive return value is encapsulated in a wrapper object. Throws: java.rmi.stubnotfoundexception - if an appropriate object could not be instantiated java.rmi.remoteexception - for any RMI-specific exceptions java.lang.exception - for exceptions thrown on the card getremoteobject protected abstract java.rmi.remote getremoteobject(byte[] buffer, int tagoffset, CardAccessor cardaccessor) throws java.lang.exception This abstract method instantiates a stub or proxy object corresponding to the remote reference returned from the card Parameters: buffer - the byte array containing the JC 2.2 RMI response data tagoffset - the offset within the array where the response tag is located Returns: Stub or proxy Throws: java.lang.exception - In case of error during processing setinsbyte public void setinsbyte(byte ins) Sets the ISO header INS byte to use for Java Card RMI method invocation commands. Parameters:

70 ins - the ISO INS command header byte to use for Java Card RMI invocation commands getinsbyte public byte getinsbyte() returns the configured ISO command INS byte to be used in the Java Card platform remote method invocation command Returns: the ISO INS byte Since: Java Card 2.2 getremoterefformat public abstract byte getremoterefformat() returns the format of Java Card RMI remote object reference descriptor supported. It returns one of : REF_FORMAT_NONE, REF_FORMAT_CLASS, REF_FORMAT_INTERFACES Returns: one of the REF_FORMAT.. values defined above Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

71 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class CardRuntimeExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception com.sun.javacard.javax.smartcard.rmiclient. CardRuntimeExceptionSubclass All Implemented Interfaces: public class CardRuntimeExceptionSubclass extends CardRuntimeException This exception class represents a subclass of CardRuntimeException on the card. The CardRuntimeException class on the card defines a field reason and two accessor methods getreason() and setreason(). The reason field encapsulates exception cause identifier in the Java Card API. All Java Card API unchecked Exception classes on the card should extend CardRuntimeException. See Also: Constructor Summary CardRuntimeExceptionSubclass(java.lang.String msg, short reason) Construct a CardRuntimeExceptionSubclass instance with the specified reason and the specified error message.

72 Method Summary java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason, throwit Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail CardRuntimeExceptionSubclass public CardRuntimeExceptionSubclass(java.lang.String msg, short reason) Construct a CardRuntimeExceptionSubclass instance with the specified reason and the specified error message. Parameters: msg - the associated message string reason - the reason for the exception Method Detail

73 getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

74 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class CryptoExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.security.cryptoexception com.sun.javacard.javax.smartcard.rmiclient. CryptoExceptionSubclass All Implemented Interfaces: public class CryptoExceptionSubclass extends CryptoException This exception class represents a card subclass of CryptoException. CryptoException represents a cryptography-related exception. See Also: Field Summary Fields inherited from class javacard.security.cryptoexception ILLEGAL_USE, ILLEGAL_VALUE, INVALID_INIT, NO_SUCH_ALGORITHM, UNINITIALIZED_KEY

75 Constructor Summary CryptoExceptionSubclass(java.lang.String msg, short reason) Constructs an CryptoExceptionSubclass with the specified reason and specified error message. Method Summary java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.security.cryptoexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail CryptoExceptionSubclass public CryptoExceptionSubclass(java.lang.String msg, short reason) Constructs an CryptoExceptionSubclass with the specified reason and specified error message.

76 Parameters: msg - the associated message string reason - the reason for the exception. Method Detail getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

77 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class ExternalExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.external.externalexception com.sun.javacard.javax.smartcard.rmiclient. ExternalExceptionSubclass All Implemented Interfaces: public class ExternalExceptionSubclass extends ExternalException ExternalException represents an external subsystem related exception. The API classes throw Java Card runtime environment-owned instances of ExternalException. 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. Since: See Also:

78 Field Summary Fields inherited from class javacardx.external.externalexception INTERNAL_ERROR, INVALID_PARAM, NO_SUCH_SUBSYSTEM Constructor Summary ExternalExceptionSubclass(java.lang.String msg, short reason) Method Summary java. lang. String getmessage() Methods inherited from class javacardx.external.externalexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail

79 ExternalExceptionSubclass public ExternalExceptionSubclass(java.lang.String msg, short reason) Method Detail getmessage public java.lang.string getmessage() Overrides: getmessage in class java.lang.throwable Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

80 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class ISOExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.isoexception com.sun.javacard.javax.smartcard.rmiclient. ISOExceptionSubclass All Implemented Interfaces: public class ISOExceptionSubclass extends ISOException This exception class represents a card subclass of ISOException. ISOException class encapsulates an ISO response status word as its reason code. See Also: Constructor Summary ISOExceptionSubclass(java.lang.String msg, short reason) Constructs an ISOExceptionSubclass with the specified reason and specified error message. Method Summary

81 java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.isoexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail ISOExceptionSubclass public ISOExceptionSubclass(java.lang.String msg, short reason) Constructs an ISOExceptionSubclass with the specified reason and specified error message. Parameters: msg - the associated message string reason - the ISO defined status word Method Detail

82 getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

83 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class PINExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.pinexception com.sun.javacard.javax.smartcard.rmiclient. PINExceptionSubclass All Implemented Interfaces: public class PINExceptionSubclass extends PINException This exception class represents a card subclass of PINException. PINException represents a OwnerPIN class access-related exception. See Also: Field Summary Fields inherited from class javacard.framework.pinexception ILLEGAL_VALUE

84 Constructor Summary PINExceptionSubclass(java.lang.String msg, short reason) Constructs an PINExceptionSubclass with the specified reason and specified error message. Method Summary java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.pinexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail PINExceptionSubclass public PINExceptionSubclass(java.lang.String msg, short reason) Constructs an PINExceptionSubclass with the specified reason and specified error message.

85 Parameters: msg - the associated message string reason - the reason for the exception. Method Detail getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

86 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class ServiceExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.service.serviceexception com.sun.javacard.javax.smartcard.rmiclient. ServiceExceptionSubclass All Implemented Interfaces: public class ServiceExceptionSubclass extends ServiceException This exception class represents a card subclass of ServiceException. ServiceException represents a service framework related exception. See Also: Field Summary Fields inherited from class javacard.framework.service.serviceexception

87 CANNOT_ACCESS_IN_COMMAND, CANNOT_ACCESS_OUT_COMMAND, COMMAND_DATA_TOO_LONG, COMMAND_IS_FINISHED, DISPATCH_TABLE_FULL, ILLEGAL_PARAM, REMOTE_OBJECT_NOT_EXPORTED Constructor Summary ServiceExceptionSubclass(java.lang.String msg, short reason) Constructs an ServiceExceptionSubclass with the specified reason and specified error message. Method Summary java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.service.serviceexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail ServiceExceptionSubclass

88 public ServiceExceptionSubclass(java.lang.String msg, short reason) Constructs an ServiceExceptionSubclass with the specified reason and specified error message. Parameters: msg - the associated message string reason - the reason for the exception. Method Detail getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

89 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class SystemExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.systemexception com.sun.javacard.javax.smartcard.rmiclient. SystemExceptionSubclass All Implemented Interfaces: public class SystemExceptionSubclass extends SystemException This exception class represents a card subclass of SystemException. SystemException represents a JCSystem class related exception. See Also: Field Summary Fields inherited from class javacard.framework.systemexception ILLEGAL_AID, ILLEGAL_TRANSIENT, ILLEGAL_USE, ILLEGAL_VALUE, NO_RESOURCE, NO_TRANSIENT_SPACE

90 Constructor Summary SystemExceptionSubclass(java.lang.String msg, short reason) Constructs an SystemExceptionSubclass with the specified reason and specified error message. Method Summary java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.systemexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail SystemExceptionSubclass public SystemExceptionSubclass(java.lang.String msg, short reason) Constructs an SystemExceptionSubclass with the specified reason and specified error message.

91 Parameters: msg - the associated message string reason - the reason for the exception. Method Detail getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

92 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class TLVExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.framework.tlv.tlvexception com.sun.javacard.javax.smartcard.rmiclient. TLVExceptionSubclass All Implemented Interfaces: public class TLVExceptionSubclass extends TLVException TLVException represents a TLV-related exception. The API classes throw Java Card runtime environment-owned instances of TLVException. 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, instance variables, or array components. See Also: Field Summary

93 Fields inherited from class javacardx.framework.tlv.tlvexception EMPTY_TAG, EMPTY_TLV, ILLEGAL_SIZE, INSUFFICIENT_STORAGE, INVALID_PARAM, MALFORMED_TAG, MALFORMED_TLV, TAG_NUMBER_GREATER_THAN_32767, TAG_SIZE_GREATER_THAN_127, TLV_LENGTH_GREATER_THAN_32767, TLV_SIZE_GREATER_THAN_32767 Constructor Summary TLVExceptionSubclass(java.lang.String msg, short reason) Method Summary java. lang. String getmessage() Methods inherited from class javacardx.framework.tlv.tlvexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait

94 Constructor Detail TLVExceptionSubclass public TLVExceptionSubclass(java.lang.String msg, short reason) Method Detail getmessage public java.lang.string getmessage() Overrides: getmessage in class java.lang.throwable Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

95 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class TransactionExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.transactionexception com.sun.javacard.javax.smartcard.rmiclient. TransactionExceptionSubclass All Implemented Interfaces: public class TransactionExceptionSubclass extends TransactionException This exception class represents a card subclass of TransactionException. TransactionException represents an exception in the transaction subsystem. See Also: Field Summary Fields inherited from class javacard.framework.transactionexception BUFFER_FULL, IN_PROGRESS, INTERNAL_FAILURE, NOT_IN_PROGRESS

96 Constructor Summary TransactionExceptionSubclass(java.lang.String msg, short reason) Constructs an TransactionExceptionSubclass with the specified reason and specified error message. Method Summary java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.transactionexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail TransactionExceptionSubclass public TransactionExceptionSubclass(java.lang.String msg, short reason) Constructs an TransactionExceptionSubclass with the specified reason and specified error

97 message. Parameters: msg - the associated message string reason - the reason for the exception. Method Detail getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

98 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class UserExceptionSubclass java.lang.object java.lang.throwable java.lang.exception javacard.framework.cardexception javacard.framework.userexception com.sun.javacard.javax.smartcard.rmiclient. UserExceptionSubclass All Implemented Interfaces: public class UserExceptionSubclass extends UserException This exception class represents a card subclass of UserException. UserException represents a User exception. See Also: Constructor Summary UserExceptionSubclass(java.lang.String msg, short reason) Constructs an UserExceptionSubclass with the specified reason and specified error message. Method Summary

99 java. lang. String getmessage() Returns the error message string of this throwable object. Methods inherited from class javacard.framework.userexception throwit Methods inherited from class javacard.framework.cardexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail UserExceptionSubclass public UserExceptionSubclass(java.lang.String msg, short reason) Constructs an UserExceptionSubclass with the specified reason and specified error message. Parameters: msg - the associated message string reason - the reason for the exception. Method Detail

100 getmessage public java.lang.string getmessage() Returns the error message string of this throwable object. Overrides: getmessage in class java.lang.throwable Returns: the error message string of this Throwable object if it was created with an error message string; or null if it was created with no error message. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

101 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.javax.smartcard.rmiclient Class UtilExceptionSubclass java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.framework.util.utilexception com.sun.javacard.javax.smartcard.rmiclient. UtilExceptionSubclass All Implemented Interfaces: public class UtilExceptionSubclass extends UtilException UtilException represents a util related exception. The API classes throw Java Card runtime environment-owned instances of UtilException. 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, instance variables, or array components. See Also: Field Summary

102 Fields inherited from class javacardx.framework.util.utilexception ILLEGAL_VALUE, TYPE_MISMATCHED Constructor Summary UtilExceptionSubclass(java.lang.String msg, short reason) Method Summary java. lang. String getmessage() Methods inherited from class javacardx.framework.util.utilexception throwit Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail UtilExceptionSubclass

103 public UtilExceptionSubclass(java.lang.String msg, short reason) Method Detail getmessage public java.lang.string getmessage() Overrides: getmessage in class java.lang.throwable Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

104 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework Class CardRuntimeException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception All Implemented Interfaces: Direct Known Subclasses: APDUException, BioException, CardRuntimeExceptionSubclass, CryptoException, ExternalException, ISOException, PINException, ServiceException, SystemException, TLVException, TransactionException, UtilException public class CardRuntimeException extends java.lang.runtimeexception The CardRuntimeException class defines a field reason and two accessor methods getreason() and setreason(). The reason field encapsulates exception cause identifier in the Java Card API. All Java Card API unchecked Exception classes should extend CardRuntimeException. See Also: Constructor Summary

105 CardRuntimeException(short reason) Construct a CardRuntimeException instance with the specified reason. Method Summary short getreason() Get reason code void setreason(short reason) Set reason code. static void throwit(short reason) Throw an instance of the CardRuntimeException class with the specified reason. Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail CardRuntimeException public CardRuntimeException(short reason) Construct a CardRuntimeException instance with the specified reason. Parameters: reason - the reason for the exception Method Detail

106 getreason public short getreason() Get reason code Returns: the reason for the exception setreason public void setreason(short reason) Set reason code. Parameters: reason - the reason for the exception throwit public static void throwit(short reason) throws CardRuntimeException Throw an instance of the CardRuntimeException class with the specified reason. Parameters: reason - the reason for the exception Throws: CardRuntimeException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

107 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework Class CardException java.lang.object java.lang.throwable java.lang.exception javacard.framework.cardexception All Implemented Interfaces: Direct Known Subclasses: CardExceptionSubclass, UserException public class CardException extends java.lang.exception The CardException class defines a field reason and two accessor methods getreason() and setreason(). The reason field encapsulates exception cause identifier in the Java Card API. All Java Card API checked Exception classes should extend CardException. See Also: Constructor Summary CardException(short reason) Construct a CardException instance with the specified reason. Method Summary

108 short getreason() Get reason code void setreason(short reason) Set reason code. static void throwit(short reason) Throw an instance of CardException class with the specified reason. Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail CardException public CardException(short reason) Construct a CardException instance with the specified reason. Parameters: reason - the reason for the exception Method Detail getreason public short getreason() Get reason code

109 Returns: the reason for the exception setreason public void setreason(short reason) Set reason code. Parameters: reason - the reason for the exception throwit public static void throwit(short reason) throws CardException Throw an instance of CardException class with the specified reason. Parameters: reason - the reason for the exception Throws: CardException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

110 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework Class UserException java.lang.object java.lang.throwable java.lang.exception javacard.framework.cardexception javacard.framework.userexception All Implemented Interfaces: Direct Known Subclasses: UserExceptionSubclass public class UserException extends CardException UserException represents a User exception. See Also: Constructor Summary UserException() Constructs a UserException with reason = 0. UserException(short reason) Constructs a UserException with the specified reason.

111 Method Summary static void throwit(short reason) Throws an instance of UserException with the specified reason. Methods inherited from class javacard.framework.cardexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail UserException public UserException() Constructs a UserException with reason = 0. UserException public UserException(short reason) Constructs a UserException with the specified reason. Parameters: reason - the reason for the exception.

112 Method Detail throwit public static void throwit(short reason) throws UserException Throws an instance of UserException with the specified reason. Parameters: reason - the reason for the exception. Throws: UserException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

113 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework Class TransactionException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.transactionexception All Implemented Interfaces: Direct Known Subclasses: TransactionExceptionSubclass public class TransactionException extends CardRuntimeException TransactionException represents an exception in the transaction subsystem. See Also: Field Summary static short BUFFER_FULL This reason code is used during a transaction to indicate that the commit buffer is full.

114 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 Java Card runtime environment 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 an instance of TransactionException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Field Detail

115 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 Java Card runtime

116 environment problem (fatal error). See Also: Constant Field Values Constructor Detail TransactionException public TransactionException(short reason) Constructs a TransactionException with the specified reason. Method Detail throwit public static void throwit(short reason) Throws an instance of TransactionException with the specified reason. Throws: TransactionException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

117 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework Class SystemException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.systemexception All Implemented Interfaces: Direct Known Subclasses: SystemExceptionSubclass public class SystemException extends CardRuntimeException SystemException represents a JCSystem class related exception. See Also: Field Summary 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.

118 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 Summary SystemException(short reason) Constructs a SystemException. Method Summary static void throwit(short reason) Throws an instance of SystemException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object

119 clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Field Detail ILLEGAL_VALUE public static final short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is out of allowed bounds. See Also: Constant Field Values NO_TRANSIENT_SPACE public static final 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. See Also: Constant Field Values ILLEGAL_TRANSIENT public static final 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. See Java Card Runtime Environment Specification, section for details. See Also: Constant Field Values

120 ILLEGAL_AID public static final 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. See Also: Constant Field Values NO_RESOURCE public static final short NO_RESOURCE This reason code is used to indicate that there is insufficient resource in the Card for the request. For example, the virtual machine for the Java Card platform may throw this exception reason when there is insufficient heap space to create a new instance. See Also: Constant Field Values ILLEGAL_USE public static final short ILLEGAL_USE This reason code is used to indicate that the requested function is not allowed. For example, JCSystem.requestObjectDeletion() method throws this exception if the object deletion mechanism is not implemented. See Also: Constant Field Values

121 Constructor Detail SystemException public SystemException(short reason) Constructs a SystemException. Parameters: reason - the reason for the exception. Method Detail throwit public static void throwit(short reason) throws SystemException Throws an instance of SystemException with the specified reason. Parameters: reason - the reason for the exception. Throws: SystemException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

122 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework Class PINException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.pinexception All Implemented Interfaces: Direct Known Subclasses: PINExceptionSubclass public class PINException extends CardRuntimeException PINException represents a OwnerPIN class access-related exception. See Also: Field Summary static short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is out of allowed bounds.

123 Constructor Summary PINException(short reason) Constructs a PINException. Method Summary static void throwit(short reason) Throws an instance of PINException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Field Detail ILLEGAL_VALUE public static final short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is out of allowed bounds. See Also: Constant Field Values Constructor Detail

124 PINException public PINException(short reason) Constructs a PINException. To conserve on resources use throwit() to use the Java Card runtime-owned instance of this class. Parameters: reason - the reason for the exception. Method Detail throwit public static void throwit(short reason) Throws an instance of PINException with the specified reason. Parameters: reason - the reason for the exception. Throws: PINException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

125 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework Class ISOException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.isoexception All Implemented Interfaces: Direct Known Subclasses: ISOExceptionSubclass public class ISOException extends CardRuntimeException ISOException class encapsulates an ISO response status word as its reason code. See Also: Constructor Summary ISOException(short sw) Constructs an ISOException instance with the specified status word. Method Summary

126 static void throwit(short sw) Throws an instance of the ISOException class with the specified status word. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Constructor Detail ISOException public ISOException(short sw) Constructs an ISOException instance with the specified status word. Parameters: sw - the ISO defined status word Method Detail throwit public static void throwit(short sw) Throws an instance of the ISOException class with the specified status word.

127 Parameters: sw - ISO defined status word Throws: ISOException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

128 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Constant Field Values Contents com.sun.* javacard.framework.* javacard.security.* javacardx.biometry.* javacardx.external.* javacardx.framework.* com.sun.* com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory public static final byte REF_FORMAT_CLASS 1 public static final byte REF_FORMAT_INTERFACES 2 public static final byte REF_FORMAT_NONE 0 com.sun.javacard.rmiclientlib.jcrmiconnect public static final byte REF_WITH_CLASS_NAME 0 public static final byte REF_WITH_INTERFACE_NAMES 16 javacard.framework.* javacard.framework.apduexception public static final short BAD_LENGTH 3 public static final short BUFFER_BOUNDS 2

129 public static final short ILLEGAL_USE 1 public static final short IO_ERROR 4 public static final short NO_T0_GETRESPONSE 170 public static final short NO_T0_REISSUE 172 public static final short T1_IFD_ABORT 171 javacard.framework.pinexception public static final short ILLEGAL_VALUE 1 javacard.framework.systemexception public static final short ILLEGAL_AID 4 public static final short ILLEGAL_TRANSIENT 3 public static final short ILLEGAL_USE 6 public static final short ILLEGAL_VALUE 1 public static final short NO_RESOURCE 5 public static final short NO_TRANSIENT_SPACE 2 javacard.framework.transactionexception public static final short BUFFER_FULL 3 public static final short IN_PROGRESS 1 public static final short INTERNAL_FAILURE 4 public static final short NOT_IN_PROGRESS 2 javacard.framework.service.serviceexception public static final short CANNOT_ACCESS_IN_COMMAND 4 public static final short CANNOT_ACCESS_OUT_COMMAND 5 public static final short COMMAND_DATA_TOO_LONG 3

130 public static final short COMMAND_IS_FINISHED 6 public static final short DISPATCH_TABLE_FULL 2 public static final short ILLEGAL_PARAM 1 public static final short REMOTE_OBJECT_NOT_EXPORTED 7 javacard.security.* javacard.security.cryptoexception public static final short ILLEGAL_USE 5 public static final short ILLEGAL_VALUE 1 public static final short INVALID_INIT 4 public static final short NO_SUCH_ALGORITHM 3 public static final short UNINITIALIZED_KEY 2 javacardx.biometry.* javacardx.biometry.bioexception public static final short ILLEGAL_USE 5 public static final short ILLEGAL_VALUE 1 public static final short INVALID_DATA 2 public static final short NO_SUCH_BIO_TEMPLATE 3 public static final short NO_TEMPLATES_ENROLLED 4 javacardx.external.* javacardx.external.externalexception public static final short INTERNAL_ERROR 3

131 public static final short INVALID_PARAM 2 public static final short NO_SUCH_SUBSYSTEM 1 javacardx.framework.* javacardx.framework.tlv.tlvexception public static final short EMPTY_TAG 3 public static final short EMPTY_TLV 4 public static final short ILLEGAL_SIZE 2 public static final short INSUFFICIENT_STORAGE 7 public static final short INVALID_PARAM 1 public static final short MALFORMED_TAG 5 public static final short MALFORMED_TLV 6 public static final short TAG_NUMBER_GREATER_THAN_ public static final short TAG_SIZE_GREATER_THAN_127 8 public static final short TLV_LENGTH_GREATER_THAN_ public static final short TLV_SIZE_GREATER_THAN_ javacardx.framework.util.utilexception public static final short ILLEGAL_VALUE 1 public static final short TYPE_MISMATCHED 2 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

132 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.rmiclientlib Class JCRMIConnect java.lang.object com.sun.javacard.rmiclientlib.jcrmiconnect public class JCRMIConnect extends java.lang.object The main class of the Java Card RMI client API. Provides functionality to select a card applet and to obtain an initial reference. Field Summary protected byte format Format of the remote references. static byte REF_WITH_CLASS_NAME Constant used as the 2nd parameter to selectapplet method. static byte REF_WITH_INTERFACE_NAMES Constant used as the 2nd parameter to selectapplet method. protected byte[] selectresponse Response to the SELECT command is stored in this field. Constructor Summary JCRMIConnect(CardAccessor ca) Creates a new instance of JCRMIConnect

133 Method Summary java. rmi. Remote byte [] getinitialreference() Parses the R-APDU which was returned during selecting an applet, returns a reference to an initial remote object selectapplet(byte[] aid, byte format) Selects an applet, requesting initial reference in the format specified by the 2nd parameter. Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait Field Detail selectresponse protected byte[] selectresponse Response to the SELECT command is stored in this field. format protected byte format Format of the remote references. REF_WITH_CLASS_NAME public static final byte REF_WITH_CLASS_NAME Constant used as the 2nd parameter to selectapplet method.

134 See Also: Constant Field Values REF_WITH_INTERFACE_NAMES public static final byte REF_WITH_INTERFACE_NAMES Constant used as the 2nd parameter to selectapplet method. See Also: Constant Field Values Constructor Detail JCRMIConnect public JCRMIConnect(CardAccessor ca) Creates a new instance of JCRMIConnect Parameters: ca - Implementaion of a CardAccessor Method Detail getinitialreference public java.rmi.remote getinitialreference() throws java.lang.exception Parses the R-APDU which was returned during selecting an applet, returns a reference to an initial remote object Returns: Stub or proxy for the initial remote object Throws:

135 java.lang.exception - If a problem occured selectapplet public byte[] selectapplet(byte[] aid, byte format) throws java.lang.exception Selects an applet, requesting initial reference in the format specified by the 2nd parameter. The R-APDU is returned and also stored internally for further processing by the getinitialreference () method. Parameters: aid - AID of the applet to be selected format - Format of the remote references Returns: R-APDU Throws: java.lang.exception - If a problem occured Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

136 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.rmiclientlib Class JCRemoteRefImpl java.lang.object com.sun.javacard.rmiclientlib.jcremoterefimpl All Implemented Interfaces: java.io.externalizable, java.lang.reflect.invocationhandler, java.rmi.server.remoteref public class JCRemoteRefImpl extends java.lang.object implements java.rmi.server.remoteref, java.lang.reflect.invocationhandler Represents a reference to a card object. This class is a Java Card RMI implementation of the RemoteRef interface. It is used in conjunction with Java RMIC generated stubs or dynamically generated proxies for Java Card RMI method invocations. See Also: Field Summary Fields inherited from interface java.rmi.server.remoteref packageprefix Constructor Summary

137 JCRemoteRefImpl(short objid, java.lang.string a_string, CardAccessor ca, CardObjectFactory cof) Creates new JCRemoteRefImpl Method Summary void done(java.rmi.server.remotecall remotecall) Deprecated. java. lang. String java. lang. Object getrefclass(java.io.objectoutput objectoutput) Unsupported operation. invoke(java.lang.object obj, java.lang.reflect. Method method, java.lang.object[] params) This method is used by dynamically generated proxies. void invoke(java.rmi.server.remotecall remotecall) Deprecated. java. lang. Object java.rmi. server. RemoteCall invoke(java.rmi.remote remote, java.lang.reflect. Method method, java.lang.object[] params, long unused) This method is used by rmic-generated stubs. newcall(java.rmi.server.remoteobject remoteobject, java. rmi.server.operation[] operation, int param, long param3) Deprecated. void readexternal(java.io.objectinput objectinput) Unsupported operation. boolean remoteequals(java.rmi.server.remoteref remoteref) Compares two remote objects for being identical. int remotehashcode() Unsupported operation. java. lang. String remotetostring() String representation of remote object. void writeexternal(java.io.objectoutput objectoutput) Unsupported operation. Methods inherited from class java.lang.object

138 clone, equals, finalize, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait Constructor Detail JCRemoteRefImpl public JCRemoteRefImpl(short objid, java.lang.string a_string, CardAccessor ca, CardObjectFactory cof) Creates new JCRemoteRefImpl Parameters: objid - 2 byte Object ID from card remote reference descriptor a_string - Anticollision string for the class of the remote object ca - CardAccessor cof - CardObjectFactory Method Detail getrefclass public java.lang.string getrefclass(java.io. ObjectOutput objectoutput) Unsupported operation. Specified by: getrefclass in interface java.rmi.server.remoteref Parameters: objectoutput - invoke

139 public java.lang.object invoke(java.rmi.remote remote, java.lang.reflect.method method, java.lang.object[] params, long unused) throws java.io.ioexception, java.rmi.remoteexception, java.lang.exception This method is used by rmic-generated stubs. Specified by: invoke in interface java.rmi.server.remoteref Parameters: remote - Reference to the stub - not used. method - java.reflect.method object containing information about the method to be invoked. params - Array of parameters. Primitives are wrapped. unused - rmic-generated hash of the method. Not used. Returns: The result returned from the card. Throws: java.io.ioexception - If a communication error occured. java.rmi.remoteexception - If an RMI error occured. java.lang.exception - Exception corresponding to the one that was thrown on the card. remotehashcode public int remotehashcode() Unsupported operation. Specified by: remotehashcode in interface java.rmi.server.remoteref Returns: A number which is the same for all objects.

140 remotetostring public java.lang.string remotetostring() String representation of remote object. Specified by: remotetostring in interface java.rmi.server.remoteref Returns: A String representation of the remote object. readexternal public void readexternal(java.io.objectinput objectinput) throws java.io.ioexception, java.lang.classnotfoundexception Unsupported operation. Specified by: readexternal in interface java.io.externalizable Parameters: objectinput - Throws: java.io.ioexception java.lang.classnotfoundexception writeexternal public void writeexternal(java.io.objectoutput objectoutput) throws java.io.ioexception Unsupported operation. Specified by: writeexternal in interface java.io.externalizable Parameters:

141 objectoutput - Throws: java.io.ioexception newcall public java.rmi.server.remotecall newcall(java.rmi.server. RemoteObject remoteobject, java.rmi.server.operation [] operation, int param, long param3) throws java.rmi.remoteexception Deprecated. Deprecated and not implemented Specified by: newcall in interface java.rmi.server.remoteref Parameters: remoteobject - operation - param - param3 - Throws: java.rmi.remoteexception invoke public void invoke(java.rmi.server.remotecall remotecall) throws java.lang.exception Deprecated. Deprecated and not implemented

142 Specified by: invoke in interface java.rmi.server.remoteref Parameters: remotecall - Throws: java.lang.exception remoteequals public boolean remoteequals(java.rmi.server.remoteref remoteref) Compares two remote objects for being identical. Specified by: remoteequals in interface java.rmi.server.remoteref Parameters: remoteref - RemoteRef to the other remote object. Returns: true if corresponding remote objects are identical. done public void done(java.rmi.server.remotecall remotecall) throws java.rmi.remoteexception Deprecated. Deprecated and not implemented Specified by: done in interface java.rmi.server.remoteref Parameters: remotecall - Throws: java.rmi.remoteexception

143 invoke public java.lang.object invoke(java.lang.object obj, java.lang.reflect.method method, java.lang.object[] params) throws java.io.ioexception, java.rmi.remoteexception, java.lang.throwable This method is used by dynamically generated proxies. Specified by: invoke in interface java.lang.reflect.invocationhandler Parameters: obj - The reference to the Proxy - not used. method - Method object containing information about the method. params - Array of parameters for the method. Returns: The result returned from the card. Throws: java.io.ioexception - If a communication error occured. java.rmi.remoteexception - If an RMI error occured. java.lang.throwable - Exception corresponding to the one that was thrown on the card. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

144 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.rmiclientlib Class JCCardProxyFactory java.lang.object com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory com.sun.javacard.rmiclientlib.jccardproxyfactory public class JCCardProxyFactory extends CardObjectFactory Processes the data returned from the card in the format defined for Java Card RMI. Object references must contain lists of interface names. Extends CardObjectFactory. Field Summary Fields inherited from class com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory REF_FORMAT_CLASS, REF_FORMAT_INTERFACES, REF_FORMAT_NONE Constructor Summary JCCardProxyFactory() Constructor for the factory. Method Summary

145 protected java.rmi. Remote getremoteobject(byte[] buffer, int tagoffset, CardAccessor cardaccessor) Creates the stub instance for object reference returned from the card, assuming the card returned a reference with list of interface names. byte getremoterefformat() Returns constant REF_FORMAT_INTERFACES defined in class CardObjectFactory. Methods inherited from class com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory getinsbyte, getobject, setinsbyte Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait Constructor Detail JCCardProxyFactory public JCCardProxyFactory() Constructor for the factory. Method Detail getremoterefformat public byte getremoterefformat() Returns constant REF_FORMAT_INTERFACES defined in class CardObjectFactory. Specified by: getremoterefformat in class CardObjectFactory Returns:

146 The format constant. getremoteobject protected java.rmi.remote getremoteobject(byte[] buffer, int tagoffset, CardAccessor cardaccessor) throws java.lang.exception Creates the stub instance for object reference returned from the card, assuming the card returned a reference with list of interface names. Specified by: getremoteobject in class CardObjectFactory Parameters: cardaccessor - buffer - APDU buffer. tagoffset - Offset to tag. Returns: The instance of the proxy. Throws: java.lang.exception - Thrown if the proxy instance cannot be instantiated Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

147 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.rmiclientlib Class JCCardObjectFactory java.lang.object com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory com.sun.javacard.rmiclientlib.jccardobjectfactory public class JCCardObjectFactory extends CardObjectFactory Processes the data returned from the card in the format defined for Java Card RMI. Object references must contain class names. Extends CardObjectFactory. Field Summary Fields inherited from class com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory REF_FORMAT_CLASS, REF_FORMAT_INTERFACES, REF_FORMAT_NONE Constructor Summary JCCardObjectFactory() The constructor. Method Summary

148 protected java.rmi. Remote getremoteobject(byte[] buffer, int tagoffset, CardAccessor cardaccessor) Creates the stub instance for object reference returned from the card, assuming the card returned a reference with class name. byte getremoterefformat() Returns constant REF_FORMAT_CLASS defined in class CardObjectFactory. Methods inherited from class com.sun.javacard.javax.smartcard.rmiclient.cardobjectfactory getinsbyte, getobject, setinsbyte Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait Constructor Detail JCCardObjectFactory public JCCardObjectFactory() The constructor. Method Detail getremoteobject protected java.rmi.remote getremoteobject(byte[] buffer, int tagoffset, CardAccessor cardaccessor) throws java.lang.exception Creates the stub instance for object reference returned from the card, assuming the card returned a reference with class name.

149 Specified by: getremoteobject in class CardObjectFactory Parameters: cardaccessor - used to instantiate stubs of remote objects buffer - APDU buffer tagoffset - Offset to tag Returns: The resulting stub. Throws: java.lang.exception - Failed to instantiate a stub getremoterefformat public byte getremoterefformat() Returns constant REF_FORMAT_CLASS defined in class CardObjectFactory. Specified by: getremoterefformat in class CardObjectFactory Returns: REF_FORMAT_CLASS value defined above Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

150 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.clientlib Interface CardAccessor All Known Implementing Classes: ApduIOCardAccessor public interface CardAccessor The CardAccessor interface represents a generic smartcard communication API. The interface based definition makes it platform and framework independent. This interface is used by Java Card RMI stubs to access the smart card. Method Summary void closecard() This method closes and resets the card byte [] exchangeapdu(byte[] senddata) This method sends the specified data to the smartcard, waits for the response and returns the response in the return data. Method Detail exchangeapdu byte[] exchangeapdu(byte[] senddata) throws java.io.ioexception This method sends the specified data to the smartcard, waits for the response and returns the

151 response in the return data. The input data is assumed to be formatted for ISO APDU communication as follows : [0] = CLA, [1]= INS, [2] = P1, [3]= P2, [4]=Lc, [4..]= command data. The response data is formatted for ISO APDU communication as follows : [0] = SW1, [1]= SW2, [2..]= response data. Parameters: senddata - the ISO formatted command APDU data with 5 bytes of header followed by the command data. Returns: responsedata contains the response received from card with the 2 status bytes followed by the response data. Throws: java.io.ioexception - if communication error occurs closecard void closecard() throws java.lang.exception This method closes and resets the card Throws: java.lang.exception - Exception with a message about the problem. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

152 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD com.sun.javacard.clientlib Class ApduIOCardAccessor java.lang.object com.sun.javacard.clientlib.apduiocardaccessor All Implemented Interfaces: CardAccessor public class ApduIOCardAccessor extends java.lang.object implements CardAccessor Implementation of CardAccessor using ApduIO library Field Summary protected com. sun.javacard. apduio. CadClientInterface cad Reference to underlying ApduIO object. Constructor Summary ApduIOCardAccessor() Creates a new instance of ApduIOCardAccessor Method Summary

153 void closecard() Close and powerdown the card. byte [] exchangeapdu(byte[] capdu) Implementation of exchangeapdu method of CardAccessor interface Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, tostring, wait, wait, wait Field Detail cad protected com.sun.javacard.apduio.cadclientinterface cad Reference to underlying ApduIO object. Constructor Detail ApduIOCardAccessor public ApduIOCardAccessor() throws java.lang.exception Creates a new instance of ApduIOCardAccessor Throws: java.lang.exception - Thrown is config file jcclient.properties is not found in classpath or communication error happened. Method Detail exchangeapdu public byte[] exchangeapdu(byte[] capdu)

154 throws java.io.ioexception Implementation of exchangeapdu method of CardAccessor interface Specified by: exchangeapdu in interface CardAccessor Parameters: capdu - byte array containing C-APDU Returns: R-APDU in the format described in the javadoc for CardAccessor Throws: java.io.ioexception - In case of I/O error closecard public void closecard() throws java.lang.exception Close and powerdown the card. Specified by: closecard in interface CardAccessor Throws: java.lang.exception - Thrown if a problem occured Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

155 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.framework.service Class ServiceException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.service.serviceexception All Implemented Interfaces: Direct Known Subclasses: ServiceExceptionSubclass public class ServiceException extends CardRuntimeException ServiceException represents a service framework related exception. See Also: Field Summary static short CANNOT_ACCESS_IN_COMMAND This reason code is used to indicate that the command in the APDU object cannot be accessed for input processing.

156 static short CANNOT_ACCESS_OUT_COMMAND This reason code is used to indicate that the command in the APDU object cannot be accessed for output processing. static short COMMAND_DATA_TOO_LONG This reason code is used to indicate that the incoming data for a command in the APDU object does not fit in the APDU buffer. static short COMMAND_IS_FINISHED This reason code is used to indicate that the command in the APDU object has been completely processed. static short DISPATCH_TABLE_FULL This reason code is used to indicate that a dispatch table is full static short ILLEGAL_PARAM This reason code is used to indicate that an input parameter is not allowed. static short REMOTE_OBJECT_NOT_EXPORTED This reason code is used by RMIService to indicate that the remote method returned an remote object which has not been exported. Constructor Summary ServiceException(short reason) Constructs a ServiceException. Method Summary static void throwit(short reason) Throws an instance of ServiceException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring

157 Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Field Detail ILLEGAL_PARAM public static final short ILLEGAL_PARAM This reason code is used to indicate that an input parameter is not allowed. See Also: Constant Field Values DISPATCH_TABLE_FULL public static final short DISPATCH_TABLE_FULL This reason code is used to indicate that a dispatch table is full See Also: Constant Field Values COMMAND_DATA_TOO_LONG public static final short COMMAND_DATA_TOO_LONG This reason code is used to indicate that the incoming data for a command in the APDU object does not fit in the APDU buffer. See Also: Constant Field Values

158 CANNOT_ACCESS_IN_COMMAND public static final short CANNOT_ACCESS_IN_COMMAND This reason code is used to indicate that the command in the APDU object cannot be accessed for input processing. See Also: Constant Field Values CANNOT_ACCESS_OUT_COMMAND public static final short CANNOT_ACCESS_OUT_COMMAND This reason code is used to indicate that the command in the APDU object cannot be accessed for output processing. See Also: Constant Field Values COMMAND_IS_FINISHED public static final short COMMAND_IS_FINISHED This reason code is used to indicate that the command in the APDU object has been completely processed. See Also: Constant Field Values REMOTE_OBJECT_NOT_EXPORTED

159 public static final short REMOTE_OBJECT_NOT_EXPORTED This reason code is used by RMIService to indicate that the remote method returned an remote object which has not been exported. See Also: Constant Field Values Constructor Detail ServiceException public ServiceException(short reason) Constructs a ServiceException. Parameters: reason - the reason for the exception. Method Detail throwit public static void throwit(short reason) throws ServiceException Throws an instance of ServiceException with the specified reason. Parameters: reason - the reason for the exception. Throws: ServiceException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

160

161 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package javacard.framework.service Provides Java Card API exceptions that may be re-thrown on the client. See: Description Exception Summary ServiceException ServiceException represents a service framework related exception. Package javacard.framework.service Description Provides Java Card API exceptions that may be re-thrown on the client. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

162 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Hierarchy For Package javacard.framework.service Package Hierarchies: All Packages Class Hierarchy java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.framework.service.serviceexception Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

163 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Package Hierarchies: All Packages Hierarchy For Package javacard.security Class Hierarchy java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.security.cryptoexception Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

164 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package javacard.security Provides Java Card API exceptions that may be re-thrown on the client. See: Description Exception Summary CryptoException CryptoException represents a cryptography-related exception. Package javacard.security Description Provides Java Card platform exceptions that may be re-thrown on the client. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

165 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package javacardx.biometry Provides Java Card API exceptions that may be re-thrown on the client. See: Description Exception Summary BioException The BioException class encapsulates specific exceptions which can be thrown by the methods of the javacardx.biometry package in case of error. Package javacardx.biometry Description Extension package that contains functionality for implementing a biometric framework on the Java Card platform. The platform must support this optional package only if biometry support is included in the implementation. The javacardx.biometry package contains classes and interfaces which can be used to build a biometric server application. These classes also enable a client application on the card to obtain biometric services from the biometric server application. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

166 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Package Hierarchies: All Packages Hierarchy For Package javacardx.biometry Class Hierarchy java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.biometry.bioexception Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

167 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Package Hierarchies: All Packages Hierarchy For Package javacardx.external Class Hierarchy java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.external.externalexception Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

168 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package javacardx.external Provides Java Card API exceptions that may be re-thrown on the client. See: Description Exception Summary ExternalException ExternalException represents an external subsystem related exception. Package javacardx.external Description Extension package that provides mechanisms to access memory subsystems which are not directly addressable by the Java Card runtime environment (Java Card RE) on the Java Card platform. The platform must support this optional package if an external memory access feature is included in the implementation. The javacardx.external package contains the Memory class and the MemoryAccess interface. The Memory class provides a factory method for creating an instance of the MemoryAccess interface suitable for accessing supported memory subsystems. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

169 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package javacardx.framework.tlv Provides Java Card API exceptions that may be re-thrown on the client. See: Description Exception Summary TLVException TLVException represents a TLV-related exception. Package javacardx.framework.tlv Description Extension package that contains functionality, for managing storage for BER TLV formatted data, based on the ASN.1 BER encoding rules of ISO/IEC :2002, as well as parsing and editing BER TLV formatted data in I/O buffers. The javacardx.framework.tlv package contains the BERTag abstract class, and its concrete subclasses PrimitiveBERTag and ConstructedBERTag. These classes encapsulate the BER tag functionality. The javacardx.framework.tlv package also contains the BERTLV abstract class, and its concrete subclasses PrimitiveBERTLV and ConstructedBERTLV. These classes encapsulate the BER TLV functionality. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

170 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Package Hierarchies: All Packages Hierarchy For Package javacardx.framework.tlv Class Hierarchy java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.framework.tlv.tlvexception Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

171 Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes Package Hierarchies: All Packages Hierarchy For Package javacardx.framework.util Class Hierarchy java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.framework.util.utilexception Overview Package Class Tree Deprecated Index Help PREV NEXT FRAMES NO FRAMES All Classes

172 Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes Package javacardx.framework.util Provides Java Card API exceptions that may be re-thrown on the client. See: Description Exception Summary UtilException UtilException represents a util related exception. Package javacardx.framework.util Description Extension package that contains common utility functions for manipulating arrays of primitive components - byte, short or int. If the int primitive type is supported by the platform, the intx sub-package must be included. The javacardx.framework.util package contains the ArrayLogic class. The ArrayLogic class provides methods for functionality similar to that of the javacard. framework.util class but with generic Object component equivalents. Overview Package Class Tree Deprecated Index Help PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES All Classes

173 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacardx.framework.util Class UtilException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.framework.util.utilexception All Implemented Interfaces: Direct Known Subclasses: UtilExceptionSubclass public class UtilException extends CardRuntimeException UtilException represents a util related exception. The API classes throw Java Card runtime environment-owned instances of UtilException. 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, instance variables, or array components. See Also:

174 Field Summary static short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is not the correct type or is out of allowed bounds. static short TYPE_MISMATCHED This reason code is used to indicate that input parameters are not the same type. Constructor Summary UtilException(short reason) Constructs a UtilException with the specified reason. Method Summary static void throwit(short reason) Throws the Java Card runtime environment-owned instance of UtilException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Field Detail ILLEGAL_VALUE

175 public static final short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is not the correct type or is out of allowed bounds. See Also: Constant Field Values TYPE_MISMATCHED public static final short TYPE_MISMATCHED This reason code is used to indicate that input parameters are not the same type. See Also: Constant Field Values Constructor Detail UtilException public UtilException(short reason) Constructs a UtilException 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 Detail throwit public static void throwit(short reason)

176 Throws the Java Card runtime environment-owned instance of UtilException 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 for the Java Card Platform, section for details. Parameters: reason - the reason for the exception Throws: UtilException - always Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

177 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacardx.framework.tlv Class TLVException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.framework.tlv.tlvexception All Implemented Interfaces: Direct Known Subclasses: TLVExceptionSubclass public class TLVException extends CardRuntimeException TLVException represents a TLV-related exception. The API classes throw Java Card runtime environment-owned instances of TLVException. 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, instance variables, or array components. See Also:

178 Field Summary static short EMPTY_TAG This reason code is used to indicate that the Tag object is empty static short EMPTY_TLV This reason code is used to indicate that the TLV object is empty static short ILLEGAL_SIZE This reason code is used to indicate that the size of a TLV or Tag representation in the input parameter is greater than the supported size or will result in in a TLV struture of greater than supported size static short INSUFFICIENT_STORAGE This reason code is used to indicate that the configured storage capacity of the object will be exceeded static short INVALID_PARAM This reason code is used to indicate that one or more input parameters is invalid. static short MALFORMED_TAG This reason code is used to indicate that the tag representation is not a wellformed BER Tag static short MALFORMED_TLV This reason code is used to indicate that the TLV representation is not a wellformed BER TLV static short TAG_NUMBER_GREATER_THAN_32767 This reason code is used to indicate that the tag number value greater than static short TAG_SIZE_GREATER_THAN_127 This reason code is used to indicate that the size of the tag representation is greater than 127 bytes static short TLV_LENGTH_GREATER_THAN_32767 This reason code is used to indicate that the Length component value in the TLV is greater than static short TLV_SIZE_GREATER_THAN_32767 This reason code is used to indicate that the TLV requires more that bytes to represent

179 Constructor Summary TLVException(short reason) Constructs a TLVException with the specified reason. Method Summary static void throwit(short reason) Throws the Java Card runtime environment-owned instance of TLVException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait Field Detail INVALID_PARAM public static final short INVALID_PARAM This reason code is used to indicate that one or more input parameters is invalid. See Also: Constant Field Values

180 ILLEGAL_SIZE public static final short ILLEGAL_SIZE This reason code is used to indicate that the size of a TLV or Tag representation in the input parameter is greater than the supported size or will result in in a TLV struture of greater than supported size See Also: Constant Field Values EMPTY_TAG public static final short EMPTY_TAG This reason code is used to indicate that the Tag object is empty See Also: Constant Field Values EMPTY_TLV public static final short EMPTY_TLV This reason code is used to indicate that the TLV object is empty See Also: Constant Field Values MALFORMED_TAG public static final short MALFORMED_TAG

181 This reason code is used to indicate that the tag representation is not a well-formed BER Tag See Also: Constant Field Values MALFORMED_TLV public static final short MALFORMED_TLV This reason code is used to indicate that the TLV representation is not a well-formed BER TLV See Also: Constant Field Values INSUFFICIENT_STORAGE public static final short INSUFFICIENT_STORAGE This reason code is used to indicate that the configured storage capacity of the object will be exceeded See Also: Constant Field Values TAG_SIZE_GREATER_THAN_127 public static final short TAG_SIZE_GREATER_THAN_127 This reason code is used to indicate that the size of the tag representation is greater than 127 bytes See Also: Constant Field Values

182 TAG_NUMBER_GREATER_THAN_32767 public static final short TAG_NUMBER_GREATER_THAN_32767 This reason code is used to indicate that the tag number value greater than See Also: Constant Field Values TLV_SIZE_GREATER_THAN_32767 public static final short TLV_SIZE_GREATER_THAN_32767 This reason code is used to indicate that the TLV requires more that bytes to represent See Also: Constant Field Values TLV_LENGTH_GREATER_THAN_32767 public static final short TLV_LENGTH_GREATER_THAN_32767 This reason code is used to indicate that the Length component value in the TLV is greater than See Also: Constant Field Values Constructor Detail TLVException public TLVException(short reason)

183 Constructs a TLVException 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 Detail throwit public static void throwit(short reason) Throws the Java Card runtime environment-owned instance of TLVException 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 for the Java Card Platform, section for details. Parameters: reason - the reason for the exception Throws: TLVException - always Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

184 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacardx.external Class ExternalException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.external.externalexception All Implemented Interfaces: Direct Known Subclasses: ExternalExceptionSubclass public class ExternalException extends CardRuntimeException ExternalException represents an external subsystem related exception. The API classes throw Java Card runtime environment-owned instances of ExternalException. 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. Since: See Also:

185 Field Summary static short INTERNAL_ERROR This reason code is used to indicate that an unrecoverable external access error occurred. static short INVALID_PARAM This reason code is used to indicate that an input parameter is invalid. static short NO_SUCH_SUBSYSTEM This reason code is used to indicate that specified external subsystem is not available. Constructor Summary ExternalException(short reason) Constructs a ExternalException with the specified reason. Method Summary static void throwit(short reason) Throws the Java Card runtime environment-owned instance of ExternalException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait

186 Field Detail NO_SUCH_SUBSYSTEM public static final short NO_SUCH_SUBSYSTEM This reason code is used to indicate that specified external subsystem is not available. See Also: Constant Field Values INVALID_PARAM public static final short INVALID_PARAM This reason code is used to indicate that an input parameter is invalid. See Also: Constant Field Values INTERNAL_ERROR public static final short INTERNAL_ERROR This reason code is used to indicate that an unrecoverable external access error occurred. See Also: Constant Field Values Constructor Detail ExternalException public ExternalException(short reason)

187 Constructs a ExternalException 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 Detail throwit public static void throwit(short reason) Throws the Java Card runtime environment-owned instance of ExternalException 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 for the Java Card Platform, section for details. Parameters: reason - the reason for the exception Throws: ExternalException - always Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

188 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacardx.biometry Class BioException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacardx.biometry.bioexception All Implemented Interfaces: Direct Known Subclasses: BioExceptionSubclass public class BioException extends CardRuntimeException The BioException class encapsulates specific exceptions which can be thrown by the methods of the javacardx.biometry package in case of error. See Also: Field Summary static short ILLEGAL_USE This reason code is used to indicate that the method should not be invoked based on the current state of the card.

189 static short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is out of allowed bounds. static short INVALID_DATA This reason code is used to indicate that the data the system encountered is illegible. static short NO_SUCH_BIO_TEMPLATE This reason code is used to indicate that the provided bio template type is not supported by the template builder. static short NO_TEMPLATES_ENROLLED This reason code is used to indicate that no reference template is available for matching, or that the reference template is uninitialized. Constructor Summary BioException(short reason) Construct a new biometric exception using a provided reason code. Method Summary static void throwit(short reason) Throws the Java Card runtime environment owned instance of BioException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait

190 Field Detail ILLEGAL_VALUE public static final short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is out of allowed bounds. See Also: Constant Field Values INVALID_DATA public static final short INVALID_DATA This reason code is used to indicate that the data the system encountered is illegible. See Also: Constant Field Values NO_SUCH_BIO_TEMPLATE public static final short NO_SUCH_BIO_TEMPLATE This reason code is used to indicate that the provided bio template type is not supported by the template builder. See Also: Constant Field Values NO_TEMPLATES_ENROLLED

191 public static final short NO_TEMPLATES_ENROLLED This reason code is used to indicate that no reference template is available for matching, or that the reference template is uninitialized. See Also: Constant Field Values ILLEGAL_USE public static final short ILLEGAL_USE This reason code is used to indicate that the method should not be invoked based on the current state of the card. See Also: Constant Field Values Constructor Detail BioException public BioException(short reason) Construct a new biometric exception using a provided reason code. To conserve on resources use throwit() to use the Java Card runtime environment instance of this class. Parameters: reason - the reason code for this exception. Method Detail throwit public static void throwit(short reason) throws BioException

192 Throws the Java Card runtime environment owned instance of BioException 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 objects cannot be stored in class variables or instance variables or array components. Parameters: reason - the reason for the exception. Throws: BioException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

193 Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD javacard.security Class CryptoException java.lang.object java.lang.throwable java.lang.exception java.lang.runtimeexception javacard.framework.cardruntimeexception javacard.security.cryptoexception All Implemented Interfaces: Direct Known Subclasses: CryptoExceptionSubclass public class CryptoException extends CardRuntimeException CryptoException represents a cryptography-related exception. See Also: Field Summary static short ILLEGAL_USE This reason code is used to indicate that the signature or cipher algorithm does not pad the incoming message and the input message is not block aligned.

194 static short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is out of allowed bounds. static short INVALID_INIT This reason code is used to indicate that the signature or cipher object has not been correctly initialized for the requested operation. static short NO_SUCH_ALGORITHM This reason code is used to indicate that the requested algorithm or key type is not supported. static short UNINITIALIZED_KEY This reason code is used to indicate that the key is uninitialized. Constructor Summary CryptoException(short reason) Constructs a CryptoException with the specified reason. Method Summary static void throwit(short reason) Throws an instance of CryptoException with the specified reason. Methods inherited from class javacard.framework.cardruntimeexception getreason, setreason Methods inherited from class java.lang.throwable fillinstacktrace, getcause, getlocalizedmessage, getmessage, getstacktrace, initcause, printstacktrace, printstacktrace, printstacktrace, setstacktrace, tostring Methods inherited from class java.lang.object clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait

195 Field Detail ILLEGAL_VALUE public static final short ILLEGAL_VALUE This reason code is used to indicate that one or more input parameters is out of allowed bounds. See Also: Constant Field Values UNINITIALIZED_KEY public static final short UNINITIALIZED_KEY This reason code is used to indicate that the key is uninitialized. See Also: Constant Field Values NO_SUCH_ALGORITHM public static final short NO_SUCH_ALGORITHM This reason code is used to indicate that the requested algorithm or key type is not supported. See Also: Constant Field Values INVALID_INIT public static final short INVALID_INIT

196 This reason code is used to indicate that the signature or cipher object has not been correctly initialized for the requested operation. See Also: Constant Field Values ILLEGAL_USE public static final short ILLEGAL_USE This reason code is used to indicate that the signature or cipher algorithm does not pad the incoming message and the input message is not block aligned. See Also: Constant Field Values Constructor Detail CryptoException public CryptoException(short reason) Constructs a CryptoException with the specified reason. To conserve on resources use throwit() to use the JCRE owned instance of this class. Parameters: reason - the reason for the exception. Method Detail throwit public static void throwit(short reason) Throws an instance of CryptoException with the specified reason.

197 Parameters: reason - the reason for the exception. Throws: CryptoException - always. Overview Package Class Tree Deprecated Index Help PREV CLASS NEXT CLASS FRAMES NO FRAMES All Classes SUMMARY: NESTED FIELD CONSTR METHOD DETAIL: FIELD CONSTR METHOD

198 com.sun.javacard.clientlib Interfaces CardAccessor Classes ApduIOCardAccessor

199 com.sun.javacard.javax.smartcard.rmiclient Classes CardObjectFactory Exceptions APDUExceptionSubclass BioExceptionSubclass CardExceptionSubclass CardRuntimeExceptionSubclass CryptoExceptionSubclass ExternalExceptionSubclass ISOExceptionSubclass PINExceptionSubclass ServiceExceptionSubclass SystemExceptionSubclass TLVExceptionSubclass TransactionExceptionSubclass UserExceptionSubclass UtilExceptionSubclass

200 com.sun.javacard.rmiclientlib Classes JCCardObjectFactory JCCardProxyFactory JCRemoteRefImpl JCRMIConnect

201 javacard.framework Exceptions APDUException CardException CardRuntimeException ISOException PINException SystemException TransactionException UserException

202 javacard.framework.service Exceptions ServiceException

203 javacard.security Exceptions CryptoException

204 javacardx.biometry Exceptions BioException

205 javacardx.external Exceptions ExternalException

206 javacardx.framework.tlv Exceptions TLVException

207 javacardx.framework.util Exceptions UtilException