Preface

This document describes how to use the Java Card 3 Platform, Connected Edition, development kit to develop applications, servlets, and extended applets. The Connected Edition architecture uses a new virtual machine and a substantially different runtime environment from that of the classic platform (an update of the Java Card technology released in the 2.2.2 release).

Java Card technology for the Connected Edition targets devices that are less resource-constrained than previous Java Card technology devices. The Connected Edition includes new network-oriented features, such as support for web applications, including the Java Servlet APIs, and support for applets with extended and advanced capabilities.

Note - The Java Card 3 platform development kit is released in both binary and source bundles. Some bundles include cryptography extensions. Portions of this document are targeted toward specific release bundles and are identified as such throughout this book.

You must download the Java Card specifications bundle separately from the Sun Microsystems web site at:

http://java.sun.com/javacard

Apache Ant (Ant) tasks in the Development Kit are required to install and run the Development Kit.

Who Should Use This Document

The Development Kit User’s Guide, Java Card Platform, Version 3.0.1, Connected Edition is written for developers who are:

Creating Java Card 3 web or servlet applications, or classic or extended applet applications for the Connected Edition.
Creating a vendor-specific framework based on the specifications for the Connected Edition.

Before You Read This Document

Before reading this guide, you should become familiar with the Java trademark programming language, object-oriented programming, the specifications for the Connected Edition, and smart card technology. A good resource for becoming familiar with Java and Java Card technology is the Java Developer Connection web site located at http://java.sun.com .

How This Book Is Organized

The guide is divided into two parts. The Part I describes how to set up the development kit, how to use the samples, and how to use the development kit tools. Part II describes various programming issues for the Java Card 3 platform.

P A R T I - Setup, Samples and Tools

Chapter 1 provides an overview of the Development Kit for the Connected Edition.

Chapter 2 describes the procedures for installing the tools included in this release.

Chapter 3 provides a brief description of the steps involved in Java Card platform application development.

Chapter 4 describes the samples included with the Development Kit and provides the procedures used to run them.

Chapter 5 describes the reference implementation of the Connected Edition and provides the procedures used to start it.

Chapter 6 describes how to compile source files outside of an IDE by using the Compiler tool included with the Development Kit.

Chapter 7 describes how to use the Packager tool to create and validate a Java Card technology-based application module.

Chapter 8 describes how to use the Installer tool to perform card management tasks.

Chapter 9 describes how to use the the tools provided by the Development Kit to modify classic applets to run on the Java Card 3 platform.

Chapter 10 describes the APDU tool and how it is used when installing and running applets on a smart card.

Chapter 11 describes how to install and to use the Debugger tool in Java Card 3 platform applications development.

P A R T II - Programming With the Development Kit

Chapter 12 describes the options used to configure the RI.

Chapter 13 describes how licensees can modify or add to source files of the RI including VM code, and all tools (such as the Packager and Installer) and build a cutomized Java Card 3 platform RI according to their specific requirements.

Chapter 14 describes how to use the Java Card RMI client-side API.

Chapter 15 describes the APDU I/O API, which is a library used by development kit components, such as apdutool , and the RMI client framework.

Chapter 16 describes how to generate and install SSL keys.

Appendix A describes the application module and library formats supported by the Java Card 3 platform card manager.

Appendix B lists and describes the files and directories installed as part of the bundle.

Appendix C is a reference of command line usage for the Development Kit tools.

Glossary describes key terms used in this document.

Specifications, Standards, Protocols and Technologies

The Connected Edition supports the following specifications, standards, protocols, and technologies:

ETSI SCP and UICC specification for 3G mobile phones.
ISO 7816-4:1995 Identification cards - Integrated circuit cards with contacts part 4, inter-industry commands for interchange.

These specifications describe the communication transport and application protocol layer between the terminal and the card.

ISO 7816-4:2004 Identification cards - Integrated circuit cards with contacts part 4, inter-industry commands for interchange.
EMV 2000 Integrated Circuit Card specifications for payment systems.

These standards enable the correct operation and interoperability of payment applications on terminals and smart cards.

GlobalPlatform card specification

These card specifications are built on top of the Java Card specifications to provide interoperable content and lifecycle management for multifunction payment cards.

PCSC- Personal Computer Smart Card communication

The standard communication interfaces used on personal computers to access smart card reader driver layers.

Typographic Conventions

Typeface	Meaning	Examples
`AaBbCc123`	The names of commands, files, and directories; on-screen computer output	Edit your `.login` file. Use `ls -a` to list all files. `% You have mail` .
`AaBbCc123`	What you type, when contrasted with on-screen computer output Procedural steps	`%` `su` `Password:` 1. Run `j` `cre` in a new window.
AaBbCc123	Book titles, new words or terms, words to be emphasized Command-line variable; replace with a real name or value	Read Chapter 6 in the User’s Guide . These are called class options. You must be superuser to do this. To delete a file, type `rm` filename .

Typeface

Meaning

Examples

AaBbCc123

The names of commands, files, and directories; on-screen computer output

Edit your .login file.

Use ls -a to list all files.

% You have mail .

AaBbCc123

What you type, when contrasted with on-screen computer output

Procedural steps

% su

Password:

1. Run j cre in a new window.

AaBbCc123

Book titles, new words or terms, words to be emphasized

Command-line variable; replace with a real name or value

Read Chapter 6 in the User’s Guide .

These are called class options.

You must be superuser to do this.

To delete a file, type rm filename .

Accessing Documentation Online

The Java Developer Connection trademark program web site enables you to access Java platform technical documentation on the web at

http://java.sun.com/reference/docs

Third-Party Web Sites

Sun is not responsible for the availability of third-party web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Comments

We are interested in improving our documentation and welcome your comments and suggestions. You can submit your comments about this document to the following address:

bandol-ri-feedback@sun.com

Please include the following title of this document with your feedback:

Development Kit User’s Guide, Java Card Platform, Version 3.0.1, Connected Edition