核心技巧:J2ME中RMS的利用解析

J2ME中RMS的應用解析

在J2ME中，RMS作為唯一的永久性存儲工具，其重要性是不問可知的。但是許多剛剛開端學習J2ME的新人總是埋怨在這方面的材料很少，或者是針對性不強。因此，我想把自己在這方面的一些學習心得和大家交換一下。
RMS即Record Manager System，在手機利用中經常作為得分記錄、游戲信息存儲等的工具應用。
RMS的應用可以分為兩個部分：一、單一記錄的結構；二、RecordStore的應用和把持。下面就這兩方面進行具體闡明。
一、單一記錄的結構。我們在存儲記錄時可能需要記錄許多類似的條目，在這裡我們可以把這種結構看成數據庫，我們在這一步就是要結構數據庫中的一行，即單一記錄的結構。程序的源碼如下：
package com.cuilichen.usual;

import Java.io.ByteArrayInputStream;//要應用到的各種輸進輸出流
import Java.io.ByteArrayOutputStream;
import Java.io.DataInputStream;
import Java.io.DataOutputStream;

public class Appointment
{// 單一記錄的類名
 private int int1; //

 private int int2; //

 private long long1;

 private String str1; // str1作為保留字段，記錄檢索的要害字

 private String str2; //

 private String str3; //

 private boolean WroteFlag; //

 public Appointment()
 {
 }

 public Appointment(int _int1, int _int2, long _long1, String _str1,
   String _str2, String _str3, boolean _WroteFlag)
 {
  this.int1 = _int1; // 寫進RMS的結構函數
  this.int2 = _int2;
  this.long1 = _long1;
  this.str1 = _str1;
  this.str2 = _str2;
  this.str3 = _str3;
  this.WroteFlag = _WroteFlag;
 }

 public Appointment(byte[] rec)
 {
  initAppointmnet(rec); // 讀取RMS內容的結構函數
 }

 public byte[] toBytes()
 { // 寫成字節

  byte[] data = null;

  try
  {
   ByteArrayOutputStream baos = new ByteArrayOutputStream();
   DataOutputStream DOS = new DataOutputStream(baos);
   DOS.writeInt(int1);
   DOS.writeInt(int2);
   DOS.writeLong(long1);
   DOS.writeUTF(str1);
   DOS.writeUTF(str2);
   DOS.writeUTF(str3);
   DOS.writeBoolean(WroteFlag);
   data = baos.toByteArray();
   baos.close();
   DOS.close();
  } catch (Exception e)
  {
   e.printStackTrace();
  }
  return data;
 }

 public void initAppointmnet(byte[] rec)

 { // 從字節讀取內容

  ByteArrayInputStream bais = new ByteArrayInputStream(rec);
  DataInputStream dis = new DataInputStream(bais);

  try
  {
   int1 = dis.readInt();
   int2 = dis.readInt();
   long1 = dis.readLong();
   str1 = dis.readUTF();
   str2 = dis.readUTF();
   str3 = dis.readUTF();
   WroteFlag = dis.readBoolean();
  } catch (Exception e)
  {
   e.printStackTrace();
  }
 }

 public int getInt1()
 { // int
  return int1;
 }

 public int getInt2()
 {
  return int2;
 }

 public long getLong1()
 {
  return long1;
 }

 public String getStr1()
 { // String
  return str1;
 }

 public String getStr2()
 { // String
  return str2;
 }

 public String getStr3()
 {
  return str3;
 }

 public boolean getWroteFlag()
 { //返回寫進標記
  return WroteFlag;
 }
}
這個類的應用保證了我們在應用流時，內容的寫進和輸出。當然，就如同數據庫表的設計一樣，我們可以任意對每一條記錄增加或減少字段，在上面的類中我只應用了int1，int2，long1，str1，str2，str3和WroteFlag一共7個字段。

二、RecordStore的把持。類RMS如下：
package com.cuilichen.usual;

import Javax.microedition.rms.RecordEnumeration;
import Javax.microedition.rms.RecordStore;

public class RMS {
 public static final int Int1 = 0;//各個字段的默認數值
 public static final int Int2 = 0;
 public static final long Long1 = 0;
 public static final String Str1 = "";
 public static final String Str2 = "";
 public static final String Str3 = "";

