javacard.framework.service
Class RMIService

java.lang.Object
  javacard.framework.service.BasicService
      javacard.framework.service.RMIService

All Implemented Interfaces:

RemoteService, Service

public class RMIService

extends BasicService

implements RemoteService

An implementation of a service that is used to process Java Card platform RMI requests for remotely accessible objects.

Version:

1.0

Field Summary

static byte

DEFAULT_RMI_INVOKE_INSTRUCTION The default INS value (0x38) used for the remote method invocation command (INVOKE) in the Java Card platform RMI protocol.

Constructor Summary

RMIService(Remote initialObject)
Creates a new RMIService and sets the specified remote object as the initial reference for the applet.

Method Summary

boolean	processCommand(APDU apdu) Processes the command within the APDU object.
void	setInvokeInstructionByte(byte ins) Defines the instruction byte to be used in place of DEFAULT_RMI_INVOKE_INSTRUCTION in the Java Card platform RMI protocol for the INVOKE commands used to access the RMIService for remote method invocations.

Methods inherited from class javacard.framework.service.BasicService

fail, getCLA, getINS, getOutputLength, getP1, getP2, getStatusWord, isProcessed, processDataIn, processDataOut, receiveInData, selectingApplet, setOutputLength, setProcessed, setStatusWord, succeed, succeedWithStatusWord

Methods inherited from class java.lang.Object

equals

Methods inherited from interface javacard.framework.service.Service

processDataIn, processDataOut

Field Detail

DEFAULT_RMI_INVOKE_INSTRUCTION

public static final byte DEFAULT_RMI_INVOKE_INSTRUCTION

The default INS value (0x38) used for the remote method invocation command (INVOKE) in the Java Card platform RMI protocol.

See Also:

Constant Field Values

Constructor Detail

RMIService

public RMIService(Remote initialObject)
           throws NullPointerException

Creates a new RMIService and sets the specified remote object as the initial reference for the applet. The initial reference will be published to the client in response to the SELECT APDU command processed by this object.

The RMIService instance may create session data to manage exported remote objects for the current applet session in CLEAR_ON_DESELECT transient space.

Method Detail

setInvokeInstructionByte

public void setInvokeInstructionByte(byte ins)

Defines the instruction byte to be used in place of DEFAULT_RMI_INVOKE_INSTRUCTION in the Java Card platform RMI protocol for the INVOKE commands used to access the RMIService for remote method invocations.

Note:

• The new instruction byte goes into effect next time this RMIService instance processes an applet SELECT command. The Java Card platform RMI protocol until then is unchanged.

processCommand

public boolean processCommand(APDU apdu)

Processes the command within the APDU object. When invoked, the APDU object should either be in STATE_INITIAL with the APDU buffer in the Init format or in STATE_FULL_INCOMING with the APDU buffer in the Input Ready format defined in BasicService.

This method first checks if the command in the APDU object is a Java Card platform RMI access command. The Java Card platform RMI access commands currently defined are: Applet SELECT and INVOKE. If it is not a Java Card platform RMI access command, this method does nothing and returns false.

If the command is a Java Card platform RMI access command, this method processes the command and generates the response to be returned to the terminal. For a detailed description of the APDU protocol used in Java Card platform RMI access commands please see the Remote Method Invocation Service chapter of Runtime Environment Specification for the Java Card Platform.

Java Card platform RMI access commands are processed as follows:

• An applet SELECT command results in a Java Card platform RMI information structure in FCI format containing the initial reference object as the response to be returned to the terminal.
• An INVOKE command results in the following sequence -

1. The remote object is located. A remote object is accessible only if it was returned by this RMIService instance and since that time some applet instance or the other from within the applet package has been an active applet instance.
2. The method of the object is identified
3. Primitive input parameters are unmarshalled onto the stack. Array type input parameters are created as global arrays(See Runtime Environment Specification for the Java Card Platform) and references to these are pushed onto the stack.
4. An INVOKEVIRTUAL bytecode to the remote method is simulated
5. Upon return from the method, method return or exception information is marshalled from the stack as the response to be returned to the terminal

After normal completion, this method returns true and the APDU object is in STATE_OUTGOING and the output response is in the APDU buffer in the Output Ready format defined in BasicService.

Specified by:

processCommand in interface Service

Overrides:

processCommand in class BasicService