org.ujorm.wicket.component.grid

Class AbstractDataProvider<U extends Ujo>

java.lang.Object

org.apache.wicket.extensions.markup.html.repeater.util.SortableDataProvider<U,Object>

org.ujorm.wicket.component.grid.AbstractDataProvider<U>

All Implemented Interfaces:

Serializable, org.apache.wicket.extensions.markup.html.repeater.data.sort.ISortStateLocator<Object>, org.apache.wicket.extensions.markup.html.repeater.data.table.ISortableDataProvider<U,Object>, org.apache.wicket.markup.repeater.data.IDataProvider<U>, org.apache.wicket.model.IDetachable, org.apache.wicket.util.io.IClusterable

Direct Known Subclasses:

ListDataProvider, UjoDataProvider

public abstract class AbstractDataProvider<U extends Ujo>
extends org.apache.wicket.extensions.markup.html.repeater.util.SortableDataProvider<U,Object>

This class called UjoDataProvider is an database Wicket DataProvider. For a customization you can use a your own IColumn implementations or you can owerwrite selected methods of this provider.

The implementation generates two database requests per a one rendering, the first one get size and the second one get paged data. You can owerwrite the two data methods: iterator() and the size() for more optimization.

The current class uses a WicketApplication implementation, which must implement the interface OrmHandlerProvider for an ORM support. See the example:

See the simple sample:

 Criterion<Hotel> allActiveHotels = Hotel.ACTIVE.whereEq(true);
  UjoDataProvider<Hotel> dataProvider = UjoDataProvider.of(allActiveHotels);

  dataProvider.addColumn(Hotel.NAME);
  dataProvider.addColumn(Hotel.CITY.add(City.NAME)); // An example of relations
  dataProvider.addColumn(Hotel.STREET);
  dataProvider.addColumn(Hotel.PRICE);
  dataProvider.addColumn(KeyColumn.of(Hotel.CURRENCY, SORTING_OFF));
  dataProvider.addColumn(Hotel.STARS);
  dataProvider.addColumn(Hotel.PHONE);
  dataProvider.setSort(Hotel.NAME);

  panel.add(dataProvider.createDataTable("datatable", 10));
 
 

Author:

Pavel Ponec

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	DEFAULT_CSS_SELECTED Default CSS style for a SELECTED row
static String	DEFAULT_DATATABLE_ID Default Datatable ID have got value "datatable".
protected org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>>	filter Data criterion model for filtering the data resource
protected org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>>	selected Data criterion model for select data rows
protected Long	size Data size

Constructor Summary

Constructors

Constructor and Description
AbstractDataProvider(org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>> criterion) Constructor
AbstractDataProvider(org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>> filter, Key<? super U,?> defaultSort) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
boolean	add(org.apache.wicket.extensions.markup.html.repeater.data.table.IColumn<? super U,?> column) Add table column
<V> boolean	add(Key<? super U,V> column) Add table column according to column type
<V> boolean	add(Key<? super U,V> column, CssAppender cssClass) Add table column according to column type including CSS class
void	add(KeyList<? super U> columns) Add table columns according to column type including CSS class
<S> org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<U,S>	createDataTable(int rowsPerPage) Create AJAX-based DataTable with a DEFAULT_DATATABLE_ID
<S> org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<U,S>	createDataTable(int rowsPerPage, boolean insertToolbar) Create AJAX-based DataTable
<S> org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<U,S>	createDataTable(String id, int rowsPerPage) Create AJAX-based DataTable
<S> org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<U,S>	createDataTable(String id, int rowsPerPage, boolean insertToolbar) Create AJAX-based DataTable
long	deleteRow(org.ujorm.criterion.Criterion<? super U> deleteCondition) Delete rows from the data source The method is not implemented by default.
abstract void	detach() Commit and close transaction
List<org.apache.wicket.extensions.markup.html.repeater.data.table.IColumn<U,?>>	getColumns() Transient tableOf columns
protected String	getCssSelected() Returns a CSS style for SELECTED row.
Class<U>	getDomainClass() Get a domann class
org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>>	getSelected() Data criterion model for select data rows
Key<U,?>	getSortKey() Vrací klíč pro řazení
boolean	insertRow(U row) Insert row to the data source.
boolean	isDefaultColumnSorting() Default column sorting for the method #addColumn(org.ujorm.Key) where the feature is enabled by default
protected boolean	isSortingEnabled(Key<U,?> column) The sorting is enabled for a persistent Ujorm Key by default
abstract Iterator<U>	iterator(long first, long count) Build a JDBC ResultSet allways.
org.apache.wicket.model.IModel<U>	model(U object) Create a model
void	setCssClass(Key<? super U,?> key, String cssClass) Assign a CSS class to a KeyColumn, if exists
void	setDefaultColumnSorting(boolean defaultColumnSorting) Default column sorting for the method #addColumn(org.ujorm.Key) where the feature is enabled by default
void	setSelected(org.ujorm.criterion.Criterion<U> selected) Data criterion model for select data rows
void	setSelected(org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>> selected) Data criterion model for select data rows
void	setSort(Key<? super U,?> key) Sets the current sort state and assign the BaseClass
abstract long	size() Method calculate the size using special SQL requst.
long	updateRow(org.ujorm.criterion.Criterion<? super U> updateCondition, U updatedRow) Update all rows with a condition using the row The method is not implemented by default.

Methods inherited from class org.apache.wicket.extensions.markup.html.repeater.util.SortableDataProvider

