Module org.apache.wicket.core

Package org.apache.wicket.markup.html.list

Class PageableListView<T>

java.lang.Object

org.apache.wicket.Component

org.apache.wicket.MarkupContainer

org.apache.wicket.markup.html.WebMarkupContainer

org.apache.wicket.markup.repeater.AbstractRepeater

org.apache.wicket.markup.html.list.ListView<T>

org.apache.wicket.markup.html.list.PageableListView<T>

Type Parameters:

T - type of elements contained in the model's list

All Implemented Interfaces:

Serializable, Iterable<Component>, IEventSink, IEventSource, IFeedbackContributor, IConverterLocator, IMetadataContext<Serializable,Component>, IHeaderContributor, IPageable, IPageableItems, IRequestableComponent, IHierarchical<Component>, IClusterable

public abstract class PageableListView<T>
extends ListView<T>
implements IPageableItems

PageableListView is similar to ListView but provides in addition pageable views. A PageableListView holds pageable rows of information. The rows can be re-ordered and deleted, either one at a time or many at a time.

Author:

Jonathan Locke

See Also:

• Serialized Form

Field Summary

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_INITIALIZED, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER, RFLAG_CONTAINER_DEQUEING, RFLAG_CONTAINER_HAS_REMOVALS

Constructor Summary

Constructors

Constructor	Description
PageableListView(String id, List<T> list, long itemsPerPage)	Creates a pageable list view having the given number of rows per page that uses the provided object as a simple model.
PageableListView(String id, IModel<? extends List<T>> model, long itemsPerPage)	Constructor

Method Summary

Modifier and Type	Method	Description
final long	getCurrentPage()	Gets the index of the current page being displayed by this list view.
long	getFirstItemOffset()
long	getItemCount()	Gets the total number of items this object has.
final long	getItemsPerPage()	Gets the maximum number of rows on each page.
final long	getPageCount()	Gets the number of pages in this list view.
int	getViewSize()	Based on the model object's list size, firstIndex and view size, determine what the view size really will be.
final void	setCurrentPage(long currentPage)	Sets the current page that this list view should show.
final void	setItemsPerPage(long itemsPerPage)	Sets the maximum number of rows on each page.
ListView<T>	setStartIndex(int startIndex)	Prevent users from accidentally using it.
ListView<T>	setViewSize(int size)	Prevent users from accidentally using it.

Methods inherited from class org.apache.wicket.markup.html.list.ListView

getList, getListItemModel, getModel, getModelObject, getReuseItems, getStartIndex, moveDownLink, moveUpLink, newItem, onBeginPopulateItem, onPopulate, populateItem, removeLink, renderChild, renderItem, renderIterator, setList, setModel, setModelObject, setReuseItems

Methods inherited from class org.apache.wicket.markup.repeater.AbstractRepeater

dequeue, getMarkup, onBeforeRender, onRender

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

getWebApplication, getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addDequeuedComponent, addOrReplace, autoAdd, canDequeueTag, contains, dequeue, dequeuePreamble, findChildComponent, findComponentToDequeue, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkupType, getRegionMarkup, internalAdd, internalInitialize, iterator, iterator, newDequeueContext, onComponentTagBody, onDetach, onInitialize, queue, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, stream, streamChildren, toString, toString, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, beforeRender, canCallListener, canCallListenerAfterExpiry, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, clearOriginalDestination, configure, continueToOriginalDestination, createConverter, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMarkupTag, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalRenderComponent, internalRenderHead, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isInitialized, isRenderAllowed, isRendering, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, newMarkupSourcingStrategy, onAfterRender, onComponentTag, onConfigure, onEvent, onModelChanged, onModelChanging, onReAdd, onRemove, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderPart, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlForListener, urlForListener, visitParents, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Details

PageableListView

public PageableListView(String id,
 IModel<? extends List<T>> model,
 long itemsPerPage)

Constructor

Parameters:

id - See Component

model - See Component

itemsPerPage - Number of rows to show on a page

PageableListView

public PageableListView(String id,
 List<T> list,
 long itemsPerPage)

Creates a pageable list view having the given number of rows per page that uses the provided object as a simple model.

Parameters:

id - See Component

list - See Component

itemsPerPage - Number of rows to show on a page

See Also:

• ListView(String, List)

Method Details

getCurrentPage

public final long getCurrentPage()

Gets the index of the current page being displayed by this list view.

Specified by:

getCurrentPage in interface IPageable

Returns:

Returns the currentPage.

getPageCount

public final long getPageCount()

Gets the number of pages in this list view.

Specified by:

getPageCount in interface IPageable

Returns:

The number of pages in this list view

getItemsPerPage

public final long getItemsPerPage()

Gets the maximum number of rows on each page.

Specified by:

getItemsPerPage in interface IPageableItems

Returns:

the maximum number of rows on each page.

setItemsPerPage

public final void setItemsPerPage(long itemsPerPage)

Sets the maximum number of rows on each page.

Specified by:

setItemsPerPage in interface IPageableItems

Parameters:

itemsPerPage - the maximum number of rows on each page.

getFirstItemOffset

public long getFirstItemOffset()

Returns:

offset of first item

getItemCount

public long getItemCount()

Description copied from interface: IPageableItems

Gets the total number of items this object has.

Specified by:

getItemCount in interface IPageableItems

Returns:

The total number of items this object has.

See Also:

• IPageableItems.getItemCount()

getViewSize

public int getViewSize()

Description copied from class: ListView

Based on the model object's list size, firstIndex and view size, determine what the view size really will be. E.g. default for viewSize is Integer.MAX_VALUE, if not set via setViewSize(). If the underlying list has 10 elements, the value returned by getViewSize() will be 10 if startIndex = 0.

Overrides:

getViewSize in class ListView<T>

Returns:

The number of items to be populated and rendered.

See Also:

• ListView.getViewSize()

setCurrentPage

public final void setCurrentPage(long currentPage)

Sets the current page that this list view should show.

Specified by:

setCurrentPage in interface IPageable

Parameters:

currentPage - The currentPage to set.

setStartIndex

public ListView<T> setStartIndex(int startIndex)
                          throws UnsupportedOperationException

Prevent users from accidentally using it.

Overrides:

setStartIndex in class ListView<T>

Parameters:

startIndex - First index of model object's list to display

Returns:

This

Throws:

UnsupportedOperationException - always

See Also:

• ListView.setStartIndex(int)

setViewSize

public ListView<T> setViewSize(int size)
                        throws UnsupportedOperationException

Prevent users from accidentally using it.

Overrides:

setViewSize in class ListView<T>

Parameters:

size - the view size

Returns:

This

Throws:

UnsupportedOperationException - always

See Also:

• ListView.setStartIndex(int)