RMS Basics in J2ME
By: Daniel Malcolm
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){}
}
}
Archived Comments
1. the code is showing Error. Pls correct it and post it here
View Tutorial By: Mathew Emmanuel at 2015-05-30 11:10:32
2. Easy to understand... thank u....
View Tutorial By: saranya at 2013-02-11 10:37:07
3. what is the output
View Tutorial By: Raja at 2012-12-28 11:47:48
4. very nice example i really like it
View Tutorial By: radha at 2012-03-15 17:50:52
5. this is really helpful example for Learning RMS in J2ME
View Tutorial By: Ahmed Nawaz Mari at 2011-06-30 05:29:18
6. How can i update status 1 and 0 in RMS ?
and then update this status in mysql database also ?
View Tutorial By: maaz at 2011-06-16 02:54:28
7. How can i update status 1 and 0 in RMS ?
and then update this status in mysql database also ?
View Tutorial By: maaz at 2011-06-16 02:53:50
8. very nice...
View Tutorial By: hiral at 2011-02-07 00:10:56
9. can some one put an example of upgrading records with streams?
or send me the example
View Tutorial By: paul at 2011-01-29 17:51:26
10. can anybody hp me how to create a rms database in j2me and how it worls
View Tutorial By: contractornimesh at 2011-01-04 00:12:08
11. very brief and easy to understand description of RMS
View Tutorial By: moona at 2010-05-26 22:49:26
12. i will make to try for rms :)
View Tutorial By: sebo at 2010-05-20 07:38:28
13. hie
can u plz tell how i maintain my rms for storing my incoming message in milet suite???it
View Tutorial By: diya at 2010-04-30 01:38:06
14. I want to enter data from a textbox to recordstore and print it again on the emulator screen Please
View Tutorial By: Rahul Maurya at 2010-04-10 01:04:51
15. can you give me tutorial how to copy phonebook to RMS???please :)
View Tutorial By: rico at 2010-04-04 21:07:57
16. Thanks, it was useful explanation
View Tutorial By: Avvoltoio at 2009-10-06 08:38:28
17. I will try
View Tutorial By: bridges at 2009-09-06 22:09:46
18. If i delete a record, will that recId be replaced by next one.
more clearly, if the user dele
View Tutorial By: faisal at 2009-06-08 21:36:29
19. hjhg
View Tutorial By: nbmnb at 2008-10-09 12:54:26
20. Hi hardik,
RMS sample program is available at <a href="http://www.java-sample
View Tutorial By: Daniel Malcolm at 2008-03-29 19:46:18
21. rms programe
View Tutorial By: hardik at 2008-03-28 23:06:58
22. Just what i was looking for. tku.
View Tutorial By: Chow Lim at 2008-03-21 01:46:52
Comment on this tutorial
- Data Science
- Android
- AJAX
- ASP.net
- C
- C++
- C#
- Cocoa
- Cloud Computing
- HTML5
- Java
- Javascript
- JSF
- JSP
- J2ME
- Java Beans
- EJB
- JDBC
- Linux
- Mac OS X
- iPhone
- MySQL
- Office 365
- Perl
- PHP
- Python
- Ruby
- VB.net
- Hibernate
- Struts
- SAP
- Trends
- Tech Reviews
- WebServices
- XML
- Certification
- Interview
categories
Related Tutorials
Code sample to Send SMS from a J2ME application.
Adding your own Application icon for your J2ME application (jar file)
Play a multimedia file in J2ME Program (Audio/Video) using MMAPI
Using HttpConnection in J2ME (Retrieve web content from a website to a phone)
Using HTTP vs UDP vs Socket in J2ME
RMSCookieConnector - Using Cookies in J2ME
Client Server in J2ME (Socket Programming sample)
Datagrams in J2ME (UDP Programming sample)
POST UTF-8 encoded data to the server in J2ME
Using alerts and tickers in J2ME
Using List to create a Menu and Menu items in J2ME
lists, forms, choices, gauges, text fields, text boxes in J2ME
Timer and TimerTask example in J2ME