javax.microedition.rms
Interface RecordEnumeration

public interface RecordEnumeration

양방향 레코드 저장소 Record 열거자를 표시하는 인터페이스. RecordEnumeration은 논리적으로 레코드 저장소에 있는 여러 레코드의 recordId를 유지합니다. 열거자는 선택적 레코드 비교기에서 결정한 순서대로 모든 레코드(또는 선택적 레코드 필터가 제공된 경우 일부 레코드)에 대해 반복됩니다.

선택적 RecordFilter를 사용하여 제공된 필터와 일치하는 일부 레코드가 선택될 수 있습니다. 이것은 검색 기능 제공에 사용될 수 있습니다.

선택적 RecordComparator를 사용하여 열거자는 비교기에서 결정한 순서대로 레코드를 색인화할 수 있습니다. 이것은 정렬 기능 제공에 사용될 수 있습니다.

열거를 통해 색인화하는 동안 일부 레코드가 레코드 저장소에서 삭제되는 경우 열거에 의해 반환된 recordId는 더 이상 유효한 레코드를 표시하지 않습니다. 이 문제점을 피하기 위해 RecordEnumeration은 선택적으로 RecordStore의 수신기가 되어 자신의 내부 색인을 다시 작성하고 레코드의 추가 및 삭제에 반응할 수 있습니다. 그러나 레코드를 추가, 변경 및 삭제할 때마다 색인이 다시 만들어지고 이로 인해 성능에 심각한 영향을 미칠 수 있으므로 이 옵션은 특별히 주의해서 사용해야 합니다.

RecordEnumeration이 사용하는 RecordStore가 닫히면 RecordEnumeration이 유효하지 않게 되므로 동일한 RecordStore가 나중에 다시 열리는 경우에도 이에 대해 수행되는 모든 후속 작업은 잘못된 결과를 만들거나 RecordStoreNotOpenException이 발생할 수 있습니다. 또한 hasNextElement() 및 hasPreviousElement() 호출이 false를 반환합니다.

nextRecord()의 첫 번째 호출은 시퀀스의 첫 번째 레코드에서 레코드 데이터를 반환합니다. nextRecord()의 이후 호출은 연속된 다음 레코드의 데이터를 반환합니다. 열거의 특정 지점에서 연속적인 이전 레코드 데이터를 반환하려면 previousRecord()를 호출합니다. 한편 생성 후 처음으로 previousRecord()를 호출하면 열거의 마지막 요소의 레코드 데이터가 반환됩니다. previousRecord()에 대한 각각의 후속 호출은 시작점에 도달할 때까지 시퀀스의 역방향으로 진행됩니다.

레코드 저장소 검색을 수행하려면 RecordComparator 없이 RecordEnumeration을 작성하고 원하는 검색 기준을 가진 적절한 RecordFilter를 작성합니다.

Since:

MIDP 1.0

Method Summary

void	destroy() 이 RecordEnumeration에서 사용하는 내부 자원을 해제합니다.
boolean	hasNextElement() 다음 방향에 요소가 더 많으면 true를 반환합니다.
boolean	hasPreviousElement() 이전 방향에 요소가 더 많으면 true를 반환합니다.
boolean	isKeptUpdated() 레코드의 변경과 함께 열거를 최신 상태로 유지하는 경우 true를 반환합니다.
void	keepUpdated(boolean keepUpdated) 레코드 저장소의 레코드가 추가/삭제/변경됨에 따라 열거의 내부 색인을 최신 상태로 유지할 수 있는지 여부를 설정할 때 사용됩니다.
byte[]	nextRecord() 열거의 다음 레코드 사본을 반환합니다.
int	nextRecordId() 이 열거에 있는 다음 레코드의 recordId를 반환합니다.
int	numRecords() 이 열거 세트에서 사용 가능한 레코드 수를 반환합니다.
byte[]	previousRecord() 이 열거의 이전 레코드 사본을 반환합니다.
int	previousRecordId() 이 열거에 있는 이전 레코드의 recordId를 반환합니다.
void	rebuild() 현재 레코드 세트를 반영하기 위해 열거를 갱신하도록 요청합니다.
void	reset() 열거가 작성된 직후와 동일한 상태로 열거 색인을 반환합니다.

Method Detail

numRecords

public int numRecords()

이 열거 세트에서 사용 가능한 레코드 수를 반환합니다. 즉, 필터 기준과 일치하는 레코드 수가 반환됩니다. 이 때문에 RecordEnumeration은 모든 레코드에 필터링을 적용하여 전체적인 열거를 작성해야 합니다. 이렇게 되면 레코드 저장소에 많은 레코드가 있는 경우 상당한 시간이 소요될 수 있습니다.

Returns:

이 열거 세트에서 사용 가능한 레코드 수. 즉, 필터 기준과 일치하는 레코드 수가 반환됩니다.

nextRecord

public byte[] nextRecord()
                  throws InvalidRecordIDException,
                         RecordStoreNotOpenException,
                         RecordStoreException

열거의 다음 레코드 사본을 반환합니다. 여기서 다음은 이 열거자의 구성자에 제공되는 비교기 및/또는 필터에서 정의됩니다. 반환된 바이트 배열은 레코드의 사본입니다. 이 배열의 변경 내용은 레코드 저장소에 반영되지 않습니다. 이 메소드를 호출한 후 열거는 다음 사용 가능한 레코드로 이동합니다.

Returns:

이 열거의 다음 레코드

Throws:

InvalidRecordIDException - 사용할 수 있는 레코드가 없는 경우, reset()을 호출하여 열거를 재설정할 때까지 메소드의 후속 호출 시 계속 이 예외가 발생합니다.

