Soma Ghosh（sghosh@entigo.com）
应用程序开发者，Entigo
2002 年 8 月

移动信息设备框架（Mobile Information Device Profile）— 移动 Java 应用程序的平台 — 为 MIDP 应用程序提供一种跨多个调用持久存储数据的机制。这种持久存储机制可以被视为一种简单的面向记录的数据库模型，被称为记录管理系统（record management system（RMS））。在此，Soma Ghosh 说明了您的 J2ME 应用程序怎样能够使用 RMS 来管理和解释数据。通过一个样本电话数据库，您还将了解到关于这个概念的说明。
J2ME 记录管理系统
J2ME 记录管理系统（RMS）提供了一种机制，通过这种机制，MIDlet 能够持久存储数据，并在以后检索数据。在面向记录的方法中，J2ME RMS 由多个记录存储构成。J2ME RMS 和 MIDlet 接口连接的概貌在图 1 中给出。

图 1. J2ME RMS 和 MIDlet 接口连接的概貌


可以将每个记录存储想像成一个记录集合，它将跨多个 MIDlet 调用持久存在。设备平台负责在平台正常使用的整个过程（包括重新启动、换电池等）中，尽全力维护 MIDlet 的记录存储的完整性。

记录存储在与平台相关的位置（比如非易失性设备存储器）创建，这些位置不直接公开给 MIDlet。RMS 类调用特定于平台的本机代码，这种本机代码使用标准 OS 数据管理器函数来执行实际的数据库操作。

记录存储实现确保所有单个的记录存储操作都是原子的、同步的以及序列化的，因此多个访问将不会出现数据毁坏。记录存储被盖上时间戳来指示它上次被修改的时间。记录存储还维护版本（version），它是一个整数，修改记录存储内容的操作每发生一次，这个数加一。版本和时间戳对于同步目的很有用。

当 MIDlet 使用多个线程访问一个记录存储时，协调该访问是 MIDlet 的责任；如果它不能这样做，可能出现无法意料的结果。同样，如果一个平台使用试图同时访问记录存储的多个线程执行记录存储的同步，那么对 MIDlet 及其同步引擎之间的记录存储实施排外访问是平台的责任。

记录存储中的每个记录是一个字节数组，并且有唯一的整数标识符。

管理设备数据库
javax.microedition.rms.RecordStore 类代表 RMS 记录存储。它提供了几个方法来管理以及插入、更新和删除记录存储中的记录。

管理记录存储
要打开一个记录存储，调用 javax.microedition.rms.RecordStore 的 openRecordStore() 方法。public static RecordStore openRecordStore(String recordStoreName, boolean createIfNecessary) 打开具有指定名称 recordStoreName 的记录存储。如果没有具有这个名称的记录存储，那么调用这个方法来创建一个。

如果记录存储已经打开，这个方法将返回对同一个记录存储对象的引用。

清单 1. 打开一个 RecordStore
RecordStore rs = RecordStore.openRecordStore("MyAppointments",true);



一旦所有操作完成，对 closeRecordStore() 的调用将关闭指定名称的记录存储。当一个记录存储被关闭时，不能进行进一步的操作。

清单 2. 关闭一个 RecordStore
Rs.closeRecordStore();



通过调用 deleteRecordStore() 方法可以删除指定名称的记录存储。

清单 3. 删除一个 RecordStore
RecordStore.deleteRecordStore("MyAppointments");



插入记录
MIDlet 调用 javax.microedition.rms.RecordStore 类的 addRecord() 方法来将一条新记录插入到记录存储中。这是阻塞的原子操作，并返回新记录的 recordId。在这个方法返回之前，记录被写到持久存储中。

public int addRecord(byte[] data, int offset, int numBytes) 插入一条由字节数组 data 代表的记录，这个数组以 offset 作为它的起始索引，numBytes 作为它的长度。

清单 4. 插入一条记录
String appt = "new record";
byte bytes[] = appt.getBytes();
rs.addRecord(bytes,0,bytes.length);



更新记录
更新一条特殊记录包括获取这个记录的句柄以及设置新信息。

public int getRecord(int recordId, byte[] buffer, int offset) 返回存储在由 buffer 代表的字节数组中给定记录的数据。public byte[] getRecord(int recorded) 返回由 recordId 代表的数据的副本。public void setRecord(int recordId, byte[] newData, int offset, int numBytes) 在 recordId 所代表记录的位置设置新信息，新信息是以 offset 作为它的起始索引，并以 numBytes 作为它的长度的字节流（newData）。

清单 5. 更新一条记录
String newappt = "update record";
Byte data = newappt.getBytes();
Rs.setRecord(1, data, 0, data.length());



删除记录
MIDlet 调用 deleteRecord() 方法来从记录存储中删除记录。

public void deleteRecord(int recordId) 删除由 recordId 代表的记录。这个记录的 recordId 接下来不能重用。

清单 6. 删除一条记录
Rs.deleteRecord(1);



数据解释
J2ME API 提供某种接口来解释存储在记录存储中的数据。这个过程包括比较记录来确定它们的相对排序。它还包括根据给定条件的内容过滤。

比较记录
MIDlet 实现 RecordComparator 接口，并定义 compare (byte[] rec1, byte[] rec2) 方法来比较两个候选记录。这个方法的返回值必须指示这两条记录的顺序。

清单 7. 比较记录并确定相对排序
Int compare (byte[] b1, byte[] b2)
{
String s1 = new String(b1);
String s2 = new String(b2);

If (s1.compareTo(s2) > 0)
Return RecordComparator.FOLLOWS;
Else if (s1.compareTo(s2) == 0)
Return RecordComparator.EQUIVALENT;
Else
Return RecordComparator.PRECEDES;
}



枚举记录
RecordEnumeration 接口负责枚举记录存储中的记录。它逻辑上维护记录存储中一连串的记录的 recordId。枚举器将以记录比较器确定的顺序迭代所有记录（或者如果提供了一个可选的记录过滤器，那么只是一个子集）。如果既没有指定过滤器又没有指定比较器，枚举将以未定义的顺序遍历记录存储中的所有记录。

清单 8. 枚举记录
RecordEnumeration re = rs.enumerateRecords(null, null, false);
If (re.hasNextElement())
Byte nextRec[] = re.nextRecord();



过滤记录
MIDlet 实现 RecordFilter 接口，定义检查记录是否满足应用程序定义的标准的过滤器。这个应用程序实现 RecordFilter 的 match() 方法来选择 RecordEnumeration 返回的记录。

清单 9. 过滤记录
Public boolean matches(byte[]