Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

RMS MIDlet sample app

The record managment store sample application is a MIDlet that simulates a music collection library using the RMS data structure. The RMS is a persistent storage API in Java ME.

The RMS structure provides you with a persistent data store that is Java ME based, an alternative to persistent stores that are proprietary to Research In Motion. You can use this alternative to implement a persistent store without having to register the application using the BlackBerry Signing Authority Tool.

The sample application demonstrates how to create an instance of a record store and add, change, delete, and enumerate its records.

The sample application demonstrates how to display the records stored in the RMS using the Java ME List class.

Filename

Description

RMSMidletDemo.java

  • contains the application which includes the application constructor that creates the RecordStore, initializes and adds the UI containers and components, and displays the list of CDs
  • contains the implementation of the commandAction() method, the listener for UI event
  • contains helper methods for UI display and application flow

CDdb.java

contains the class that abstracts methods to manipulate the RMS and its records

CD.java

contains the class that defines the CD object

This sample features the following classes:

javax.microedition.rms.RecordStore

This class provides methods to create and close a RecordStore object and store, change, and delete data in the RecordStore. The RecordStore stores data as a byte array.

javax.microedition.rms.RecordEnumeration

This enumerator class allows the traversal of the records that are stored in a specified RecordStore.

Install the sample application

Visit http://www.blackberry.com/go/rmssample to download the sample application.

Extract the rmsdemo.zip file.

On the taskbar, click Start > Programs > Research In Motion > BlackBerry JDE 4.7.0 > JDE.

Open the workspace that you want to add the sample application to.

In the workspace tree, right-click the project that you want to add the sample application to.

Click Add project to <workspace directory>.

In the Add project to <workspace> dialog box, browse to the folder where you extracted the sample application.

Click the RMSDemo.jdp file.

Click Open.

Run the sample application

In the workspace where you added the rmsmidletdemo project, right-click rmsmidletdemo.

Click Build project.

On the taskbar, click Start > Applications > Research in Motion > BlackBerry JDE 4.7.0 > Device Simulator.

On the Home screen of the BlackBerry Smartphone Simulator, click the Downloads folder.

Click the RMS Demo icon.