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[] candidate)
{
String s1 = new String(candidate);
If (s1.equals("XX"))
Returns true;
Else
Returns false;
}
開發電話約會簿
在這部分，我們將通過構建一個電話約會簿來說明 J2ME RMS 的功能。這個應用程序將允 許用戶設置某個日期和時間的約會，取消約會或查看已經設置好的約會列表。一個快捷屏幕 視圖如圖 2 所示。
圖 2. 工作中的電話約會簿
構成這個應用程序的各種屏幕以及屏幕元素的用戶界面元素的完整列表在與 J2ME Wireless Toolkit 一起提供的 MID 框架 API 文檔中可以得到；要獲取關於這些元素的更多 詳細信息，請查閱我早些時候給 developerWorks寫的一篇文章（請參閱下面的 參考資料部 分以獲取這兩個鏈接）。
記錄存儲可以以字節流形式存儲記錄。在我們的應用程序中，用戶輸入的日期和時間被連 接成一個字符串，轉換成字節，然後被存儲。
清單 10. 將一個新的約會添加到數據庫中
Public boolean matches(byte[] candidate)
String appt = apptName + " " + apptTime;
byte bytes[] = appt.getBytes();
rs.addRecord(bytes,0,bytes.length);
同樣，這個應用程序以字節流形式檢索記錄，然後將它轉換成一個字符串。這個字符串以 ####AAAA 格式，其中 # 表示代表時間信息的數字，AAAA 表示代表約會描述的字符。這個應 用程序解析這個字符串來獲得日期和時間信息，並以用戶所希望的格式顯示它們，比如 description - mm/dd/yyyy hh:mm AM_PM 。
清單 11. 從記錄存儲檢索一條記錄
byte b[] = rs.getRecord(j);
String str = new String(b,0,b.length);
清單 12. 解析從記錄存儲獲得的數據，然後以用戶所希望的格式顯示
if (Character.isDigit(str.charAt(i)))
at += str.charAt(i);
else
name += str.charAt(i);
time = Long.parseLong(at);
java.util.Date date = new java.util.Date(time);
java.util.Calendar rightNow = java.util.Calendar.getInstance();
rightNow.setTime(date);
String year = String.valueOf
(rightNow.get(java.util.Calendar.YEAR));
String month = String.valueOf
(rightNow.get(java.util.Calendar.MONTH) + 1);
String day = String.valueOf
(rightNow.get(java.util.Calendar.DATE));
String displayName = name
+ "-" + year + " " + day;
用戶被允許從記錄存儲中選擇某種約會以及將它們從記錄存儲中刪除。因為為了維持記錄 中原始的順序所刪除的 recordId 不能重用，所以這個記錄通過特有的字符串模式標記為無 效。
清單 13. 將一條記錄標記為已刪除
String deactive = "@";
byte b[] = deactive.getBytes();
rs.setRecord(m+1, b,0,b.length);
當這個應用程序顯示一個約會列表時，它檢測那些無效記錄的字符串模式，然後跳過它們 。
清單 14. 跳過無效記錄
if (!(str.startsWith("@")))
{
// Record is valid
}
else
{
// Record is invalid.
}
這個應用程序的一個重要的方面是用戶界面。各種屏幕有下面這些：
歡迎表單：歡迎表單顯示一個已經設置好的約會列表，如果沒有設置約會，則通知用戶。 它提供繼續或退出這個應用程序的各種選項。
菜單表單：菜單表單給用戶提供查看約會、設置新約會或取消約會等選項。
顯示表單：顯示表單顯示已經設置好的約會列表。
設置表單：設置表單提供一個日期選擇域和一個輸入文本域，以提供新約會的詳細信息。 當用戶選擇保存時，這條信息被存儲到數據庫中。
刪除表單：刪除表單列出一組約會，並提供選擇一個或多個的選項。如果用戶選擇刪除， 所選擇的這組約會在記錄存儲中被標記為無效。
應用程序實現使自己能夠響應各種事件的 CommandListener 和 ItemStateListener 接口 。 ItemStateListener 使應用程序能夠接收指示下面這些東西的內部狀態的改變的事件：
DateField ，一個顯示日期和時間的可編輯組件
TextField ，一個可編輯文本組件
ChoiceGroup ，一組可選擇的元素
清單 15. 從屏幕獲取值
// The date value is set to a variable when the
// DateField item is changed
if (item == apptDate)
{
date = apptDate.getDate();
apptTime = String.valueOf(date.getTime());
}
// The name of appointment is set to a variable
//when the name input field is changed
if (item == apptField)
{
apptName = apptField.getString();
}
// If the ChoiceGroup item state on Delete form is
//changed, it sets an array of appointments selected for deletion
if (item == cg)
{
cg.getSelectedFlags(deleted);
}
清單 16包含這個樣本應用程序的完整清單。請參閱 參考資料部分中我以前的一篇關於 J2ME 的文章，以獲取關於下載將使您能夠在桌面上運行這個程序的設備仿真器的指導。
總結
在本文中，我們講述了 MID 應用程序持久存儲和檢索數據的能力；這種機制根據簡單的 面向記錄的數據庫建模。J2ME API javax.microedition.rms 包提供了一個開發者的方法和 接口寶庫，從而可以利用 MID 應用程序的這種獨特功能。現在，您應該能夠將數據存儲集成 到您自己的微型 Java 應用程序中了。
