rocks.xmpp.extensions.rsm

Interface ResultSetProvider<T extends ResultSetItem>

All Known Implementing Classes:

DefaultItemProvider

public interface ResultSetProvider<T extends ResultSetItem>

Provides methods which are needed for result set management.

See Also:

XEP-0059: Result Set Management

Method Summary

Modifier and Type	Method and Description
static <T extends ResultSetItem> ResultSetProvider<T>	forItems(java.util.Collection<T> items) Creates a Collection-based result set provider.
int	getItemCount() Gets the total item count.
java.util.List<T>	getItems() Gets all items.
java.util.List<T>	getItems(int index, int maxSize) Gets the items in a specific range (by index).
java.util.List<T>	getItemsAfter(java.lang.String itemId, int maxSize) Gets the items after a specific item, which is determined by an item id.
java.util.List<T>	getItemsBefore(java.lang.String itemId, int maxSize) Gets the items before a specific item, which is determined by an item id.
int	indexOf(java.lang.String itemId) Gets the index of a specific item.

Method Detail

getItems

java.util.List<T> getItems()

Gets all items. This method is called, if no result set management was included in the query.

Returns:

The items.

getItemCount

int getItemCount()

Gets the total item count.

Returns:

The item count.

getItems

java.util.List<T> getItems(int index,
                           int maxSize)

Gets the items in a specific range (by index).

Parameters:

index - The index.

maxSize - The maximal size of items.

Returns:

The items.

getItemsAfter

java.util.List<T> getItemsAfter(java.lang.String itemId,
                                int maxSize)

Gets the items after a specific item, which is determined by an item id.

Parameters:

itemId - The item id.

maxSize - The maximal size of items.

Returns:

The items.

getItemsBefore

java.util.List<T> getItemsBefore(java.lang.String itemId,
                                 int maxSize)

Gets the items before a specific item, which is determined by an item id.

Parameters:

itemId - The item id.

maxSize - The maximal size of items.

Returns:

The items.

indexOf

int indexOf(java.lang.String itemId)

Gets the index of a specific item.

Parameters:

itemId - The item id.

Returns:

The index or -1, if no index could be determined.

forItems

static <T extends ResultSetItem> ResultSetProvider<T> forItems(java.util.Collection<T> items)

Creates a Collection-based result set provider.

It is highly recommended that the provided list is thread-safe, e.g. by using Collections.synchronizedList(List)} or a concurrent collection. Otherwise modifications on the list, while reading a sub list (getItems(int, int)) may produce ConcurrentModificationException.

Type Parameters:

T - The result set item.

Parameters:

items - The items.

Returns:

The result set provider.

Since:

0.8.0