org.exoplatform.commons.utils
Interface ListAccess<E>

public interface ListAccess<E>

A Service Provider Interface for a list access.

Version:

$Revision$

Author:

Julien Viet

Method Summary

int	getSize() Returns the list size.
E[]	load(int index, int length) Retrieves an array of object from the list.

Method Detail

load

E[] load(int index,
         int length)
         throws Exception,
                IllegalArgumentException

Retrieves an array of object from the list. The returned array size is expected to be equals to the length argument.

The index value and the lenght value cannot be negative, and the sum of the index and the length cannot be greater than the list size. Those values are considered as non correct.

Parameters:

index - the index

length - the limit

Returns:

the array

Throws:

Exception - any exception that would prevent access to the list

IllegalArgumentException - if the index value or the length value are not correct

getSize

int getSize()
            throws Exception

Returns the list size.

Returns:

the size

Throws:

Exception - any exception that would prevent access to the list