jcvm06cap.html

JAVA CARD 开发包规格说明,版本为2.2.2

<BR>
<TABLE CLASS="Titled" BORDER=1 BORDERCOLORLIGHT="#FFFFFF" BORDERCOLORDARK="#000000" CELLPADDING=5 CELLSPACING=0 DIR="LTR"><CAPTION CLASS="TableCaption"><A NAME="pgfId-1001973"> </A> TABLE 6-2 	 <A NAME="55066"> </A> CAP File Component File Names </CAPTION>
<THEAD>
<TR>
<TH SCOPE="COL" ROWSPAN="1" COLSPAN="1" BGCOLOR="#CCCCCC">
<P CLASS="TableHead"><A NAME="pgfId-1001977"></A>Component Type
</P>
</TH>
<TH SCOPE="COL" ROWSPAN="1" COLSPAN="1" BGCOLOR="#CCCCCC">
<P CLASS="TableHead"><A NAME="pgfId-1001979"></A>File Name
</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001981"></A>COMPONENT_Header
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001983"></A>Header.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001985"></A>COMPONENT_Directory
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001987"></A>Directory.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001989"></A>COMPONENT_Applet
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001991"></A>Applet.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001993"></A>COMPONENT_Import
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001995"></A>Import.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001997"></A>COMPONENT_ConstantPool
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1001999"></A>ConstantPool.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002001"></A>COMPONENT_Class
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002003"></A>Class.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002005"></A>COMPONENT_Method
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002007"></A>Method.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002009"></A>COMPONENT_StaticField
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002011"></A>StaticField.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002013"></A>COMPONENT_ReferenceLocation
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002015"></A>RefLocation.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002017"></A>COMPONENT_Export
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002019"></A>Export.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002021"></A>COMPONENT_Descriptor
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002023"></A>Descriptor.cap
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002025"></A>COMPONENT_Debug
</P>
</TD>
<TD ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-1002027"></A>Debug.cap
</P>
</TD>
</TR>
</TBODY>
</TABLE>
<BR>
<P CLASS="Paragraph"><A NAME="pgfId-1002030"></A>All CAP file components are stored in a JAR file. As described in <A HREF="JCVM04naming.html#10054" CLASS="XRef">Section 4.1.3, JAR File Container</A>, the path to the CAP file component files in a JAR file consists of a directory called <KBD CLASS="Filename-Command">javacard</KBD> that is in a subdirectory representing the package's directory. For example, the CAP file component files of the package <KBD CLASS="Filename-Command">javacard.framework</KBD> are located in the subdirectory <KBD CLASS="Filename-Command">javacard/framework/javacard</KBD>. Other files, including other CAP files, may also reside in a JAR file that contains CAP file component files.
</P>
<P CLASS="Paragraph"><A NAME="pgfId-54094"></A>The JAR file format provides a vehicle suitable for the distribution of CAP file components. It is not intended or required that the JAR file format be used as the load file format for loading CAP file components onto a Java Card technology-enabled device. See <A HREF="JCVM06cap.html#36273" CLASS="XRef">Section 6.2, Installation</A> for more information.
</P>
<P CLASS="Paragraph"><A NAME="pgfId-15611"></A>The name of a JAR file containing CAP file components is not defined as part of this specification. The naming convention used by the Sun Microsystems, Inc. Java Card Converter Tool is to append <KBD CLASS="Filename-Command">.cap</KBD> to the simple (meaning not fully qualified) package name. For example, the CAP file produced for the package <KBD CLASS="Filename-Command">com.sun.javacard.JavaLoyalty</KBD> would be named <KBD CLASS="Filename-Command">JavaLoyalty.cap</KBD>.
</P><H3 CLASS="Head2"><A NAME="pgfId-15560"></A>6.1.2	Defining New <A NAME="marker-54596"></A>Components</H3>
<P CLASS="Paragraph"><A NAME="pgfId-15561"></A>Java Card CAP files are permitted to contain new, or custom, components. All new components not defined as part of this specification must not affect the semantics of the specified components, and Java Card virtual machines must be able to accept CAP files that do not contain new components. Java Card virtual machine implementations are required to silently ignore components they do not recognize.
</P>
<P CLASS="Paragraph"><A NAME="pgfId-15562"></A>New components are identified in two ways: they are assigned both an ISO 7816-5 AID (<A HREF="JCVM04naming.html#28462" CLASS="XRef">Section 4.2, AID-based Naming</A>) and a tag value. Valid tag values are between 128 and 255, inclusive. Both of these identifiers are recorded in the <KBD CLASS="Filename-Command">custom_component</KBD> item of the Directory Component (<A HREF="JCVM06cap.html#Directory Component" CLASS="XRef">Section 6.4, Directory Component</A>).
</P>
<P CLASS="Paragraph"><A NAME="pgfId-17527"></A>The new component must conform to the general component format defined in this chapter, with a tag value, a size value indicating the number of bytes in the component (excluding the tag and size items), and an info item containing the content of the new component.
</P>
<P CLASS="Paragraph"><A NAME="pgfId-53863"></A>A new component file is stored in a JAR file, following the same restrictions as those specified in <A HREF="JCVM04naming.html#10054" CLASS="XRef">Section 4.1.3, JAR File Container</A>. That is, the file containing the new component must be located in the <KBD CLASS="Filename-Command">&lt;package_directory&gt;/javacard</KBD> subdirectory of the JAR file and must have the extension <KBD CLASS="Filename-Command">.cap</KBD>.
</P><H2 CLASS="Head1"><A NAME="pgfId-53867"></A>
<DIV>
<HR ALIGN=left SIZE=6 WIDTH=15% noshade>
</DIV>6.2	<A NAME="36273"></A>Installation<A NAME="marker-54597"></A></H2>
<P CLASS="Paragraph"><A NAME="pgfId-54210"></A>Installing a CAP file components onto a Java Card technology-enabled device entails communication between a Java Card technology-enabled terminal and that device. While it is beyond the scope of this specification to define a load file format or installation protocol between a terminal and a device, the CAP file component order shown in <A HREF="JCVM06cap.html#35280" CLASS="XRef">TABLE 6-3</A> is a reference load order suitable for an implementation with a simple memory management model on a limited memory device.<A NAME="fnote1"></A><A HREF="#pgfId-997658"  CLASS="footnote"><SUP>[1]</SUP></A> 
</P>
<BR>
<TABLE CLASS="Titled" BORDER=1 BORDERCOLORLIGHT="#FFFFFF" BORDERCOLORDARK="#000000" CELLPADDING=5 CELLSPACING=0 DIR="LTR"><CAPTION CLASS="TableCaption"><A NAME="pgfId-999987"> </A> TABLE 6-3 	 <A NAME="35280"> </A> Reference Component Install Order </CAPTION>
<THEAD>
<TR>
<TH SCOPE="COL" ROWSPAN="1" COLSPAN="1" BGCOLOR="#CCCCCC">
<P CLASS="TableTextCode"><A NAME="pgfId-54216"></A>Component Type
</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54218"></A><KBD CLASS="Filename-Command">COMPONENT_Header</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54220"></A><KBD CLASS="Filename-Command">COMPONENT_Directory</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54222"></A><KBD CLASS="Filename-Command">COMPONENT_Import</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54224"></A><KBD CLASS="Filename-Command">COMPONENT_Applet</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54226"></A><KBD CLASS="Filename-Command">COMPONENT_Class</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54228"></A><KBD CLASS="Filename-Command">COMPONENT_Method</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54230"></A><KBD CLASS="Filename-Command">COMPONENT_StaticField</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54232"></A><KBD CLASS="Filename-Command">COMPONENT_Export</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54234"></A><KBD CLASS="Filename-Command">COMPONENT_ConstantPool</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54236"></A><KBD CLASS="Filename-Command">COMPONENT_ReferenceLocation</KBD>
</P>
</TD>
</TR>
<TR>
<TD SCOPE="ROW" ROWSPAN="1" COLSPAN="1">
<P CLASS="TableTextCode"><A NAME="pgfId-54238"></A><KBD CLASS="Filename-Command">COMPONENT_Descriptor (optional)</KBD>