Package javax.microedition.rms

모바일 정보 장치 프로필은 MIDlet이 영구적으로 데이터를 저장하고 나중에 이를 검색할 수 있는 기법을 제공합니다.

See:
Description

Interface Summary

RecordComparator	두 레코드를 비교하여(구현 시 정의하는 방법으로) 일치 여부 또는 상대적 정렬 순서를 확인하는 비교기를 정의하는 인터페이스.
RecordEnumeration	양방향 레코드 저장소 Record 열거자를 표시하는 인터페이스.
RecordFilter	레코드가 일치하는지(응용 프로그램이 정의한 기준에 기반하여) 조사하는 필터를 정의하는 인터페이스.
RecordListener	레코드 저장소에서 레코드 변경/추가/삭제 이벤트를 수신하는 수신기 인터페이스

Class Summary

RecordStore

레코드 저장소를 나타내는 클래스.

Exception Summary

InvalidRecordIDException	레코드 ID가 유효하지 않아 작업이 완료될 수 없음을 표시하기 위해 발생합니다.
RecordStoreException	레코드 저장소 작업에서 일반 예외가 발생했음을 표시하기 위해 발생합니다.
RecordStoreFullException	레코드 저장 시스템 저장소가 가득 차서 작업을 완료할 수 없음을 표시하기 위해 발생합니다.
RecordStoreNotFoundException	레코드 저장소를 찾을 수 없어 작업을 완료할 수 없음을 표시하기 위해 발생합니다.
RecordStoreNotOpenException	닫힌 레코드 저장소에서 작업을 시도하였음을 표시하기 위해 발생합니다.

Package javax.microedition.rms Description

모바일 정보 장치 프로필은 MIDlet이 영구적으로 데이터를 저장하고 나중에 이를 검색할 수 있는 기법을 제공합니다. 이러한 영구적인 저장 기법은 간단한 레코드 지향의 데이터베이스를 모델로 하며 레코드 관리 시스템이라고 합니다.

영구 저장소

MIDP는 MIDlet이 데이터를 영구적으로 저장하고 나중에 이를 검색할 수 있는 기법을 제공합니다. 레코드 관리 시스템(RMS)이라는 이러한 영구 저장 기법은 간단한 레코드 지향 데이터베이스를 모델로 합니다.

레코드 저장소

레코드 저장소는 MIDlet을 여러 번 호출하는 경우에도 영구적으로 남아 있는 레코드의 모음으로 구성되어 있습니다. 플랫폼에서는 재부트, 배터리 변경 등을 포함하는 플랫폼의 정상적 사용에 대해 MIDlet 레코드 저장소의 무결성을 최대한 유지할 수 있도록 해야 합니다.

레코드 저장소는 플랫폼에 따라 다른 위치에 만들어지며 MIDlet에 제공되지 않습니다. 레코드 저장소의 이름 지정 공간은 MIDlet Suite 단위로 제어됩니다. MIDlet Suite 내의 MIDlet은 이름만 다르게 지정하면 여러 레코드 저장소를 만들 수 있습니다. MIDlet Suite가 플랫폼에서 제거될 때 MIDlet에 연관된 모든 레코드 저장소도 제거되어야 합니다. MIDlet Suite 내의 MIDlet은 서로 다른 레코드 저장소에 직접 액세스할 수 있습니다. RecordStore를 만드는 MIDlet이 이러한 권한을 제공하도록 선택하면 MIDP 2.0의 새 API가 레코드 저장소를 명시적으로 공유할 수 있습니다.

공유는 다른 MIDlet Suite의 RecordStore 이름 지정 기능과 두 개의 MIDlet Suite 인증과 관련된 액세스 가능성 규칙을 정의하여 수행됩니다.

RecordStore는 MIDlet Suite의 고유 이름과 RecordStore의 이름을 사용하여 고유하게 지정됩니다. 응용 프로그램 설명자의 MIDlet-Vendor 및 MIDlet-Name 속성이 MIDlet Suite를 식별합니다.

공유할 RecordStore를 만들 때 액세스 컨트롤이 정의됩니다. 액세스 컨트롤은 RecordStore를 열 때 적용됩니다. 액세스 모드는 다른 MIDlet Suite와 공유할 수 있거나 개인 사용을 허용합니다.

레코드 저장소 이름은 대소문자를 구분하고 최대 32자의 유니코드 문자 조합으로 구성될 수 있습니다. 레코드 저장소 이름은 주어진 MIDlet Suite 범위 내에서 고유해야 합니다. 즉 하나의 MIDlet Suite에 있는 여러 MIDlet은 동일한 이름을 갖는 레코드 저장소를 둘 이상 만들 수 없지만, 하나의 MIDlet Suite에 있는 하나의 MIDlet은 다른 MIDlet Suite의 MIDlet과 동일한 이름을 갖는 레코드 저장소를 가질 수 있습니다. 이럴 경우에도 레코드 저장소는 여전히 고유하고 구분되어 있습니다.

