org.apache.wicket.extensions.markup.html.repeater.data.table
Class DataTable<T>

java.lang.Object
  org.apache.wicket.Component
      org.apache.wicket.MarkupContainer
          org.apache.wicket.markup.html.WebMarkupContainer
              org.apache.wicket.markup.html.WebMarkupContainerWithAssociatedMarkup
                  org.apache.wicket.markup.html.panel.Panel
                      org.apache.wicket.extensions.markup.html.repeater.data.table.DataTable<T>

Type Parameters:

T - The model object type

All Implemented Interfaces:

Serializable, IClusterable, IConverterLocator, IHeaderPartContainerProvider, IPageable

Direct Known Subclasses:

AjaxFallbackDefaultDataTable, DefaultDataTable

public class DataTable<T>
extends Panel
implements IPageable

A data table builds on data grid view to introduce toolbars. Toolbars can be used to display sortable column headers, paging information, filter controls, and other information.

Data table also provides its own markup for an html table so the user does not need to provide it himself. This makes it very simple to add a datatable to the markup, however, some flexibility.

Example

 <table wicket:id="datatable"></table>
 

And the related Java code: ( the first column will be sortable because its sort property is specified, the second column will not )

 IColumn[] columns = new IColumn[2];
 
 columns[0] = new PropertyColumn(new Model<String>("First Name"), "name.first", "name.first");
 columns[1] = new PropertyColumn(new Model<String>("Last Name"), "name.last");
 
 DataTable table = new DataTable("datatable", columns, new UserProvider(), 10);
 table.addBottomToolbar(new NavigationToolbar(table));
 table.addTopToolbar(new HeadersToolbar(table, null));
 add(table);
 

Author:

Igor Vaynberg (ivaynberg)

See Also:

DefaultDataTable, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.wicket.Component

Component.ComponentModelChange, Component.EnabledChange, Component.IVisitor<T extends Component>, Component.VisibilityChange

Field Summary

static String

TOOLBAR_COMPONENT_ID The component id that toolbars must be created with in order to be added to the data table

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_CONFIGURED, FLAG_INITIALIZED, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED6, FLAG_RESERVED7, FLAG_RESERVED8, PATH_SEPARATOR, RENDER

Constructor Summary

DataTable(String id, IColumn<T>[] columns, IDataProvider<T> dataProvider, int rowsPerPage)
Constructor

tag.

Method Summary

void	addBottomToolbar(AbstractToolbar toolbar) Adds a toolbar to the datatable that will be displayed after the data
void	addTopToolbar(AbstractToolbar toolbar) Adds a toolbar to the datatable that will be displayed before the data
IColumn<?>[]	getColumns()
int	getCurrentPage()
IDataProvider<T>	getDataProvider()
int	getPageCount() Gets the total number of pages this pageable object has.
int	getRowCount()
int	getRowsPerPage()
protected WebMarkupContainer	newBodyContainer(String id) Create the MarkupContainer for the
protected Item<T>	newCellItem(String id, int index, IModel<T> model) Factory method for Item container that represents a cell in the underlying DataGridView
protected Item<T>	newRowItem(String id, int index, IModel<T> model) Factory method for Item container that represents a row in the underlying DataGridView
protected void	onDetach() Called to allow a component to detach resources after use.
protected void	onPageChanged() Event listener for page-changed event
void	setCurrentPage(int page) Sets the a page that should be rendered.
DataTable<T>	setItemReuseStrategy(IItemReuseStrategy strategy) Sets the item reuse strategy.
void	setRowsPerPage(int items) Sets the number of items to be displayed per page
void	setTableBodyCss(String cssStyle) Set the 'class' attribute for the tbody tag.

Methods inherited from class org.apache.wicket.markup.html.panel.Panel

onComponentTag, onComponentTagBody, renderHead

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainerWithAssociatedMarkup

newHeaderPartContainer, renderHeadFromAssociatedMarkupFile

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer

getMarkupType, getWebPage, getWebRequest

Methods inherited from class org.apache.wicket.MarkupContainer