RecordStoreNotOpenException - 레코드 저장소가 열려 있지 않은 경우

RecordStoreException - 일반 레코드 저장소 예외가 발생한 경우

nextRecordId

public int nextRecordId()
                 throws InvalidRecordIDException

이 열거에 있는 다음 레코드의 recordId를 반환합니다. 여기서 다음은 이 열거자의 구성자에 제공되는 비교기 및/또는 필터에서 정의됩니다. 이 메소드를 호출한 후 열거는 다음 사용 가능한 레코드로 이동합니다.

Returns:

이 열거에 있는 다음 레코드의 recordId

Throws:

InvalidRecordIDException - 사용할 수 있는 레코드가 없는 경우, reset()을 호출하여 열거를 재설정할 때까지 메소드의 후속 호출 시 계속 이 예외가 발생합니다.

previousRecord

public byte[] previousRecord()
                      throws InvalidRecordIDException,
                             RecordStoreNotOpenException,
                             RecordStoreException

이 열거의 이전 레코드 사본을 반환합니다. 여기서 이전은 이 열거자의 구성자에 제공되는 비교기 및/또는 필터에서 정의됩니다. 반환된 바이트 배열은 레코드의 사본입니다. 이 배열의 변경 내용은 레코드 저장소에 반영되지 않습니다. 이 메소드를 호출한 후 열거는 다음(이전) 사용 가능한 레코드로 이동합니다.

Returns:

이 열거의 이전 레코드

Throws:

InvalidRecordIDException - 사용할 수 있는 레코드가 없는 경우, reset()을 호출하여 열거를 재설정할 때까지 메소드의 후속 호출 시 계속 이 예외가 발생합니다.

RecordStoreNotOpenException - 레코드 저장소가 열려 있지 않은 경우

RecordStoreException - 일반 레코드 저장소 예외가 발생한 경우

previousRecordId

public int previousRecordId()
                     throws InvalidRecordIDException

이 열거에 있는 이전 레코드의 recordId를 반환합니다. 여기서 이전은 이 열거자의 구성자에 제공되는 비교기 및/또는 필터에서 정의됩니다. 이 메소드를 호출한 후 열거는 다음(이전) 사용 가능한 레코드로 이동합니다.

Returns:

이 열거에 있는 이전 레코드의 recordId

Throws:

InvalidRecordIDException - 사용할 수 있는 레코드가 없는 경우, reset()을 호출하여 열거를 재설정할 때까지 메소드의 후속 호출 시 계속 이 예외가 발생합니다.

hasNextElement

public boolean hasNextElement()

다음 방향에 요소가 더 많으면 true를 반환합니다.

Returns:

다음 방향에 요소가 더 많으면 true

hasPreviousElement

public boolean hasPreviousElement()

이전 방향에 요소가 더 많으면 true를 반환합니다.

Returns:

이전 방향에 요소가 더 많으면 true

reset

public void reset()

열거가 작성된 직후와 동일한 상태로 열거 색인을 반환합니다.

rebuild

public void rebuild()

현재 레코드 세트를 반영하기 위해 열거를 갱신하도록 요청합니다. MIDlet이 레코드 저장소를 많이 변경하고 기존의 RecordEnumeration이 새 변경을 열거할 때 유용합니다.

See Also:

keepUpdated(boolean)

keepUpdated

public void keepUpdated(boolean keepUpdated)

레코드 저장소의 레코드가 추가/삭제/변경됨에 따라 열거의 내부 색인을 최신 상태로 유지할 수 있는지 여부를 설정할 때 사용됩니다. 변경이 발생할 때마다 열거를 유지 관리해야 하는 특성과 관련된 잠재적인 성능 문제로 인해 주의하여 사용해야 합니다.

Parameters:

keepUpdated - true인 경우 열거자는 레코드 저장소의 레코드가 변경되면 열거를 최신 상태로 유지합니다. 성능 문제가 발생할 가능성이 있으므로 주의해서 사용합니다. keepUpdated(true)를 호출하면 현재 레코드 세트를 반영하기 위해 열거가 갱신된다는 면에서 RecordEnumeration.rebuild를 호출하는 것과 동일한 효과를 갖습니다. false인 경우 열거는 최신 상태로 유지되지 않으며 삭제된 레코드의 레코드 ID를 반환하거나 나중에 추가된 레코드를 누락시킬 수 있습니다. 열거가 만들어진 후 수정된 순서와 상관 없이 레코드를 반환할 수도 있습니다. 레코드 저장소의 레코드에 대한 변경 내용은 나중에 레코드를 직접 검색하거나 열거를 통해 검색할 때 정확하게 반영됩니다. 이 매개 변수를 false로 설정할 때 주의해야 할 점은 레코드가 수정, 추가 또는 삭제될 때 열거의 필터링 및 정렬 순서입니다.

See Also:

rebuild()

isKeptUpdated

public boolean isKeptUpdated()

레코드의 변경과 함께 열거를 최신 상태로 유지하는 경우 true를 반환합니다.

Returns:

레코드의 변경과 함께 열거를 최신 상태로 유지하는 경우 true

destroy

public void destroy()

이 RecordEnumeration에서 사용하는 내부 자원을 해제합니다. MIDlet이 RecordEnumeration을 사용하여 수행한 경우 이 메소드를 호출해야 합니다. MIDlet이 RecordEnumeration이 호출된 다음에 이 메소드를 사용하려고 하면 IllegalStateException이 발생합니다. 더 이상 이 열거가 필요하지 않은 경우 즉각적인 자원 요구 사항을 최소화하기 위해 이 메소드가 수동으로 사용됩니다.