com.licel.jcardsim.base

Class SimulatorRuntime

java.lang.Object

com.licel.jcardsim.base.SimulatorRuntime

Direct Known Subclasses:

PersistentSimulatorRuntime

public class SimulatorRuntime
extends Object

Base implementation of Java Card Runtime.

See Also:

JCSystem, Applet

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SimulatorRuntime.ApplicationInstance Represents an Applet instance

Field Summary

Fields

Modifier and Type	Field and Description
protected Method	apduPrivateResetMethod method for resetting APDUs
protected SortedMap<javacard.framework.AID,SimulatorRuntime.ApplicationInstance>	applets storage for installed applets
protected javacard.framework.AID	currentAID current selected applet
protected byte	currentProtocol current protocol
protected javacard.framework.APDU	extendedAPDU extended APDU
protected SortedMap<javacard.framework.AID,javacard.framework.AID>	generatedLoadFileAIDs storage for automatically generated loadFile AIDs
protected SortedMap<javacard.framework.AID,LoadFile>	loadFiles storage for load files
protected Object	previousActiveObject previousActiveObject
protected javacard.framework.AID	previousAID previous selected applet
protected ThreadLocal<BiConsumer<javacard.framework.Applet,javacard.framework.AID>>	registrationCallback
protected byte[]	responseBuffer outbound response byte array buffer
protected short	responseBufferSize outbound response byte array buffer size
protected boolean	selecting if the applet is currently being selected
protected javacard.framework.APDU	shortAPDU regular APDU
protected byte	transactionDepth current depth of transaction
protected TransientMemory	transientMemory transient memory
protected boolean	usingExtendedAPDUs if extended APDUs are used

Constructor Summary

Constructors

Constructor and Description
SimulatorRuntime()
SimulatorRuntime(TransientMemory transientMemory)

Method Summary

Modifier and Type	Method and Description
void	abortTransaction()
protected void	activateSimulatorRuntimeInstance() Register this with SimulatorRuntime
void	beginTransaction()
void	changeProtocol(byte protocol) Change protocol
void	commitTransaction()
protected void	deleteApplet(javacard.framework.AID aid) Delete applet
protected void	deselect(SimulatorRuntime.ApplicationInstance applicationInstance)
protected javacard.framework.AID	findAppletForSelectApdu(byte[] selectApdu, ApduCase apduCase)
javacard.framework.AID	getAID()
protected javacard.framework.Applet	getApplet(javacard.framework.AID aid) Return Applet by it's AID or null
byte	getAssignedChannel()
short	getAvailablePersistentMemory()
short	getAvailableTransientDeselectMemory()
short	getAvailableTransientResetMemory()
javacard.framework.APDU	getCurrentAPDU()
short	getJavaContext(Object obj)
Object	getJavaOwner(Object obj)
short	getMaxCommitCapacity()
Object	getPreviousActiveObject()
javacard.framework.AID	getPreviousContextAID()
javacard.framework.Shareable	getSharedObject(javacard.framework.AID serverAID, byte parameter)
byte	getTransactionDepth()
TransientMemory	getTransientMemory()
short	getUnusedCommitCapacity()
void	installApplet(javacard.framework.AID loadFileAID, javacard.framework.AID moduleAID, javacard.framework.AID appletAID, byte[] bArray, short bOffset, byte bLength)
void	installApplet(javacard.framework.AID appletAid, byte[] bArray, short bOffset, byte bLength)
boolean	isAppletSelecting(Object aThis) Check if applet is currently being selected
protected static boolean	isAppletSelectionApdu(byte[] apdu)
boolean	isObjectDeletionSupported()
void	loadApplet(javacard.framework.AID aid, Class<? extends javacard.framework.Applet> appletClass) Load applet
void	loadLoadFile(LoadFile loadFile) Load a LoadFile
javacard.framework.AID	lookupAID(byte[] buffer, short offset, byte length) Lookup applet by aid contains in byte array
SimulatorRuntime.ApplicationInstance	lookupApplet(javacard.framework.AID lookupAid) Lookup applet by aid
void	requestObjectDeletion()
void	reset() powerdown/powerup
protected void	resetAPDU(javacard.framework.APDU apdu, ApduCase apduCase, byte[] buffer)
void	resetRuntime()
void	sendAPDU(byte[] buffer, short bOff, short len) Copy response bytes to internal buffer
void	setJavaOwner(Object obj, Object owner)
void	setPreviousActiveObject(Object previousActiveObject)
byte[]	transmitCommand(byte[] command) Transmit APDU to previous selected applet