이 API에는 잠금 작업이 제공되지 않습니다. 레코드 저장소 구현은 모든 개별 레코드 저장소 작업이 최소 단위이고, 동기적이고, 일련화되어 있는지 확인하여 다중 액세스로 손상이 발생하지 않도록 합니다. 하지만 MIDlet이 다중 스레드를 사용하여 레코드 저장소를 액세스하면 MIDlet에서 이 액세스를 조정해야 하며, 그렇지 않은 경우 예상치 못한 결과가 발생할 수 있습니다. 예를 들어, MIDlet의 두 스레드가 같은 레코드에서 동시에 RecordStore.setRecord()를 호출한 경우 레코드 저장소는 이 두 호출을 적절하게 일련화하므로 데이터베이스 손상이 발생하지 않습니다. 하지만 이 쓰기 작업 중 하나가 이후 다른 쓰기 작업에 의해 겹쳐써지면 MIDlet에 문제가 발생할 수 있습니다. 마찬가지로, 플랫폼이 레코드 저장소의 투명한 동기화를 수행하거나 아래의 다른 액세스를 수행하면 해당 플랫폼에서 MIDlet과 동기화 엔진 사이의 레코드 저장소에 대한 배타적 액세스를 적용해야 합니다.

이 레코드 저장소 API는 시간/날짜 스탬프에 대해 System.currentTimeMillis()에서 사용하는 형식의 long형 정수를 사용합니다. 레코드 저장소는 수정된 마지막 시간을 시간 스탬프로 사용합니다. 레코드 저장소에서는 버전도 유지 관리하는 데, 버전은 레코드 저장소의 내용을 수정할 때마다 증가하는 정수입니다. 이러한 특성은 동기화 엔진뿐 아니라 다른 응용 프로그램에도 유용합니다.

레코드

레코드는 바이트 배열입니다. 개발자는 서로 다른 유형의 데이터를 바이트 배열로 압축 및 압축 해제하는 데 ByteArrayInputStream과 ByteArrayOutputStream 외에 DataInputStream과 DataOutputStream도 사용할 수 있습니다.

레코드는 주어진 레코드 저장소 내에서 정수 값인 recordId로 고유하게 식별됩니다. 이 recordId는 레코드의 기본 키로 사용됩니다. 레코드 저장소에서 만든 첫 번째 레코드의 recordId는 1이 되고 이후에 만들어지는 recordId는 계속적으로 1씩 증가합니다. 예를 들어, 두 개의 레코드가 레코드 저장소에 추가되는 경우 첫 번째 레코드의 recordId가 'n'이면 다음 레코드의 recordId는 (n+1)이 됩니다. MIDlet은 RecordEnumeration 클래스를 사용하여 다른 색인을 만들 수 있습니다.

예:

다음 예는 레코드 관리 시스템을 사용하여 게임의 최고 점수를 저장하고 검색합니다. 이 예에서 최고 점수는 별도의 레코드에 저장되고 필요할 때 RecordEnumeration을 사용하여 정렬됩니다.

import javax.microedition.rms.*;
import java.io.DataOutputStream;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
import java.io.ByteArrayInputStream;
import java.io.DataInputStream;
import java.io.EOFException;

/**
 * A class used for storing and showing game scores.
 */
