Java Card开发常用的包（整理）

整理了一下常用到的Java卡开发包里的方法，以后就能加快开发速度了。

//Java Card开发方法查询
import java.lang.*;
import javacard.framework.*;
import javacard.security.*;
import javacardx.crypto.*;     //该包为扩展包

//install方法
public static void install(byte[] bArray, short offset, byte length)
{
new wallet().register(bArray, (short) (bOffset + 1), bArray[bOffset]);
}

/************************************************************************************/
//建立类JCSystem中的临时数组的方法
/*每个方法调用中的第一个参数 length 指出所请求的临时数组的长度。
第二个参数 event 指出哪种事件清除该对象。因此，方法调用指出临
时数组的类型，CLEAR_ON_RESET 或CLEAR_ON_DESELECT。
*/
//建立一个临时布尔数组
Public static boolean[] MakeTransientBooleanArray(short length,byte event);

//建立一个临时字节数组
Public static byte[] MakeTransientByteArray(short length,byte event);

//建立一个临时short数组
Public static short[] MakeTransientShortArray(short length,byte event)

//建立一个临时对象数组
Public static object[] MakeTransientObjectArray(short length,byte event)

/*
方法 isTransient 返回一个临时类型常数（CLEAR_ON_RESET 或 CLEAR_ON_DESELECT），
或者返回常数 JCSystem.NOT_A_TRANSIENT_OBJECT 指出该对象是 null 或者是一个永久对象
*/
public static byte isTransient(Object theObject);

/************************************************************************************/
//原子性
/*
Util.arrayCopy方法保证要么所有的字节被正确地拷贝，要么目标数组被恢复为其原来的字节值。
如果该目标数组是临时的，就不具有原子特性。
*/
public static short arrayCopy(byte[] src,short srcOff,byte[] dest,short desOff,short length);

//方法arrayCopyNonAtomic在拷贝操作过程中不使用事务设施，即使一个事务正在执行之中。
public static short arrayCopyNonAtomic(byte[] src,short srcOff,byte[] dest,short desOff,short length);

//用指定的值填入一个字节数组的诸元素：
public static short arrayFillNonAtomic(byte[] bArray,short bOff,short bLen,byte bValue);

//事务的提交
//开始一个交易
JCSysten.beginTransaction();
//在该交易提交之前，一组永久数据的修改中的全部修改都是暂时的
//提交一个事物
JCSysten.commitTransaction();

//返回一个commit buffer中的字节总数
JCSystem.getMaxCommitCapacity();
//返回在该commit buffer中剩下未用的字节数
JCSystem.getUnusedCommitCapacity()

/************************************************************************************/
javacard.framework.Applet 中的方法
//JCRE调用这个静态方法建立Applet子类的一个实例
Public static void Install(byte[] bArray,short bOffset,byte bLength)
//示例
public class WalletApp extends Applet{
private log transaction_log；
private byte[] wallet_id；
private byte wallet_balance；
public static void install(byte[] bArray, short bOffset,byte bLength){

   new WalletApp()；

}
private WalletApp(){
   //建立一个具有指定事物记录数的事物日志
   transaction_log = new Log(TRAN_RECORD_NUM)；
   //建立一个字节数组用以存储钱包wallet的ID
   wallet_id = new byte[ID_LENGTH]；
   //初始化钱包wallet的余额
   wallet_balance = INITIAL_BALANCE；
   //向JCRE注册该applet实例
   register()；
}
}

//安装参数处理示例
private walletApp(byte[] bArray,short bOffset,byte bLength){
//建立一个事物日志并指出最大的日志记录数 max_record_num = bArray[bOffset]
transaction_log = new Log(bArray[bOffset++])；
//设置钱包ID
wallet_ID = new byte[ID_LENGTH]；
Util.arrayCopy(bArray,bOffset,wallet_id,(byte)0,ID_LENGTH)；
//bOffset前进ID_LENGTH个字节
bOffset += ID_LENGTH；
//初始化钱包余额
wallet_balabce = bArray[bOffset++]；
//检查AID
byte AID_len = bArray[bOffset++]；
if （AID_len = ＝0）{
      //利用缺省AID向LCRE注册applet实例
      this.register()；
}else{
      //利用安装参数中指出的AID向JCRE注册applet实例
      //bArray中的AID字节从索引bOffset开始，由AID_len个字节组成
      this.register(bArray，bOffset，AID_len)；
}
}

//该方法由applet用来向JCRE注册本applet实例并指定CAP文件中的缺省AID给本applet实例
Protected final void Register()

