J2ME 記錄管理系統 (RMS) 核心機制與實作詳解

RMS 簡介：行動裝置的持久化儲存

MIDP 規範要求相容裝置提供至少 8 KB 非揮發性記憶體供資料儲存 (實際多數裝置提供更多)。RMS (javax.microedition.rms) 提供以**記錄為單位**的儲存抽象，類似簡易資料表：

• 每筆記錄 = 位元組陣列 (byte[])，由應用自行定義欄位結構
• 記錄存放於 Record Store (邏輯資料庫)，名稱最長 32 Unicode 字元、區分大小寫、MIDlet Suite 內唯一
• 同一 Suite 內所有 MIDlet 可共享存取 (知名稱即可)
• Suite 移除時，關聯 Record Store 自動刪除

核心 API 概覽

基本操作流程與程式碼範例

1. 開啟/建立 Record Store

RecordStore rs = null;
try {
    rs = RecordStore.openRecordStore("TestRecordSet", true); // true = 不存在則建立
} catch (RecordStoreException e) {
    // 處理儲存空間不足、名稱衝突等
}

2. 新增記錄

// 準備資料：自訂序列化
ByteArrayOutputStream baos = new ByteArrayOutputStream();
DataOutputStream dos = new DataOutputStream(baos);
dos.writeUTF("UserName");
dos.writeInt(12345);
dos.writeLong(System.currentTimeMillis());
// ... 其他欄位
byte[] recordData = baos.toByteArray();

// 寫入
int recordId = rs.addRecord(recordData, 0, recordData.length);
// recordId 為 1-based 遞增識別碼

3. 讀取記錄

// 讀取單筆
byte[] data = rs.getRecord(recordId); // 拋出 InvalidRecordIDException 若不存在
// 或
int len = rs.getRecord(recordId, buffer, offset); // 讀入預分配緩衝區

// 解析
ByteArrayInputStream bais = new ByteArrayInputStream(data);
DataInputStream dis = new DataInputStream(bais);
String name = dis.readUTF();
int id = dis.readInt();
long time = dis.readLong();

4. 更新與刪除

// 更新 (完整覆寫)
rs.setRecord(recordId, newData, 0, newData.length);

// 刪除
rs.deleteRecord(recordId);

5. 列舉與篩選 (RecordEnumeration)

// 取得所有記錄 ID 列舉
RecordEnumeration re = rs.enumerateRecords(null, null, false); // 無過濾、無排序、不保持最新快照

while (re.hasNextElement()) {
    int id = re.nextRecordId();
    byte[] data = rs.getRecord(id);
    // 處理...
}

// 使用過濾器：只取名稱為 "Admin" 的記錄
RecordFilter adminFilter = new RecordFilter() {
    public boolean matches(byte[] candidate) {
        try {
            DataInputStream dis = new DataInputStream(new ByteArrayInputStream(candidate));
            return "Admin".equals(dis.readUTF());
        } catch (Exception e) { return false; }
    }
};
RecordEnumeration filtered = rs.enumerateRecords(adminFilter, null, false);

6. 關閉與資源釋放

rs.closeRecordStore();
// 應用結束時務必呼叫，確保資料刷新至儲存體

進階主題與最佳實踐

記錄 ID 管理

• ID 為 1-based 遞增，刪除後不會重複使用
• 長期運行應用可能耗盡 ID 空間 (理論上限 2^31-1)，需定期重建 Store

資料結構序列化策略

效能優化

• 批次寫入：累積多筆再寫入 (但 RMS 無交易機制，單筆原子)
• 索引機制：維護獨立索引 Store (如 name→recordId 映射) 加速查詢
• 快取熱點資料記憶體中，減少 RMS I/O

多執行緒安全

RecordStore 方法為**同步化**，可安全多執行緒存取。但複合操作 (如「讀取→修改→寫回」) 需應用層自行同步。

空間管理與異常處理

• 捕捉 RecordStoreFullException：提示使用者清理或移除舊資料
• 定期檢查 rs.getSize() / rs.getSizeAvailable()
• 實作 LRU 淘汰策略自動清理過期記錄

完整範例：簡易通訊錄 MIDlet

public class AddressBook {
    private static final String STORE_NAME = "AddressBook";
    private RecordStore rs;
    
    public void open() throws RecordStoreException {
        rs = RecordStore.openRecordStore(STORE_NAME, true);
    }
    
    public int addContact(String name, String phone) throws RecordStoreException {
        ByteArrayOutputStream baos = new ByteArrayOutputStream();
        DataOutputStream dos = new DataOutputStream(baos);
        dos.writeUTF(name);
        dos.writeUTF(phone);
        return rs.addRecord(baos.toByteArray(), 0, baos.size());
    }
    
    public Contact getContact(int id) throws Exception {
        byte[] data = rs.getRecord(id);
        DataInputStream dis = new DataInputStream(new ByteArrayInputStream(data));
        return new Contact(dis.readUTF(), dis.readUTF());
    }
    
    public void listContacts(ContactHandler handler) throws RecordStoreException {
        RecordEnumeration re = rs.enumerateRecords(null, null, false);
        while (re.hasNextElement()) {
            int id = re.nextRecordId();
            handler.handle(id, getContact(id));
        }
    }
    
    public void close() throws RecordStoreException {
        rs.closeRecordStore();
    }
}

總結

RMS 是 J2ME 應用持久化的核心基礎設施。掌握 RecordStore 基本操作、RecordEnumeration 靈活查詢、序列化策略選擇與空間管理，即可構建可靠的本地資料層，支援離線操作、設定保存、快取等關鍵功能。

1. 上一篇文章： J2ME/J2EE 架構下 JSON 資料交換框架設計與實作分析
2. 下一篇文章： J2ME 網路程式設計深度解析：Generic Connection Framework 與 HTTP 實戰

J2ME

MIDP 圖片縮放實現：雙通道插值算法與性能優化對比

MIDP 1.0/2.0 均未提供圖片縮放 API，開發者需

J2ME RPG 遊戲開發：按鍵處理機制設計

為確保按鍵靈敏度與跨機型移植性，採用「記錄狀態 + 執行緒處

J2ME GCF 通用連接框架深度解析：接口體系與最佳實踐

前言：GCF 是 J2ME 網絡編程的基石 Generic

J2ME 與 MIDP 開發入門 (一)：環境建置、核心架構與 MIDlet 生命週期基石

J2ME 開發第一課：從零建置開發環境，理解 CLDC/MI