RMS从入门到精通

Record Management System是J2ME的一个重要的子系统，目的是实现应用程序本地数据的持久性存储。目前支持文件系统的移动信息设备还有限，因此Record Management System是J2ME开发人员实现本地数据存储的首选途径。本文的目的就是全面的介绍Record Management System的知识。

      顾名思义Record Management System是管理数据的系统，Record是系统中最重要的实体。在移动设备存储空间存储的并不是字段，而是字节数组。Mobile Infomation Device Profile(MIDP)规范中并没有规定什么样的数据才能存储为记录，事实上记录是任何可以被字节数组表示的数据，例如图片、文本等。Record Management System的职责是存储和唯一标识记录，而表示数据的任务是由应用程序来完成的，因此J2ME的开发人员往往要花费更多的精力来处理存储空间中的数据。这样做的目的是简化MIDP的实现，使得J2ME的子系统尽量的小巧、灵活。毕竟移动信息设备的存储空间和处理器的能力都有限。

      Record Store是一系列记录的有序集合，记录是不能单独存在的，必须属于Record Store。Record Store保证记录的读写操作都是原子的，数据不会被破坏。在API中Record Store是由javax.microedition.rms.RecordStore实现的，关于RecordStore的具体操作在接下来的文章中会有详细的介绍。

      MIDP规范中说明移动信息设备要提供至少8K的非易失性存储空间给应用程序来实现数据的持久性存储。但是不同的设备提供的空间并不相同。如果MIDlet suite使用了Record Management System，那么它必须在MANIFEST文件和JAD文件中通过设置MIDlet-Data-Size来说明它所需要的最小的数据存储空间，单位是字节，例如MIDlet-Data-Size：8192。如果你的值超过了移动设备规定的最大值那么你的应用程序将不能正确安装。这个值并不是移动设备真正提供给应用程序的最大Record Management System的存储空间，往往要大一些，因此开发人员应该避免把应用程序需要的最小存储空间设置的过大，必要的时候应该参考相关设备的说明手册。在非易失性存储空间内读写数据往往速度会比较慢，因此针对频繁访问的数据最好提供缓存的机制来提供性能。Record Management System的读写操作是线程安全的，但是由于Record Store是被整个MIDlet suite共享的，所以如果不同MIDlet上运行的线程操作Record Store的时候，我们应该进行必要的线程同步，避免数据被破坏。

      MIDP1.0和MIDP2.0中关于Record Management System的实现有些不同，在同一个MIDlet suite里面的MIDlets可以相互访问彼此的Record Store。但是在MIDP1.0的实现中，并没有提供在不同MIDlet suite之间共享Record Store的机制。在MIDP2.0中提供的了新的API来解决不同MIDlet suite之间共享Record Store的问题，在创建Record Store的时候通过授权模式和读写控制参数来进行共享机制的管理，我将在下篇文章中进行详细的介绍。

      加强对Record Management System的理解的最好的办法就是进行实际的开发，在进行开发中我发现并不是所有移动设备的MIDP实现都准确无误。当我用getSizeAvaliable()方法查询Nokia6108的可用Record Store空间的时候得到的数值是超过1M字节，但是当我写入40K的数据的时候就出现了RecordStoreFullException异常，因此我编写了一个自动测试手机Record Store最大存储空间的软件。原理是每隔一定时间例如100-500毫秒向Record Store内写入1K字节的数据，当抛出存储空间已满的异常的时候就可以得到最大值了，精确单位为K字节。下面是程序的源代码和JAD文件的内容，开发平台为Eclipse3.0RC2+EclipseME0.4.1+Wtk2.1+J2SDK1.4.2._03,在真机Nokia 6108上测试通过并显示最大值为31K。（请不要在模拟器上进行测试，那样结果没有意义）

      总结：本文只是带领读者对Record Management System进行了大概的了解，虽然在文章最后提供了一个应用程序。但是并没有深入分析如何使用Record Management System。在接下来的文章中我们会深入分析javax.microedition.rms包中的类，重点是如何使用RecordStore类。

import javax.microedition.lcdui.Alert;
import javax.microedition.lcdui.AlertType;
import javax.microedition.lcdui.Display;
import javax.microedition.midlet.MIDlet;
import javax.microedition.midlet.MIDletStateChangeException;
import javax.microedition.rms.RecordStoreException;


public class RMSAnalyzer extends MIDlet
{

    private Display display;
    private CounterCanvas counterCanvas;
    private Alert alert;


