net.rim.device.api.collection
Interface BulkUpdateCollectionListener

All Superinterfaces:

CollectionListener

public interface BulkUpdateCollectionListener
extends CollectionListener

Provides collection events that signal bulk update operations.

Typically, a source collection can inform listening collections about its updates in two ways:

• The source can broadcast a collection update event to its listeners after each individual update.
• The source can batch the updates, by wrapping them in the notifications methods provided here; then the listeners can receive the all the updates in the batch.

The latter method reduces the impact on RAM use and avoids VM thrashing, at the cost of latency while this collection gathers its updates into a batch.

Method Summary
void	beginBulkUpdate(Collection collection) Monitoried collection is beginning a bulk update.
void	endBulkUpdate(Collection collection) Monitored collection has completed a bulk update.

Methods inherited from interface net.rim.device.api.collection.CollectionListener

elementAdded, elementRemoved, elementUpdated, reset

Method Detail

beginBulkUpdate

void beginBulkUpdate(Collection collection)

Monitoried collection is beginning a bulk update.

This collection should avoid commits to the persistent store if possible.

Parameters:

collection - Collection beginning its bulk update.

endBulkUpdate

void endBulkUpdate(Collection collection)

Monitored collection has completed a bulk update.

This collection should move itself out of RAM if possible since no more updates are probably going to occur for a while.

Parameters:

collection - Collection ending its bulk update.