com.inmethod.grid
Interface IDataSource<T>

Type Parameters:

T - row/item model object type

All Superinterfaces:

IClusterable, IDetachable, Serializable

All Known Subinterfaces:

IAppendableDataSource<T>

All Known Implementing Classes:

AppendableDataProviderAdapter, DataProviderAdapter

public interface IDataSource<T>
extends IDetachable, IClusterable

Interface used to provide data to data views. This interface allows to create a paged DataGrid without being able to know the exact amount of rows upfront.

An example of situation when the row count can be determined:

 IDataSource<User> source = new IDataSource<User>() {
                public void query(IQuery query, IQueryResult<User> result) {
                        
                        UserDao dao = DaoManager.getUserDao(); // code to get a DAO or service object
                        
                        result.setTotalCount(dao.getUserCount());
                        
                        Collection<User> users = dao.getUsers(query.getFrom(), query.getCount());
                        result.setItems(users.iterator());
                } 
 
                public IModel<User> model(User object) {
                        return new DetachableUserModel(object);
                }    
 }
 

 IDataSource<User> source = new IDataSource<User>() {
                public void query(IQuery query, IQueryResult<User> result) {
                        
                        UserDao dao = DaoManager.getUserDao(); // code to get a DAO or service object
                        Collection<User> users = dao.getUsers(query.getFrom(), query.getCount() + 1);
 
                        if (users.size() < query.getCount() + 1) {
                                result.setTotalCount(IQueryResult.NO_MORE_ITEMS);
                        } else {
                                result.setTotalCount(IQueryResult.MORE_ITEMS);
                        }
 
                        result.setItems(users.iterator());
        }
 
        public IModel<User> model(User object) {
                        return new DetachableUserModel(object);
                }  
 }
 

Author:

Matej Knopp

query

void query(IDataSource.IQuery query,
           IDataSource.IQueryResult<T> result)

Implementation of this method should load subset of the data specified by query.getFrom() and query.getCount(). Also if the total item count can be determined, it should be passed to result.

Parameters:

query - Specified the amount and position of items to be queried

result - Allows to set the total item count and result items

model

IModel<T> model(T object)

Allows wrapping the object in a model which will be set as model of the appropriate row. In most cases the model should be detachable.

Parameters:

object -

Returns:

model that can be used to access the object