J2ME 記錄管理系統 (RMS) 完整指南

前言

行動資訊裝置配置文件 (MIDP) 為 Java ME 應用程式提供了一種跨越多次啟動的持久化資料儲存機制。這種以記錄為導向的簡易資料庫模型，稱為記錄管理系統 (Record Management System，RMS)。本文將深入解析 RMS 的核心架構、API 操作，並透過一個電話記事本範例展示實際應用。

RMS 核心架構

記錄存儲

RMS 由多個記錄存儲組成，每個記錄存儲可視為一個記錄集合，能在 MIDlet 多次啟動間持久存在。裝置平台負責在正常操作（含重啟、換電池）過程中保護記錄存儲的完整性。記錄存儲建立於平台相關的非易失性記憶體中，不直接對 MIDlet 公開，RMS 類別透過平台原生代碼呼叫標準 OS 資料管理函式執行實際資料庫操作。

原子性與同步

所有單一記錄存儲操作皆為原子性、同步且序列化，確保多執行緒存取不會導致資料損毀。每個記錄存儲擁有時間戳記（最後修改時間）與版本號（整數，每次修改遞增），兩者對同步機制極具參考價值。

多執行緒考量

當 MIDlet 使用多執行緒存取同一記錄存儲，開發者必須自行協調存取；平台若嘗試同步多執行緒操作，則需確保 MIDlet 與同步引擎間對記錄存儲的互斥存取。

RecordStore 核心 API

開啟與關閉記錄存儲

// 開啟或建立名為 "MyAppointments" 的記錄存儲
RecordStore rs = RecordStore.openRecordStore("MyAppointments", true);

// 作業完成後關閉
rs.closeRecordStore();

刪除記錄存儲

RecordStore.deleteRecordStore("MyAppointments");

新增、讀取、更新、刪除記錄

每筆記錄為位元組陣列，擁有唯一整數識別碼 (recordId)。

// 新增記錄
String appt = "新記錄";
byte[] data = appt.getBytes();
int recordId = rs.addRecord(data, 0, data.length);

// 讀取記錄（兩種方式）
byte[] buffer = new byte[100];
int len = rs.getRecord(recordId, buffer, 0);
// 或
byte[] dataCopy = rs.getRecord(recordId);

// 更新記錄
String updated = "更新記錄";
byte[] newData = updated.getBytes();
rs.setRecord(recordId, newData, 0, newData.length);

// 刪除記錄（recordId 不會被重複使用）
rs.deleteRecord(recordId);

資料查詢與排序

RecordComparator：自訂排序邏輯

實作 RecordComparator 介面的 compare(byte[] rec1, byte[] rec2) 方法，回傳 PRECEDES、FOLLOWS 或 EQUIVALENT 決定兩筆記錄相對順序。

RecordEnumeration：列舉記錄

RecordEnumeration 依比較器順序（或無比較器時為未定義順序）迭代記錄，支援可選的 RecordFilter 過濾特定記錄。

// 取得列舉器（無過濾、無排序、不保持最新快照）
RecordEnumeration re = rs.enumerateRecords(null, null, false);
while (re.hasNextElement()) {
    byte[] rec = re.nextRecord();
    // 處理記錄
}

RecordFilter：過濾記錄

實作 RecordFilter 介面的 matches(byte[] candidate) 方法，回傳 true 表示保留該記錄。

實戰範例：電話記事本

資料儲存格式

將日期時間與事項描述串接為字串，轉為位元組陣列儲存。讀取時解析字串，格式化顯示（如 description - yyyy/MM/dd HH:mm）。

刪除策略

因 recordId 刪除後不重用，採用標記法：將記錄內容改為特定字串（如 "@"），列表顯示時跳過此標記。

使用者介面架構

• 歡迎表單：顯示記事列表，提供繼續/退出選項
• 選單表單：新增、檢視、刪除記事
• 顯示表單：列出所有有效記事
• 設定表單：日期選擇器 + 文字輸入欄
• 刪除表單：核取方塊選擇多筆記事標記刪除

實作 CommandListener 與 ItemStateListener 處理事件與元件狀態變更。

總結

J2ME RMS 為 MIDlet 提供了輕量級持久化儲存能力，javax.microedition.rms 套件完整封裝了記錄存儲管理、記錄 CRUD、排序列舉與過濾功能。掌握這些 API，即可為行動應用加入可靠的本地資料儲存。