    protected void startApp() throws MIDletStateChangeException
    {

        display = Display.getDisplay(RMSAnalyzer.this);
        alert = new Alert("错误提示");
        try
        {
            String interval = this.getAppProperty("INTER");
            int t = Integer.parseInt(interval);
            counterCanvas = new CounterCanvas(t, 1, this);
        } 
        catch (RecordStoreException e)
        {
            this.showAlertError(e.getMessage());
        }
        display.setCurrent(counterCanvas);

    }
    
    public Display getDisplay()
    {
        return display;
    }


    protected void pauseApp()
    {
        

    }


    protected void destroyApp(boolean arg0) throws MIDletStateChangeException
    {
        
    }

    public void showAlertError(String message)
    {
        alert.setString(message);
        alert.setType(AlertType.ERROR);
        alert.setTimeout(3000);
        display.setCurrent(alert);

    }

}

import java.util.Timer;
import java.util.TimerTask;

import javax.microedition.lcdui.Canvas;
import javax.microedition.lcdui.Command;
import javax.microedition.lcdui.CommandListener;
import javax.microedition.lcdui.Displayable;
import javax.microedition.lcdui.Graphics;
import javax.microedition.midlet.MIDletStateChangeException;
import javax.microedition.rms.*;


public class CounterCanvas extends Canvas implements CommandListener
{

    private RMSModel model;
    private RMSAnalyzer RMSanalyzer;
    private int interTime;
    private int counter;
    private boolean go = true;
    public static Command backCommand = new Command("退出", Command.EXIT, 3);
    public static final int INC = 1;
    public final Timer timer = new Timer();

    public CounterCanvas(int interTime, int base, RMSAnalyzer rmsa)
            throws RecordStoreException
    {
        this.interTime = interTime;
        this.counter = base;
        this.RMSanalyzer = rmsa;
        model = new RMSModel(base, RMSanalyzer);
        this.addCommand(backCommand);
        this.setCommandListener(this);

        TimerTask timerTask = new TimerTask()
        {
            public void run()
            {

                try
                {
                    model.writeRecord(INC);
                    counter++;
                } catch (RecordStoreFullException e)
                {
                    go = false;
                    model.deleteRMS();
                    timer.cancel();
                } catch (RecordStoreException e)
                {
                    model.deleteRMS();
                    RMSanalyzer.showAlertError(e.getMessage());
                    timer.cancel();
                }
                repaint();

            }
        };

        timer.schedule(timerTask, 1000, interTime);

    }


    public void setCounter(int counter)
    {
        this.counter = counter;
    }


    public void setInterTime(int interTime)
    {
        this.interTime = interTime;
    }


    protected void paint(Graphics arg0)
    {

        int SCREEN_WIDTH = this.getWidth();
        int SCREEN_HEIGHT = this.getHeight();
        arg0.drawRect(SCREEN_WIDTH / 10, SCREEN_HEIGHT / 2,
                SCREEN_WIDTH * 4 / 5, 10);
        if(RMSanalyzer.getDisplay().isColor())
        {
            arg0.setColor(128, 128, 255);
        }
        arg0.fillRect(SCREEN_WIDTH / 10, SCREEN_HEIGHT / 2, counter, 10);
        if (!go)
            arg0.drawString("最大值：" + counter+"K字节", 0, 0, Graphics.TOP
                    | Graphics.LEFT);

    }

    public void commandAction(Command arg0, Displayable arg1)
    {

        if (arg0 == backCommand)
        {
            try
            {
                model.deleteRMS();
                RMSanalyzer.destroyApp(false);
                RMSanalyzer.notifyDestroyed();
            } catch (MIDletStateChangeException e)
            {

            }
        }

    }

}


import javax.microedition.rms.*;

public class RMSModel
{
    public static final int K = 1024;
    private RecordStore rs;
    private int baseCount;
    private RMSAnalyzer RMSanalyzer;
    public static final String name = "test";

    public RMSModel(int baseCount, RMSAnalyzer rmsa)
            throws RecordStoreException
    {
        this.baseCount = baseCount;
        this.RMSanalyzer = rmsa;
        if (rs == null)
        {
            rs = RecordStore.openRecordStore(name, true);
            writeRecord(baseCount);
        }
    }

    public void writeRecord(int count) throws RecordStoreException
    {
        byte[] data = new byte[count * K];
        for (int i = 0; i < count; i++)
        {
            data[i] = 1;
        }
        rs.addRecord(data, 0, count * K);
    }

    public void deleteRMS()
    {
        try
        {
            rs.closeRecordStore();
            RecordStore.deleteRecordStore(name);
        } catch (RecordStoreException e)
        {
            RMSanalyzer.showAlertError(e.getMessage());
        }
    }
}

RMSAnalyzer.jad