//该方法由applet用来向JCRE注册本applet实例并将数组bArray中指出的AID赋予该applet实例。
Protected final void Register(byte[] bArray,short bOffset,byte bLength)

/************************************************************************************/
//JCRE调用这个方法通知该applet它已经被选择。
Public boolean Select()

//JCRE调用这个方法指示该applet处理一个输入的APDU命令。
Public abstract void Process(APDU apdu)

//JCRE调用这个方法通知当前选择的applet另一个（或同一个）applet将被选择。
Public void deselect()

//索取APDU buffer
public void process(APDU apdu){
byte[] apdu_buffer = apdu.getBuffer()；
}

//设置JCRE为数据接受模式,返回它所读入的字节数,如果无数据，则返回0
public short setIncomingAndReceive（）throws APDUExcetion；

//数据读示例
public void process(APDU apdu){
byte[] apdu_buffer = =apdu.getbuffer()；
    short total_bytes = （short）（apdu_buffer[ISO7816.OFFSET_LC] & 0xFF）；

    //读数据至APDU buffer   
    short read_count = apdu.setIncomingAndReceive()；

    //获得剩余字节数
    short bytes_left = (short)(total_bytes – read_count)；

    while(true){

   //处理APDU Buffer中的数据或者将数据拷贝到内部buffer
   ……

   //检查是否还有剩余数据，如果无，跳出循环。
   If (bytes_left <=0) break；
   //如果有剩余数据，在读数据。
   Read_count = apdu.receiveBytes((short)0)；

   Bytes_left -= read_count；

}
    //执行其它任务和向host送回响应
    ……
}

//重新设置数据传送方向为输出，置JCRE为数据发送模式.剩余的输入数据将被丢弃，并且applet就不能再继续接收命令数据
Public short setOutgoing() throws APDUException；

//调用了setOutgoing方法之后，applet必须调用setOutgoingLength方法，以向host指出它将实际发送总共多少响应数据字节（不包括SW）
public void setOutgoingLength(short length) throws APDUException；

//sendBytes方法从APDU Buffer中指定位移bOff处发送len个数据字节.因此，applet在调用这个方法之前，必须在APDU Buffer中生成响应数据或从别处拷贝过来。
public void sendBytes(short bOff,short len) throws APDUException；

//示例
public void process(APDU apdu){
    //接收和处理命令APDU 
    ……
    //现在准备好发送响应数据   
    //首先设置JCRE为数据发送模式并获得期望的行应数据长度（Le）
    short le = apdu.setOutgoing()；
    //接着通知host：applet将实际发送10个字节    
    apdu.setOugoingLength((short)10)；
    //在APDU Buffer中准备数据，从位移0开始
    ……
    //准备结束时，发送数据
    apdu.sendBytes((short)0，（short）10)；
}

//设置传输模式为发送,设置响应数据长度为len,从APDU Buffer 位移bOff起发送响应数据字节
public void setOutgoingAndSend(short bOff,short len) throws APDUException；

//sendBytesLong方法从字节数组outDATA中的位移bOff开始处发送len字节数据.仅当已经先调用了setOutgoing和setOutgoingLength方法之后，它才能被调用。
public void sendBytesLong(byte[] outDATA,short bOff,short len) throws APDUException；

//示例
//Get_Account_Info命令APDU要求applet发送账号拥有者的名字、账号，和截止日期。
//另外，要求applet发送由名字、账号，和截止日期计算的hash值，以确保数据正确传输。
//applet将账号持有者的名字、账号，和截止日期存储在独立的字节数组中。

Private byte[] name；           //20字节
Private byte[] account_number； //9字节
Private byte[] expiration+date；   //4字节

//在处理了命令APDU后，applet现在准备好发送响应数据。
//响应数据中的字节数为：
//total_bytes = 20(name)＋9(account_number)＋4(expiration_date)＋8(hash值)＝41字节

short total_bytes ＝ （short）41；

//step1：
//设置数据传输方向为输出
short le ＝ apdu.setOutgoing；
//step2：
//通知host响应中的实际字节数
apdu.setOutgongLength（nametotaal_bytes）；
//step3：
//发送name
apdu.sendBytesLong(name,(short)0, (short)name.length)；
//发送账号
apdu.sendBytesLong(account_number，(short)0, (short) account_number.length)；
//发送机制日期
apdu.sendBytesLong(expiration_date,(short)0, (short) expiration_date.length)；
//现在，在APDU Buffer中计算shah值，
//假定于位移0处生成hash值
//……
//发送shah值
apdu.sendBytes((short)0,HASH_VALUE_LENGTH)；
//现在返回
return；
}