Appendix   D

Reference Implementation of Java Card RMI Client-Side API

This appendix contains documentation for the Reference Implementation of the Java Card RMI client-side API.

Package ocfrmiclientimpl

The package com.sun.javacard.ocfrmiclientimpl contains implementations of the classes and interfaces from the package com.sun.javacard.javax.smartcard.rmiclient. It also contains implementations of classes and interfaces inherited from java.rmi.server.RemoteRef and opencard.core.service.CardType.

This implementation of ocfrmiclientimpl requires that an OCF framework is installed on the terminal.

class JCCardObjectFactory—An implementation of the CardObjectFactory that processes the data returned from the card in the format defined in the Runtime Environment (JCRE) Specification for the Java Card™ Platform, Version 2.2.1. Any object references must contain class names.
class JCCardProxyFactory—The JCCardProxyFactory class is similar to JCCardObjectFactory, but processes references containing lists of names. JCCardProxyFactory uses the SDK1.4.1 proxy mechanism to generate proxies dynamically.
class JCRemoteRefImpl—An implementation of interface java.rmi.server.RemoteRef. These remote references can work with stubs generated by the RMIC compiler with the -v1.2 option.

The main method is:
public Object invoke(Remote remote, Method method, Object[] params, long unused) throws IOException, RemoteException, Exception

This method prepares the outgoing APDU, passes it to CardAccessor, and then uses CardObjectFactory to parse the returned APDU and instantiate the returned object or throw an exception.

class OCFCardAccessor—A simple implementation of the CardAccessor interface. It passes the APDU to an underlying CardTerminal and returns the result received from the CardTerminal. Here, CardTerminal is the OpenCard Framework’s representation of a physical card terminal.

A client program usually supplies its own CardAccessor which extends OCFCardAccessor and performs additional transformations and checks of the data.

class JavaCardType—A tagging (empty) class; used to notify the OCF that the client framework expects to communicate with the Java Card API class OCFCardAccessorFactory. This class extends opencard.core.service.CardType.
class OCFCardAccessorFactory—A factory returning an instance of the OCFCardAccessor. Required to register the OCFCardAccessor with the OCF.

API Documentation

The remainder of this appendix contains API documentation for the reference implementation of the Java Card RMI client-side API, package com.sun.javacard.ocfrmiclientimpl. This package demonstrates remote stub customization using the RMIC compiler generated stubs and OCF-based card access for Java Card applets.

Development Kit User's Guide for the Binary Release with Cryptography Extensions Java Card Platform, Version 2.2.1

Copyright © 2003 Sun Microsystems, Inc. All rights reserved.