com.licel.jcardsim.io

Interface JavaCardInterface

All Superinterfaces:

CardInterface

All Known Implementing Classes:

CardSimulator, JavaCardRemoteClient, JavaxSmartCardInterface, Simulator

public interface JavaCardInterface
extends CardInterface

Interface with JavaCard-specific functions.

Method Summary

Modifier and Type	Method and Description
void	changeProtocol(String protocol) Switch protocol Supported protocols are: T=0 (alias: *) T=1 T=CL, TYPE_A, T0 (alias: T=CL) T=CL, TYPE_A, T1 T=CL, TYPE_B, T0 T=CL, TYPE_B, T1
javacard.framework.AID	createApplet(javacard.framework.AID aid, byte[] bArray, short bOffset, byte bLength) Create Applet instance in Simulator
String	getProtocol()
javacard.framework.AID	installApplet(javacard.framework.AID aid, String appletClassName, byte[] appletJarContents, byte[] bArray, short bOffset, byte bLength) Install Applet into Simulator.
javacard.framework.AID	installApplet(javacard.framework.AID aid, String appletClassName, byte[] bArray, short bOffset, byte bLength) Install Applet into Simulator.
javacard.framework.AID	loadApplet(javacard.framework.AID aid, String appletClassName) Load Applet into Simulator
javacard.framework.AID	loadApplet(javacard.framework.AID aid, String appletClassName, byte[] appletJarContents) Load Applet into Simulator
boolean	selectApplet(javacard.framework.AID aid) Select applet by it's AID It's method must be called before start working with applet instance
byte[]	selectAppletWithResult(javacard.framework.AID aid) Select applet by it's AID It's method must be called before start working with applet instance

Methods inherited from interface com.licel.jcardsim.io.CardInterface

getATR, reset, transmitCommand

Method Detail

loadApplet

javacard.framework.AID loadApplet(javacard.framework.AID aid,
                                  String appletClassName,
                                  byte[] appletJarContents)
                           throws javacard.framework.SystemException

Load Applet into Simulator

Parameters:

aid - applet aid

appletClassName - fully qualified applet class name Strin

appletJarContents - contains a byte array containing a jar file with an applet and its dependent classes

Returns:

applet AID

Throws:

javacard.framework.SystemException - if appletClass not instanceof javacard.framework.Applet

loadApplet

javacard.framework.AID loadApplet(javacard.framework.AID aid,
                                  String appletClassName)

Load Applet into Simulator

Parameters:

aid - applet aid

appletClassName - fully qualified applet class name String

Returns:

applet AID

Throws:

javacard.framework.SystemException - if appletClass not instanceof javacard.framework.Applet

createApplet

javacard.framework.AID createApplet(javacard.framework.AID aid,
                                    byte[] bArray,
                                    short bOffset,
                                    byte bLength)
                             throws javacard.framework.SystemException

Create Applet instance in Simulator

Parameters:

aid - applet aid

bArray - the array containing installation parameters

bOffset - the starting offset in bArray

bLength - the length in bytes of the parameter data in bArray

Returns:

applet AID

Throws:

javacard.framework.SystemException - if exception in Applet.install(..) method occurs.

installApplet

javacard.framework.AID installApplet(javacard.framework.AID aid,
                                     String appletClassName,
                                     byte[] bArray,
                                     short bOffset,
                                     byte bLength)
                              throws javacard.framework.SystemException

Install Applet into Simulator. This method is equal to: loadApplet(...); createApplet(...);

Parameters:

aid - applet aid or null

appletClassName - fully qualified applet class name Strin

bArray - the array containing installation parameters

bOffset - the starting offset in bArray

bLength - the length in bytes of the parameter data in bArray

Returns:

applet AID

Throws:

javacard.framework.SystemException - if appletClass not instanceof javacard.framework.Applet

installApplet

javacard.framework.AID installApplet(javacard.framework.AID aid,
                                     String appletClassName,
                                     byte[] appletJarContents,
                                     byte[] bArray,
                                     short bOffset,
                                     byte bLength)
                              throws javacard.framework.SystemException

Install Applet into Simulator. This method is equal to: loadApplet(...); createApplet(...);

Parameters:

aid - applet aid or null

appletClassName - fully qualified applet class name Strin

appletJarContents - Contains a byte array containing a jar file with an applet and its dependent classes

bArray - the array containing installation parameters

bOffset - the starting offset in bArray

bLength - the length in bytes of the parameter data in bArray

Returns:

applet AID

Throws:

javacard.framework.SystemException - if appletClass not instanceof javacard.framework.Applet

selectApplet

boolean selectApplet(javacard.framework.AID aid)

Select applet by it's AID It's method must be called before start working with applet instance

Parameters:

aid - appletId

Returns:

true if applet selection success

selectAppletWithResult

byte[] selectAppletWithResult(javacard.framework.AID aid)

Select applet by it's AID It's method must be called before start working with applet instance

Parameters:

aid - appletId

Returns:

byte array

changeProtocol

void changeProtocol(String protocol)

Switch protocol Supported protocols are:

• T=0 (alias: *)
• T=1
• T=CL, TYPE_A, T0 (alias: T=CL)
• T=CL, TYPE_A, T1
• T=CL, TYPE_B, T0
• T=CL, TYPE_B, T1

Parameters:

protocol - protocol to use

Throws:

IllegalArgumentException - for unknown protocols

getProtocol

String getProtocol()

Returns:

the current protocol string

See Also:

changeProtocol(String)