MIDlet-Jar-Size: 5293
MIDlet-1: RMSAnalyzer,,RMSAnalyzer
MIDlet-Jar-URL: RMSAnalyzer.jar
MicroEdition-Configuration: CLDC-1.0
MIDlet-Version: 1.0.0
MIDlet-Name: RMSAnalyzer
MIDlet-Data-Size: 8192
MIDlet-Vendor: Midlet Suite Vendor
MicroEdition-Profile: MIDP-1.0
INTER: 100

在系列之一中，我们着重讲述了Record Management System的基础知识。在介绍如何使用Record Management System之前，我想首先介绍一下Java IO以及在J2ME平台实现序列化的内容，无论对Record Management System还是MIDP中的通用联网框架来说，上述内容都是非常重要的。

    在CLDC中定义的Java IO是非常短小精悍的，但是也提供了足够的类来完成我们的IO操作。由于和J2SE的实现是通用的，因此你可以使用J2ME和J2SE或者J2EE平台进行通信。比如通过联网和servlet进行通信。在Record Management System中我们主要使用的类是ByteArrayInputStream、ByteArrayOutputStream、DataInputStream和DataOutputStream。前面两个是基于字节的，ByteArrayInputStream的作用是把字节数组转换成流而ByteArrayOutputStream的作用是把内存缓冲区内的数据转换成字节。后面两个类是基于java基本数据类型和String操作的。通常他们把前面两个类作为参数传送给构造器，这样他们就可以对基本数据类型以及String进行读写操作了。值得注意的一点是ByteArrayOutputStream的toByteArray()方法是把内存中的数据进行复制返回，这样的话多浪费了一份内存，为了更有效的使用有限的存储空间你可以扩展ByteArrayOutputSteam类然后提供getByteArray()方法，下面是例子：
public class MyByteArrayOutputStream extends ByteArrayOutputStream
{
  public byte[] getByteArray()
  {
    return buf; 
  } 
}

    在J2ME中并没有提供对象序列化的机制，但是我们可以自己实现它。请考虑下面这个类：

public class Bank
{
 private String bankName;
 private String phone;
 private int employeeNum;
 
 public Bank(){}
 
 public Bank(String aBankName,String aPhone,int aEmployeeNum)
 {
  this.bankName = aBankName;
  this.phone = aPhone;
  this.employeeNum = aEmployeeNum; 
 } 
 
 public String getBankName()
 {
  return bankName !=null?bankName:""; 
 }
 
 public String getPhone()
 {
  return phone!=null?phone:""; 
 }
 
 public int getEmployeeNum()
 {
  return employeeNum; 
 }

}
我们添加两个方法到这个类来实现对象序列化。如下所示：
public class Bank
{
 private String bankName;
 private String phone;
 private int employeeNum;
 
 public Bank(){}
 
 public Bank(String aBankName,String aPhone,int aEmployeeNum)
 {
  this.bankName = aBankName;
  this.phone = aPhone;
  this.employeeNum = aEmployeeNum; 
 } 
 
 public String getBankName()
 {
  return bankName !=null?bankName:""; 
 }
 
 public String getPhone()
 {
  return phone!=null?phone:""; 
 }
 
 public int getEmployeeNum()
 {
  return employeeNum; 
 }
 
 public byte[] serialize() throws IOException
 {
  ByteArrayOutputStream bos = new ByteArrayOutputStream();
  DataOutputStream dos = new DataOutputStream(bos);
  
  dos.writeUTF(getBankName());
  dos.writeUTF(getPhone());
  dos.writeInt(getEmployeeNum());
  dos.flush();
  
  return bos.toByteArray(); 
 }
 
 public Bank deserialize(byte[] data) throws IOException
 {
  ByteArrayInputStream bis = new ByteArrayInputStream(data);
  DataInputStream dis = new DataInputStream(bis);
  
  Bank myBank = new Bank();
  myBank.bankName = dis.readUTF();
  myBank.phone = dis.readUTF();
  myBank.employeeNum = dis.readInt();
  
  return myBank; 
 }
}
这样我们就实现了对象的序列化，使用起来也非常简单。序列化和反序列化的操作分别如下面所示：
Bank aBank = .....;
RecordStore rs = .....;
try
{
 byte[] data = aBank.serialize();
 rs.addRecord(data,0,data.length); 
}

catch(IOException e)
{
 //do something 
}

catch(RecordStoreException e)
{
 //do something 
}
????????????????????????????

byte[] data = ..........;
Bank aBank = null;
try
{
 aBank = Bank.deserialize(data); 
}
catch(IOException e)
{
 
}
    值得注意的一点是在Bank类中我们的成员都是基本数据类型以及String类型，并不存在指向其他对象的引用，这是最理想也是最简单的情况，事实上我们在J2ME中设计序列化的类的时候也应该尽量这样做，避免不必要得麻烦。