getSort, getSortState, setSort, setSort

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_DATATABLE_ID

public static final String DEFAULT_DATATABLE_ID

Default Datatable ID have got value "datatable".

See Also:

Constant Field Values

DEFAULT_CSS_SELECTED

protected static final String DEFAULT_CSS_SELECTED

Default CSS style for a SELECTED row

See Also:

Constant Field Values

size

protected Long size

Data size

filter

protected org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U extends Ujo>> filter

Data criterion model for filtering the data resource

selected

protected org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U extends Ujo>> selected

Data criterion model for select data rows

Constructor Detail

AbstractDataProvider

public AbstractDataProvider(@Nonnull
                    org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>> criterion)

Constructor

Parameters:

criterion - Condition to a database query

AbstractDataProvider

public AbstractDataProvider(@Nonnull
                    org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>> filter,
                    @Nullable
                    Key<? super U,?> defaultSort)

Constructor

Parameters:

filter - Model of a condition to a database query

defaultSort - Default sorting can be assigned optionally

Method Detail

setSort

public final void setSort(Key<? super U,?> key)

Sets the current sort state and assign the BaseClass

Parameters:

key - sort key

order - sort order

getSortKey

public Key<U,?> getSortKey()

Vrací klíč pro řazení

iterator

public abstract Iterator<U> iterator(long first,
                   long count)

Build a JDBC ResultSet allways. Overwrite the method for an optimization.

size

public abstract long size()

Method calculate the size using special SQL requst. Overwrite the method for an optimization.
Original documentation:

detach

public abstract void detach()

Commit and close transaction

Specified by:

detach in interface org.apache.wicket.model.IDetachable

Overrides:

detach in class org.apache.wicket.extensions.markup.html.repeater.util.SortableDataProvider<U extends Ujo,Object>

getDomainClass

public Class<U> getDomainClass()

Get a domann class

model

public org.apache.wicket.model.IModel<U> model(U object)

Create a model

add

public boolean add(org.apache.wicket.extensions.markup.html.repeater.data.table.IColumn<? super U,?> column)

Add table column

add

public void add(KeyList<? super U> columns)

Add table columns according to column type including CSS class

add

public <V> boolean add(Key<? super U,V> column,
              CssAppender cssClass)

Add table column according to column type including CSS class

add

public <V> boolean add(Key<? super U,V> column)

Add table column according to column type

getCssSelected

protected String getCssSelected()

Returns a CSS style for SELECTED row. The default value is DEFAULT_CSS_SELECTED

isSortingEnabled

protected boolean isSortingEnabled(Key<U,?> column)
                            throws IllegalArgumentException

The sorting is enabled for a persistent Ujorm Key by default

Throws:

IllegalArgumentException

See Also:

isDefaultColumnSorting()

createDataTable

public final <S> org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<U,S> createDataTable(int rowsPerPage)

Create AJAX-based DataTable with a DEFAULT_DATATABLE_ID

createDataTable

public final <S> org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<U,S> createDataTable(String id,
                                                                                              int rowsPerPage)

Create AJAX-based DataTable

createDataTable

public final <S> org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<U,S> createDataTable(int rowsPerPage,
                                                                                              boolean insertToolbar)

Create AJAX-based DataTable

createDataTable

public <S> org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<U,S> createDataTable(String id,
                                                                                              int rowsPerPage,
                                                                                              boolean insertToolbar)

Create AJAX-based DataTable

Parameters:

id - Component ID

rowsPerPage - Row count per the one page

insertToolbar - Append a generic toolbar for an insert action.

Returns:

Create AJAX-based DataTable

isDefaultColumnSorting

public final boolean isDefaultColumnSorting()

Default column sorting for the method #addColumn(org.ujorm.Key) where the feature is enabled by default

Returns:

the defaultColumnSorting

setDefaultColumnSorting

public void setDefaultColumnSorting(boolean defaultColumnSorting)

Default column sorting for the method #addColumn(org.ujorm.Key) where the feature is enabled by default

Parameters:

defaultColumnSorting - the defaultColumnSorting to set

getColumns

public List<org.apache.wicket.extensions.markup.html.repeater.data.table.IColumn<U,?>> getColumns()

Transient tableOf columns

setCssClass

public void setCssClass(Key<? super U,?> key,
               String cssClass)

Assign a CSS class to a KeyColumn, if exists

getSelected

@Nullable
public org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>> getSelected()

Data criterion model for select data rows

Returns:

the selected

setSelected

public void setSelected(@Nullable
               org.apache.wicket.model.IModel<org.ujorm.criterion.Criterion<U>> selected)

Data criterion model for select data rows

Parameters:

selected - the selected to set

setSelected

public void setSelected(@Nonnull
               org.ujorm.criterion.Criterion<U> selected)

Data criterion model for select data rows

Parameters:

selected - the selected to set

insertRow

public boolean insertRow(U row)

Insert row to the data source. The method is not implemented by default.

Parameters:

row - Insert one table row

deleteRow

public long deleteRow(org.ujorm.criterion.Criterion<? super U> deleteCondition)

Delete rows from the data source The method is not implemented by default.

Parameters:

deleteCondition - Remove all row with a condition.

updateRow

public long updateRow(org.ujorm.criterion.Criterion<? super U> updateCondition,
             U updatedRow)

Update all rows with a condition using the row The method is not implemented by default.

Parameters:

updateCondition - Update condition

updatedRow - Updated row