Methods inherited from class java.lang.Object

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

Field Detail

registrationCallback

protected final ThreadLocal<BiConsumer<javacard.framework.Applet,javacard.framework.AID>> registrationCallback

applets

protected final SortedMap<javacard.framework.AID,SimulatorRuntime.ApplicationInstance> applets

storage for installed applets

loadFiles

protected final SortedMap<javacard.framework.AID,LoadFile> loadFiles

storage for load files

generatedLoadFileAIDs

protected final SortedMap<javacard.framework.AID,javacard.framework.AID> generatedLoadFileAIDs

storage for automatically generated loadFile AIDs

apduPrivateResetMethod

protected final Method apduPrivateResetMethod

method for resetting APDUs

responseBuffer

protected final byte[] responseBuffer

outbound response byte array buffer

transientMemory

protected final TransientMemory transientMemory

transient memory

shortAPDU

protected final javacard.framework.APDU shortAPDU

regular APDU

extendedAPDU

protected final javacard.framework.APDU extendedAPDU

extended APDU

currentAID

protected javacard.framework.AID currentAID

current selected applet

previousAID

protected javacard.framework.AID previousAID

previous selected applet

responseBufferSize

protected short responseBufferSize

outbound response byte array buffer size

selecting

protected boolean selecting

if the applet is currently being selected

usingExtendedAPDUs

protected boolean usingExtendedAPDUs

if extended APDUs are used

currentProtocol

protected byte currentProtocol

current protocol

transactionDepth

protected byte transactionDepth

current depth of transaction

previousActiveObject

protected Object previousActiveObject

previousActiveObject

Constructor Detail

SimulatorRuntime

public SimulatorRuntime()

SimulatorRuntime

public SimulatorRuntime(TransientMemory transientMemory)

Method Detail

activateSimulatorRuntimeInstance

protected final void activateSimulatorRuntimeInstance()

Register this with SimulatorRuntime

getAID

public javacard.framework.AID getAID()

Returns:

current applet context AID or null

lookupAID

public javacard.framework.AID lookupAID(byte[] buffer,
                                        short offset,
                                        byte length)

Lookup applet by aid contains in byte array

Parameters:

buffer - the byte array containing the AID bytes

offset - the start of AID bytes in buffer

length - the length of the AID bytes in buffer

Returns:

Applet AID or null

lookupApplet

public SimulatorRuntime.ApplicationInstance lookupApplet(javacard.framework.AID lookupAid)

Lookup applet by aid

Parameters:

lookupAid - applet AID

Returns:

ApplicationInstance or null

getPreviousContextAID

public javacard.framework.AID getPreviousContextAID()

Returns:

previous selected applet context AID or null

getApplet

protected javacard.framework.Applet getApplet(javacard.framework.AID aid)

Return Applet by it's AID or null

Parameters:

aid - applet AID

Returns:

Applet or null

loadApplet

public void loadApplet(javacard.framework.AID aid,
                       Class<? extends javacard.framework.Applet> appletClass)

Load applet

Parameters:

aid - Applet AID

appletClass - Applet class

loadLoadFile

public void loadLoadFile(LoadFile loadFile)

Load a LoadFile

Parameters:

loadFile - LoadFile to load

deleteApplet

protected void deleteApplet(javacard.framework.AID aid)

Delete applet

Parameters:

aid - Applet AID to delete

isAppletSelecting

public boolean isAppletSelecting(Object aThis)

Check if applet is currently being selected

Parameters:

aThis - applet

Returns:

true if applet is being selected

transmitCommand

