RMS Basics in J2ME

By: Daniel Malcolm Printer Friendly Format    


Each MIDP-compliant device maintains a dedicated area of device memory for persistent application data storage. MIDlet data stored here persists across multiple invocations of the applications that use it. Both the physical location and the size of the data store are device dependent.

The RMS API abstracts the device-dependent details of the storage area and access to those details, and it provides a uniform mechanism to create, destroy, and modify data. This ensures portability of MIDlets to different devices.

RMS Data Storage Model

The RMS supports the creation and management of multiple record stores, shown in Figure below. A record store is a database whose central abstraction is the record. Each record store consists of zero or more records. A record store name is case sensitive and can consist of a maximum of 32 Unicode characters. A record store is created by a MIDlet.


MIDlets within the same MIDlet suite can share one another's record stores. A MIDlet suite defines a name space for record stores; a record store must have a unique name within a MIDlet suite. The same name can be used in different MIDlet suites, however.

MIDlets can list the names of all the record stores available to them. They can also determine the amount of free space available for storing data. Incidentally, you should be aware that when all MIDlets in a MIDlet suite are removed from a device, the device AMS removes all record stores in the MIDlet suite namespace. All persistent data will be lost. For this reason, you should consider designing applications to include a warning or confirmation that requires users to acknowledge that they understand the potential loss of data when they remove applications. Applications might also include a mechanism to back up the records in a data store to another location. This might require server side support.

The RMS defines the following conceptual operations on an individual record store:

• Add a record.
• Delete a record.
• Change a record.
• Look up (retrieve) a record.
• Enumerate all records.

Records are uniquely identified by a record ID, which is the only primary key type supported. The type of all record ids is the Java built-in type int. The RMS has no support for features—such as tables, rows, columns, data types, and so forth—that are present in relational databases.
 

Records

A record is a byte array of type byte []. The RMS doesn't support the definition or formatting of fields within a record. Your application must define the data elements within a record and their format.

The reader of a record, therefore, must be aware of the format that was used to write the record. Because a record is simply a byte array, applications must convert data from arbitrary types to bytes when writing records, and they must convert from bytes to those types upon reading the data.
 

Here is a sample code that shows simple read and write of RMS in J2ME

import javax.microedition.midlet.*;
import javax.microedition.lcdui.*;
import javax.microedition.io.*;
import javax.microedition.rms.*;

public class ReadWriteRMS extends MIDlet{
  private RecordStore rs = null;
  static final String REC_STORE = "ReadWriteRMS";

  public void startApp(){
    openRecStore();
    writeRecord("Core J2ME Technology");
    writeRecord("J2ME Wireless Toolkit");    
    readRecords();
    closeRecStore();
    deleteRecStore(); 
  }

  public void pauseApp(){}

  public void destroyApp(boolean unconditional){
    notifyDestroyed();
  }

  public void openRecStore(){
    try{
      rs = RecordStore.openRecordStore(REC_STORE, true );
    }catch (Exception e){}
  }    

  public void closeRecStore(){
    try{
      rs.closeRecordStore();
    }catch (Exception e){}
  }

  public void deleteRecStore(){
    if (RecordStore.listRecordStores() != null){
      try{
        RecordStore.deleteRecordStore(REC_STORE);
      }catch (Exception e){}
    }      
  }

  public void writeRecord(String str){
    byte[] rec = str.getBytes();
    try{
      rs.addRecord(rec, 0, rec.length);
    }catch (Exception e){}
  }

  public void readRecords(){
    try{
      byte[] recData = new byte[5]; 
      int len;
      
      for(int i = 1; i <= rs.getNumRecords(); i++){
        if(rs.getRecordSize(i) > recData.length){
          recData = new byte[rs.getRecordSize(i)];
        }
        len = rs.getRecord(i, recData, 0);
        System.out.println("------------------------------");
        System.out.println("Record " + i + " : " + new String(recData, 0, len));
        System.out.println("------------------------------");                        
      }
    }catch (Exception e){}
  }
}


Ask a Question



Most Viewed Articles (in J2ME )

Latest Articles (in J2ME)

Comment on this tutorial

Ask a Question

Subscribe to Tutorials

Related Tutorials

Archived Comments

1. rms programe
View Tutorial          By: hardik at 2008-03-28 23:06:58

2. Hi hardik,

RMS sample program is av

View Tutorial          By: Daniel Malcolm at 2008-03-29 19:46:18

3. Just what i was looking for. tku.
View Tutorial          By: Chow Lim at 2008-03-21 01:46:52

4. hjhg
View Tutorial          By: nbmnb at 2008-10-09 12:54:26

5. If i delete a record, will that recId be replaced
View Tutorial          By: faisal at 2009-06-08 21:36:29

6. I will try
View Tutorial          By: bridges at 2009-09-06 22:09:46

7. Thanks, it was useful explanation
View Tutorial          By: Avvoltoio at 2009-10-06 08:38:28

8. can you give me tutorial how to copy phonebook to
View Tutorial          By: rico at 2010-04-04 21:07:57

9. I want to enter data from a textbox to recordstor
View Tutorial          By: Rahul Maurya at 2010-04-10 01:04:51

10. hie
can u plz tell how i maintain my rms f

View Tutorial          By: diya at 2010-04-30 01:38:06

11. i will make to try for rms :)
View Tutorial          By: sebo at 2010-05-20 07:38:28

12. very brief and easy to understand description of R
View Tutorial          By: moona at 2010-05-26 22:49:26

13. can anybody hp me how to create a rms database in
View Tutorial          By: contractornimesh at 2011-01-04 00:12:08

14. can some one put an example of upgrading records w
View Tutorial          By: paul at 2011-01-29 17:51:26

15. very nice...
View Tutorial          By: hiral at 2011-02-07 00:10:56

16. How can i update status 1 and 0 in RMS ?
an

View Tutorial          By: maaz at 2011-06-16 02:53:50

17. How can i update status 1 and 0 in RMS ?
an

View Tutorial          By: maaz at 2011-06-16 02:54:28

18. this is really helpful example for Learning RMS in
View Tutorial          By: Ahmed Nawaz Mari at 2011-06-30 05:29:18

19. very nice example i really like it
View Tutorial          By: radha at 2012-03-15 17:50:52

20. what is the output
View Tutorial          By: Raja at 2012-12-28 11:47:48

21. Easy to understand... thank u....
View Tutorial          By: saranya at 2013-02-11 10:37:07

22. the code is showing Error. Pls correct it and pos
View Tutorial          By: Mathew Emmanuel at 2015-05-30 11:10:32