com.licel.jcardsim.remote

Class JavaCardRemoteClient

java.lang.Object

com.licel.jcardsim.remote.JavaCardRemoteClient

All Implemented Interfaces:

CardInterface, JavaCardInterface

public class JavaCardRemoteClient
extends Object
implements JavaCardInterface

RMI client.

Constructor Summary

Constructors

Constructor and Description
JavaCardRemoteClient(String serverHost, int serverIp)

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
byte[]	getATR() Returns ATR
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
void	reset() Powerdown/Powerup
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
byte[]	transmitCommand(byte[] data) Transmit APDU to previous selected applet If no applet was selected returns byte[2] with status word 0x6986 (Command not allowed (no current EF))

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JavaCardRemoteClient

public JavaCardRemoteClient(String serverHost,
                            int serverIp)
                     throws RemoteException,
                            NotBoundException

Throws:

RemoteException

NotBoundException

Method Detail

loadApplet

public javacard.framework.AID loadApplet(javacard.framework.AID aid,
                                         String appletClassName)
                                  throws javacard.framework.SystemException

Description copied from interface: JavaCardInterface

Load Applet into Simulator

Specified by:

loadApplet in interface JavaCardInterface

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

loadApplet

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

Description copied from interface: JavaCardInterface

Load Applet into Simulator

Specified by:

loadApplet in interface JavaCardInterface

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

createApplet

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

Description copied from interface: JavaCardInterface

Create Applet instance in Simulator

Specified by:

createApplet in interface JavaCardInterface

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

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

Description copied from interface: JavaCardInterface

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

Specified by:

installApplet in interface JavaCardInterface

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

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

Description copied from interface: JavaCardInterface

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

Specified by:

installApplet in interface JavaCardInterface

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

public boolean selectApplet(javacard.framework.AID aid)

Description copied from interface: JavaCardInterface

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

Specified by:

selectApplet in interface JavaCardInterface

Parameters:

aid - appletId

Returns:

true if applet selection success

getATR

public byte[] getATR()

Description copied from interface: CardInterface

Returns ATR

Specified by:

getATR in interface CardInterface

Returns:

ATR bytes

transmitCommand

public byte[] transmitCommand(byte[] data)

Description copied from interface: CardInterface

Transmit APDU to previous selected applet If no applet was selected returns byte[2] with status word 0x6986 (Command not allowed (no current EF))

Specified by:

transmitCommand in interface CardInterface

Parameters:

data - command apdu

Returns:

response APDU

See Also:

CommandAPDU, ResponseAPDU

reset

public void reset()

Description copied from interface: CardInterface

Powerdown/Powerup

Specified by:

reset in interface CardInterface

selectAppletWithResult

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

Description copied from interface: JavaCardInterface

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

Specified by:

selectAppletWithResult in interface JavaCardInterface

Parameters:

aid - appletId

Returns:

byte array

changeProtocol

public void changeProtocol(String protocol)

Description copied from interface: JavaCardInterface

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

Specified by:

changeProtocol in interface JavaCardInterface

Parameters:

protocol - protocol to use

getProtocol

public String getProtocol()

Specified by:

getProtocol in interface JavaCardInterface

Returns:

the current protocol string

See Also:

JavaCardInterface.changeProtocol(String)