 public static boolean addRecord(String name, int int1, int int2,//添加記錄
   long long1, String str1, String str2, String str3, boolean b) {
  boolean success = false;

  try {
   RecordStore rs = RecordStore.openRecordStore(name, true);
   Appointment app = new Appointment(int1, int2, long1, str1, str2,str3, b);
//   既然str1作為保留字段，我們在這裡就要如此把持：例如int1為我們設定的要害字，那麼str1 = Integer.toString(int1);
   byte[] data = app.toBytes();
   rs.addRecord(data, 0, data.length);
   rs.closeRecordStore();
   success = true;
  } catch (Exception e) {

   e.printStackTrace();
  }
  return success;
 }
 public static int getNumOfRecords(String name) {//得到RMS中記錄的條數
  try {
   RecordStore rs = RecordStore.openRecordStore(name, true);

   return rs.getNumRecords();
  } catch (Exception e) {
   return 0;
  }
 }

 public static Appointment[] getRecords(String name) {//取得RMS中的所有記錄
  Appointment[] result = { };

  try {
   RecordStore rs = RecordStore.openRecordStore(name, false);
   RecordEnumeration re = rs.enumerateRecords(null, null, false);
   result = new Appointment[rs.getNumRecords()];

   for (int i = 0; i < result.length; i++) {
    int j = re.previousRecordId();
    Appointment app = new Appointment(rs.getRecord(j));
    result[i] = app;

//    System.out.println("app["+i+"] "+app.getStr2());
   }

   rs.closeRecordStore();
  } catch (Exception e) {
  }

  return result;
 }

 public static Appointment getRecord(String name, int j) {//根據記錄編號（參數 int j）取得一條記錄
  Appointment result = new Appointment();

  try {
   RecordStore rs = RecordStore.openRecordStore(name, false);
   RecordEnumeration re = rs.enumerateRecords(null, null, false);
   result = new Appointment(rs.getRecord(j));
   rs.closeRecordStore();
  } catch (Exception e) {
  }

  return result;
 }

 public static int getIndex(String name, String content) {//得到記錄號int j，這裡需要應用保留字段str1
  RecordStore rs = null;
  RecordEnumeration re = null;

  try {
   rs = RecordStore.openRecordStore(name, false); //open
   re = rs.enumerateRecords(null, null, false); //enumeration

   for (int i = 0; i < RMS.getNumOfRecords(name); i++) {
    int j = re.nextRecordId();
    Appointment app = new Appointment(rs.getRecord(j));

    if (app.getStr1().equals(content)) {
     return j;
    }
   }
  } catch (Exception e) {
  }
  return 1;
 }

public static boolean setRecord(String name, int id, int int1, int int2,//設置記錄號為id的記錄
long long1, String str1, String str2, String str3, boolean b) {

 boolean success = false;
 RecordStore rs = null;
 RecordEnumeration re = null;

 try {
  rs = RecordStore.openRecordStore(name, false); //open
  re = rs.enumerateRecords(null, null, false); //enumeration

  Appointment app = new Appointment(int1, int2, long1, str1, str2, str3, b);
//  str1作為保留字段，在這裡如此把持：例如若int1為我們設定的要害字，那麼str1 = Integer.toString(int1);

  byte[] data = app.toBytes();
  rs.setRecord(id, data, 0, data.length);
  success = true;
  rs.closeRecordStore();
 } catch (Exception e) {
 }

 return success;
}
}

在這個類中，我沒有將各個Exception向外拋出，一般來說這樣作是分歧適的，它違背了Java的異常處理機制。但是在我應用這個類的各個J2ME程序中，它是可以勝任的，所以也就沒有進行進一步的修正。
有了以上的兩個類和你對RMS的懂得，在程序中，你就可以順暢的應用RMS了。
比如在MIDlet開端時，如下把持（增加記錄）：
protected void startApp() throws MIDletStateChangeException {
 if (RMS.getNumOfRecords(rsName) = = 0) {//rsName在前面已經聲明了。String rsName＝“MyRMS”；
  for (int i = 0; i <6; i++) {
   RMS.addRecord(rsName, RMS.Int1, i, RMS.Long1, Integer . toString(i), RMS.Str2, "1234567890123456789",false);
  }
 }它就在RMS中增加了6條記錄，其中int1，long1，str2，WroteFlag都沒有應用，我們只是應用int2，str1（作為保留字段）和str3。
}