add, addOrReplace, autoAdd, autoAdd, contains, findMarkupStream, get, get, getAssociatedMarkupStream, getMarkupStream, hasAssociatedMarkup, internalAdd, isTransparentResolver, iterator, iterator, newMarkupResourceStream, onAfterRenderChildren, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderComponentTagBody, renderNext, replace, setDefaultModel, setMarkupStream, size, swap, toString, toString, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, callOnBeforeRenderIfNotVisible, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, configure, continueToOriginalDestination, debug, detach, detachBehaviors, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findPage, findParent, findParentWithAssociatedMarkup, getApplication, getBehaviors, getBehaviors, getBehaviorsRawList, getClassRelativePath, getComponentBorder, getConverter, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessage, getFlag, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdImpl, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalAttach, internalDetach, internalOnAttach, internalOnDetach, internalOnModelChanged, isActionAuthorized, isAncestorOf, isAttached, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, locateMarkupStream, markAttached, markRendering, modelChanged, modelChanging, onAfterRender, onAttach, onBeforeRender, onBeginRequest, onConfigure, onEndRequest, onInitialize, onModelChanged, onModelChanging, onRemove, prepareForRender, prepareForRender, redirectToInterceptPage, remove, remove, render, render, renderComponent, renderComponent, renderComponentTag, rendered, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, setAuto, setComponentBorder, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setFlag, setIgnoreAttributeModifier, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setRedirect, setRenderBodyOnly, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, urlFor, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Field Detail

TOOLBAR_COMPONENT_ID

public static final String TOOLBAR_COMPONENT_ID

The component id that toolbars must be created with in order to be added to the data table

See Also:

Constant Field Values

Constructor Detail

DataTable

public DataTable(String id,
                 IColumn<T>[] columns,
                 IDataProvider<T> dataProvider,
                 int rowsPerPage)

Constructor

Parameters:

id - component id

columns - list of IColumn objects

dataProvider - imodel for data provider

rowsPerPage - number of rows per page

Method Detail

newBodyContainer

protected WebMarkupContainer newBodyContainer(String id)

Create the MarkupContainer for the tag. Users may subclass it to provide their own (modified) implementation.

Parameters:

id -

Returns:

A new markup container

setTableBodyCss

public final void setTableBodyCss(String cssStyle)

Set the 'class' attribute for the tbody tag.

Parameters:

cssStyle -

addBottomToolbar

public void addBottomToolbar(AbstractToolbar toolbar)

Adds a toolbar to the datatable that will be displayed after the data

Parameters:

toolbar - toolbar to be added

See Also:

AbstractToolbar

addTopToolbar

public void addTopToolbar(AbstractToolbar toolbar)

Adds a toolbar to the datatable that will be displayed before the data

Parameters:

toolbar - toolbar to be added

See Also:

AbstractToolbar

getDataProvider

public final IDataProvider<T> getDataProvider()

Returns:

dataprovider

getColumns

public final IColumn<?>[] getColumns()

Returns:

array of column objects this table displays

getCurrentPage

public final int getCurrentPage()

Specified by:

getCurrentPage in interface IPageable

Returns:

The current page that is or will be rendered.

See Also:

IPageable.getCurrentPage()

getPageCount

public final int getPageCount()

Description copied from interface: IPageable

Gets the total number of pages this pageable object has.

Specified by:

getPageCount in interface IPageable

Returns:

The total number of pages this pageable object has

See Also:

IPageable.getPageCount()

getRowCount

public final int getRowCount()

Returns:

total number of rows in this table

getRowsPerPage

public final int getRowsPerPage()

Returns:

number of rows per page

setCurrentPage

public final void setCurrentPage(int page)

Description copied from interface: IPageable

Sets the a page that should be rendered.

Specified by:

setCurrentPage in interface IPageable

Parameters:

page - The page that should be rendered.

See Also:

IPageable.setCurrentPage(int)

setItemReuseStrategy

public final DataTable<T> setItemReuseStrategy(IItemReuseStrategy strategy)

Sets the item reuse strategy. This strategy controls the creation of Items.

Parameters:

strategy - item reuse strategy

Returns:

this for chaining

See Also:

RefreshingView.setItemReuseStrategy(IItemReuseStrategy), IItemReuseStrategy

setRowsPerPage

public void setRowsPerPage(int items)

Sets the number of items to be displayed per page

Parameters:

items - number of items to display per page

newCellItem

protected Item<T> newCellItem(String id,
                              int index,
                              IModel<T> model)

Factory method for Item container that represents a cell in the underlying DataGridView

Parameters:

id - component id for the new data item

index - the index of the new data item

model - the model for the new data item

Returns:

DataItem created DataItem

See Also:

Item

newRowItem

protected Item<T> newRowItem(String id,
                             int index,
                             IModel<T> model)

Factory method for Item container that represents a row in the underlying DataGridView

Parameters:

id - component id for the new data item

index - the index of the new data item

model - the model for the new data item.

Returns:

DataItem created DataItem

See Also:

Item

onDetach

protected void onDetach()

Description copied from class: Component

Called to allow a component to detach resources after use. Overrides of this method MUST call the super implementation, the most logical place to do this is the last line of the override method.

Overrides:

onDetach in class Component

See Also:

Component.onDetach()

onPageChanged

protected void onPageChanged()

Event listener for page-changed event