持久数据和记录管理系统（ Record Management System，简称 RMS）
MIDP提供在移动设备上存储持久数据的支持，并且 MID简表还特意规定兼容的移动设备必须提供至少 8KB的非动态内存用于数据存储的用途，时式上，大多数的 MIDP Java设备提供的空间比这要求多得多。这就允许一个midlet充份利用应用程序的持久数据。对于有 Java 2标准版开发经验的开发者，应该注意这种数据存储能力与标准的 Java有区别。J2ME记录管理系统 ( RMS )允许数据流被储存并且在一个记录基础上访问数据。由应用程序开发者把每个记录解析到字段水平。RMS程序包内部的接口支持一个应用程序定义的基础上的比较与检索功能。
一、javax.microedition.rms程序包
通过 javax.microedition.rms包访问 J2ME记录管理系统，这个包包括一个类， RecordStore，和好几个有用的接口 (在下列表格中描述 )：
| 接口 |
描述 |
| RecordComparator |
一个接口，定义一个比较机制，比较两个记录(以一个实现定义的方式)看它们是否匹配或它们的相对排序次序是什么样的。 |
| RecordEnumeration |
一个接口，一个双向的纪录模拟器 |
| RecordFilter |
一个接口，定义了一个过滤器用于检查一个记录，看其是否匹配 (基于一种应用程序定义的标准 )。 |
| RecordListener |
一个监听者接口，从一个记录存储器中接受记录更改/添加/删除事件。 |
这些接口对于实现自定义搜索和检索功能很有用，这些接口中使用的最多的就是 RecordEnumeration。这个接口从 RecordStore.enumerateRecords()方法调用中返回并且被用于遍历一组从记录存储器中返回的记录。它包含 nextRecord()、 previousRecord()、 numRecords()和 hasNextElement()等方法。
二、使用RecordStore类访问记录存储RecordStore类是开发者开发基层 RMS的接口，记录储存是在一个平台--midlet环境依赖的方式--上创建的。信息的实际的位置和存储细节应用程序开发者其实并不知道，记录存储可以使用一种简单的命名规则来访问：名称最多可以到32个Unicode字符长度，区分大小写和必须在一个 midlet套件内唯一。在一个 midlet套件内的所有 midlet都有读/写一个记录存储的权限，只要它们知道正确的名称。一旦这个 midlet套件被从该设备上删除，所有与这个套件关联的记录存储也将被删除。
比如说，为了打开一个名为 TestRecordSet的记录存储，你可以调用 RecordStore.openRecordStore()方法。这个方法使用两个参数：一个字符串，表示记录存储的名称；一个布尔值，如果为真的话，就会在纪录存储不存在时创建一个。我们使下列方法调用创建新的 TestRecordSet记录存储：
RecordStore rs = null;
rs = RecordStore.openRecordStore("TestRecordSet", true); |
记录存储被创建好后，我们可以通过调用 RecordStore.addRecord()方法来向这个记录存储添加数据。addRecord()接受三个参数：
| 参数 |
描述 |
| byte[] data |
一个储存在记录中的字节数据数组，通过 java.io.ByteArrayOutputStream和 java.io.DataOutputStream类把数据添加到这个字节数组。 |
| int offset |
进入这个记录第一个关联字节数据缓冲区的索引。 |
| int numBytes |
用于记录的数据缓冲区的字节数 |
一旦成功完成 addRecord()调用 ,这个方法就返回一个整数指定这个记录在记录存储中的标识号。 RecordStore还规定另外一个数据编辑方法，包括 setRecord()和 deleteRecord()，但是我在例子中不会使用它们。
三、构建一个用于J2ME设备的通讯录
这个例子构造一个基本的通讯录应用程序，使用它用户就可以从一个移动设备上查看联络资料。现在我只介绍从本地设备中存储的数据中读出相关的联络资料，在本文稍后的部分，你将看到如何使用J2ME网络功能从一个 Web服务器取回数据文件！用户将能查看一个地址列表和从这个列表选择一个地址。为了实现这个目标，我们要创建两个类，从用户界面逻辑中把数据存取逻辑分开的： AddressDB类封装所有的 RMS代码； AddressBookMIDLet类封装 GUI代码。AddressDB类的代码如下：
import javax.microedition.rms.*;import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.EOFException;
import java.io.IOException;
public class AddressDB {
private static RecordStore rs = null;
public AddressDB() {
try {
rs = RecordStore.openRecordStore("addressbook", true);
}
catch (RecordStoreException e) {
System.out.println(e);
e.printStackTrace();
}
}
public void addAddress(String Name, String Address) {
ByteArrayOutputStream os = new ByteArrayOutputStream();
DataOutputStream output = new DataOutputStream(os);
try {
output.writeUTF(Name + "," + Address);
}
catch (IOException e) {
System.out.println(e);
e.printStackTrace();
}
byte[] b = os.toByteArray();
try {
rs.addRecord(b, 0, b.length);
}
catch (RecordStoreException e) {
System.out.println(e);
e.printStackTrace();
}
}
public static String getName(int index) {
int counter = 1;
int commalocation = 0;
String name = null;
try {
RecordEnumeration enumRec =
rs.enumerateRecords(null, null, false);
while ((counter <= index) && (enumRec.hasNextElement())) {
String strTemp = new String(enumRec.nextRecord());
commalocation = strTemp.indexOf(',');
name = strTemp.substring(2, commalocation);
counter++;
}
}
catch (Exception e) {
System.out.println(e);
e.printStackTrace();
}
return name;
}
public static String getAddress(int index) {
int counter = 1;
int commalocation = 0;
String address = null;
try {
RecordEnumeration enumRec =
rs.enumerateRecords(null, null, false);
while ((counter <= index) && (enumRec.hasNextElement())) {
String strTemp = new String(enumRec.nextRecord());
commalocation = strTemp.indexOf(',');
address = strTemp.substring(commalocation + 1);
counter++;
}
}
catch (Exception e) {
System.out.println(e);
e.printStackTrace();
}
return address;
}
public static int recordCount() {
int count = 0;
try {
count = rs.getNumRecords();
}
catch (Exception e) {
System.out.println(e);
e.printStackTrace();
}
return count;
}
} |
AddressDB类包含好几个 public访问方法，它们都对来自外部调用者的访问隐藏记录存储的细节。AddressDB()构造程序调用 RecordStore.openRecordStore()，正如前面讨论的那样。我也创建了四个助手方法用于访问基层记录存储： recordCount()、 getAddress()、 getName()和 addAddress()。注意，在本例子中addAddress()方法只是在 name/address字段之间放了一个逗号。同样地， getAddress()和getName()从记录存储中取回 name/address字段。
持久数据和记录管理系统（ Record Management System，简称 RMS）
MIDP提供在移动设备上存储持久数据的支持，并且 MID简表还特意规定兼容的移动设备必须提供至少 8KB的非动态内存用于数据存储的用途，时式上，大多数的 MIDP Java设备提供的空间比这要求多得多。这就允许一个midlet充份利用应用程序的持久数据。对于有 Java 2标准版开发经验的开发者，应该注意这种数据存储能力与标准的 Java有区别。J2ME记录管理系统 ( RMS )允许数据流被储存并且在一个记录基础上访问数据。由应用程序开发者把每个记录解析到字段水平。RMS程序包内部的接口支持一个应用程序定义的基础上的比较与检索功能。
一、javax.microedition.rms程序包
通过 javax.microedition.rms包访问 J2ME记录管理系统，这个包包括一个类， RecordStore，和好几个有用的接口 (在下列表格中描述 )：
| 接口 |
描述 |
| RecordComparator |
一个接口，定义一个比较机制，比较两个记录(以一个实现定义的方式)看它们是否匹配或它们的相对排序次序是什么样的。 |
| RecordEnumeration |
一个接口，一个双向的纪录模拟器 |
| RecordFilter |
一个接口，定义了一个过滤器用于检查一个记录，看其是否匹配 (基于一种应用程序定义的标准 )。 |
| RecordListener |
一个监听者接口，从一个记录存储器中接受记录更改/添加/删除事件。 |
这些接口对于实现自定义搜索和检索功能很有用，这些接口中使用的最多的就是 RecordEnumeration。这个接口从 RecordStore.enumerateRecords()方法调用中返回并且被用于遍历一组从记录存储器中返回的记录。它包含 nextRecord()、 previousRecord()、 numRecords()和 hasNextElement()等方法。
二、使用RecordStore类访问记录存储RecordStore类是开发者开发基层 RMS的接口，记录储存是在一个平台--midlet环境依赖的方式--上创建的。信息的实际的位置和存储细节应用程序开发者其实并不知道，记录存储可以使用一种简单的命名规则来访问：名称最多可以到32个Unicode字符长度，区分大小写和必须在一个 midlet套件内唯一。在一个 midlet套件内的所有 midlet都有读/写一个记录存储的权限，只要它们知道正确的名称。一旦这个 midlet套件被从该设备上删除，所有与这个套件关联的记录存储也将被删除。
比如说，为了打开一个名为 TestRecordSet的记录存储，你可以调用 RecordStore.openRecordStore()方法。这个方法使用两个参数：一个字符串，表示记录存储的名称；一个布尔值，如果为真的话，就会在纪录存储不存在时创建一个。我们使下列方法调用创建新的 TestRecordSet记录存储：
RecordStore rs = null;
rs = RecordStore.openRecordStore("TestRecordSet", true); |
记录存储被创建好后，我们可以通过调用 RecordStore.addRecord()方法来向这个记录存储添加数据。addRecord()接受三个参数：
| 参数 |
描述 |
| byte[] data |
一个储存在记录中的字节数据数组，通过 java.io.ByteArrayOutputStream和 java.io.DataOutputStream类把数据添加到这个字节数组。 |
| int offset |
进入这个记录第一个关联字节数据缓冲区的索引。 |
| int numBytes |
用于记录的数据缓冲区的字节数 |
一旦成功完成 addRecord()调用 ,这个方法就返回一个整数指定这个记录在记录存储中的标识号。 RecordStore还规定另外一个数据编辑方法，包括 setRecord()和 deleteRecord()，但是我在例子中不会使用它们。
三、构建一个用于J2ME设备的通讯录
这个例子构造一个基本的通讯录应用程序，使用它用户就可以从一个移动设备上查看联络资料。现在我只介绍从本地设备中存储的数据中读出相关的联络资料，在本文稍后的部分，你将看到如何使用J2ME网络功能从一个 Web服务器取回数据文件！用户将能查看一个地址列表和从这个列表选择一个地址。为了实现这个目标，我们要创建两个类，从用户界面逻辑中把数据存取逻辑分开的： AddressDB类封装所有的 RMS代码； AddressBookMIDLet类封装 GUI代码。AddressDB类的代码如下：
import javax.microedition.rms.*;import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.DataInputStream;
import java.io.DataOutputStream;
import java.io.EOFException;
import java.io.IOException;
public class AddressDB {
private static RecordStore rs = null;
public AddressDB() {
try {
rs = RecordStore.openRecordStore("addressbook", true);
}
catch (RecordStoreException e) {
System.out.println(e);
e.printStackTrace();
}
}
public void addAddress(String Name, String Address) {
ByteArrayOutputStream os = new ByteArrayOutputStream();
DataOutputStream output = new DataOutputStream(os);
try {
output.writeUTF(Name + "," + Address);
}
catch (IOException e) {
System.out.println(e);
e.printStackTrace();
}
byte[] b = os.toByteArray();
try {
rs.addRecord(b, 0, b.length);
}
catch (RecordStoreException e) {
System.out.println(e);
e.printStackTrace();
}
}
public static String getName(int index) {
int counter = 1;
int commalocation = 0;
String name = null;
try {
RecordEnumeration enumRec =
rs.enumerateRecords(null, null, false);
while ((counter <= index) && (enumRec.hasNextElement())) {
String strTemp = new String(enumRec.nextRecord());
commalocation = strTemp.indexOf(',');
name = strTemp.substring(2, commalocation);
counter++;
}
}
catch (Exception e) {
System.out.println(e);
e.printStackTrace();
}
return name;
}
public static String getAddress(int index) {
int counter = 1;
int commalocation = 0;
String address = null;
try {
RecordEnumeration enumRec =
rs.enumerateRecords(null, null, false);
while ((counter <= index) && (enumRec.hasNextElement())) {
String strTemp = new String(enumRec.nextRecord());
commalocation = strTemp.indexOf(',');
address = strTemp.substring(commalocation + 1);
counter++;
}
}
catch (Exception e) {
System.out.println(e);
e.printStackTrace();
}
return address;
}
public static int recordCount() {
int count = 0;
try {
count = rs.getNumRecords();
}
catch (Exception e) {
System.out.println(e);
e.printStackTrace();
}
return count;
}
} |
AddressDB类包含好几个 public访问方法，它们都对来自外部调用者的访问隐藏记录存储的细节。AddressDB()构造程序调用 RecordStore.openRecordStore()，正如前面讨论的那样。我也创建了四个助手方法用于访问基层记录存储： recordCount()、 getAddress()、 getName()和 addAddress()。注意，在本例子中addAddress()方法只是在 name/address字段之间放了一个逗号。同样地， getAddress()和getName()从记录存储中取回 name/address字段。