public byte[] transmitCommand(byte[] command)
                       throws javacard.framework.SystemException

Transmit APDU to previous selected applet

Parameters:

command - command apdu

Returns:

response apdu

Throws:

javacard.framework.SystemException

findAppletForSelectApdu

protected javacard.framework.AID findAppletForSelectApdu(byte[] selectApdu,
                                                         ApduCase apduCase)

deselect

protected void deselect(SimulatorRuntime.ApplicationInstance applicationInstance)

sendAPDU

public void sendAPDU(byte[] buffer,
                     short bOff,
                     short len)

Copy response bytes to internal buffer

Parameters:

buffer - source byte array

bOff - the starting offset in buffer

len - the length in bytes of the response

reset

public void reset()

powerdown/powerup

resetRuntime

public void resetRuntime()

getTransientMemory

public TransientMemory getTransientMemory()

resetAPDU

protected void resetAPDU(javacard.framework.APDU apdu,
                         ApduCase apduCase,
                         byte[] buffer)

getCurrentAPDU

public javacard.framework.APDU getCurrentAPDU()

changeProtocol

public void changeProtocol(byte protocol)

Change protocol

Parameters:

protocol - protocol bits

See Also:

APDU.getProtocol()

getAssignedChannel

public byte getAssignedChannel()

beginTransaction

public void beginTransaction()

See Also:

JCSystem.beginTransaction()

abortTransaction

public void abortTransaction()

See Also:

JCSystem.abortTransaction()

commitTransaction

public void commitTransaction()

See Also:

JCSystem.commitTransaction()

getTransactionDepth

public byte getTransactionDepth()

Returns:

1 if transaction in progress, 0 if not

See Also:

JCSystem.getTransactionDepth()

getUnusedCommitCapacity

public short getUnusedCommitCapacity()

Returns:

The current implementation always returns 32767

See Also:

JCSystem.getUnusedCommitCapacity()

getMaxCommitCapacity

public short getMaxCommitCapacity()

Returns:

The current implementation always returns 32767

See Also:

JCSystem.getMaxCommitCapacity()

getAvailablePersistentMemory

public short getAvailablePersistentMemory()

Returns:

The current implementation always returns 32767

See Also:

JCSystem.getAvailableMemory(byte)

getAvailableTransientResetMemory

public short getAvailableTransientResetMemory()

Returns:

The current implementation always returns 32767

See Also:

JCSystem.getAvailableMemory(byte)

getAvailableTransientDeselectMemory

public short getAvailableTransientDeselectMemory()

Returns:

The current implementation always returns 32767

See Also:

JCSystem.getAvailableMemory(byte)

getSharedObject

public javacard.framework.Shareable getSharedObject(javacard.framework.AID serverAID,
                                                    byte parameter)

Parameters:

serverAID - the AID of the server applet

parameter - optional parameter data

Returns:

the shareable interface object or null

See Also:

JCSystem.getAppletShareableInterfaceObject(javacard.framework.AID, byte)

isObjectDeletionSupported

public boolean isObjectDeletionSupported()

Returns:

always false

See Also:

JCSystem.isObjectDeletionSupported()

requestObjectDeletion

public void requestObjectDeletion()

See Also:

JCSystem.requestObjectDeletion()

setJavaOwner

public void setJavaOwner(Object obj,
                         Object owner)

getJavaOwner

public Object getJavaOwner(Object obj)

getJavaContext

public short getJavaContext(Object obj)

getPreviousActiveObject

public Object getPreviousActiveObject()

setPreviousActiveObject

public void setPreviousActiveObject(Object previousActiveObject)

isAppletSelectionApdu

protected static boolean isAppletSelectionApdu(byte[] apdu)

installApplet

public void installApplet(javacard.framework.AID appletAid,
                          byte[] bArray,
                          short bOffset,
                          byte bLength)

installApplet

public void installApplet(javacard.framework.AID loadFileAID,
                          javacard.framework.AID moduleAID,
                          javacard.framework.AID appletAID,
                          byte[] bArray,
                          short bOffset,
                          byte bLength)