public class RMSGameScores
    implements RecordFilter, RecordComparator
{
    /*
     * The RecordStore used for storing the game scores.
     */
    private RecordStore recordStore = null;

    /*
     * The player name to use when filtering.
     */
    public static String playerNameFilter = null;

    /*
     * Part of the RecordFilter interface.
     */
    public boolean matches(byte[] candidate)
	throws IllegalArgumentException
    {
	// If no filter set, nothing can match it.
	if (this.playerNameFilter == null) {
	    return false;
	}

	ByteArrayInputStream bais = new ByteArrayInputStream(candidate);
	DataInputStream inputStream = new DataInputStream(bais);
	String name = null;
	
	try {
	    int score = inputStream.readInt();
	    name = inputStream.readUTF();
	}
	catch (EOFException eofe) {
	    System.out.println(eofe);
	    eofe.printStackTrace();
	}
	catch (IOException eofe) {
	    System.out.println(eofe);
	    eofe.printStackTrace();
	}
	return (this.playerNameFilter.equals(name));
    }

    /*
     * Part of the RecordComparator interface.
     */
    public int compare(byte[] rec1, byte[] rec2)
    {
	// Construct DataInputStreams for extracting the scores from
	// the records.
	ByteArrayInputStream bais1 = new ByteArrayInputStream(rec1);
	DataInputStream inputStream1 = new DataInputStream(bais1);
	ByteArrayInputStream bais2 = new ByteArrayInputStream(rec2);
	DataInputStream inputStream2 = new DataInputStream(bais2);
	int score1 = 0;
	int score2 = 0;
	try {
	    // Extract the scores.
	    score1 = inputStream1.readInt();
	    score2 = inputStream2.readInt();
	}
	catch (EOFException eofe) {
	    System.out.println(eofe);
	    eofe.printStackTrace();
	}
	catch (IOException eofe) {
	    System.out.println(eofe);
	    eofe.printStackTrace();
	}

	// Sort by score
	if (score1 < score2) {
	    return RecordComparator.PRECEDES;
	}
	else if (score1 > score2) {
	    return RecordComparator.FOLLOWS;
	}
	else {
	    return RecordComparator.EQUIVALENT;
	}
    }

    /**
     * The constructor opens the underlying record store,
     * creating it if necessary.
     */
    public RMSGameScores()
    {
	//
	// Create a new record store for this example
	//
	try {
	    recordStore = RecordStore.openRecordStore("scores", true);
	}
	catch (RecordStoreException rse) {
	    System.out.println(rse);
	    rse.printStackTrace();
	}
    }

    /**
     * Add a new score to the storage.
     *
     * @param score the score to store.
     * @param playerName the name of the play achieving this score.
     */
    public void addScore(int score, String playerName)
    {
	//
	// Each score is stored in a separate record, formatted with
	// the score, followed by the player name.
	//
        int recId;  // returned by addRecord but not used
	ByteArrayOutputStream baos = new ByteArrayOutputStream();
	DataOutputStream outputStream = new DataOutputStream(baos);
	try {
	    // Push the score into a byte array.
	    outputStream.writeInt(score);
	    // Then push the player name.
	    outputStream.writeUTF(playerName);
	}
	catch (IOException ioe) {
	    System.out.println(ioe);
	    ioe.printStackTrace();
	}

	// Extract the byte array
	byte[] b = baos.toByteArray();
	// Add it to the record store
	try {
	    recId = recordStore.addRecord(b, 0, b.length);
	}
	catch (RecordStoreException rse) {
	    System.out.println(rse);
	    rse.printStackTrace();
	}
    }

    /**
     * A helper method for the printScores methods.
     */
    private void printScoresHelper(RecordEnumeration re)
    {
	try {
	    while(re.hasNextElement()) {
		int id = re.nextRecordId();
		ByteArrayInputStream bais = new ByteArrayInputStream(recordStore.getRecord(id));
		DataInputStream inputStream = new DataInputStream(bais);
		try {
		    int score = inputStream.readInt();
		    String playerName = inputStream.readUTF();
		    System.out.println(playerName + " = " + score);
		}
		catch (EOFException eofe) {
		    System.out.println(eofe);
		    eofe.printStackTrace();
		}
	    }
	}
	catch (RecordStoreException rse) {
	    System.out.println(rse);
	    rse.printStackTrace();
	}
	catch (IOException ioe) {
	    System.out.println(ioe);
	    ioe.printStackTrace();
	}
    }

    /**
     * This method prints all of the scores sorted by game score.
     */
    public void printScores()
    {
	try {
	    // Enumerate the records using the comparator implemented
	    // above to sort by game score.
	    RecordEnumeration re = recordStore.enumerateRecords(null, this, 
								true);
	    printScoresHelper(re);
	}
	catch (RecordStoreException rse) {
	    System.out.println(rse);
	    rse.printStackTrace();
	}
    }

    /**
     * This method prints all of the scores for a given player,
     * sorted by game score.
     */
    public void printScores(String playerName)
    {
	try {
	    // Enumerate the records using the comparator and filter
	    // implemented above to sort by game score.
	    RecordEnumeration re = recordStore.enumerateRecords(this, this, 
								true);
	    printScoresHelper(re);
	}
	catch (RecordStoreException rse) {
	    System.out.println(rse);
	    rse.printStackTrace();
	}
    }

    public static void main(String[] args)
    {
	RMSGameScores rmsgs = new RMSGameScores();
	rmsgs.addScore(100, "Alice");
	rmsgs.addScore(120, "Bill");
	rmsgs.addScore(80, "Candice");
	rmsgs.addScore(40, "Dean");
	rmsgs.addScore(200, "Ethel");
	rmsgs.addScore(110, "Farnsworth");
	rmsgs.addScore(220, "Farnsworth");
	System.out.println("All scores");
	rmsgs.printScores();
	System.out.println("Farnsworth's scores");
	RMSGameScores.playerNameFilter = "Farnsworth";
	rmsgs.printScores("Farnsworth");
    }
}

Since:

MIDP 1.0