org.rhq.core.domain.util
Class PageControl

java.lang.Object
  org.rhq.core.domain.util.PageControl

All Implemented Interfaces:

Serializable, Cloneable

public class PageControl
extends Object
implements Serializable, Cloneable

Used to pass information on pagination and sorting to data lookup methods. Used by PersistenceUtility to apply these conditions to queries.

See Also:

Serialized Form

Field Summary

static int	SIZE_MAX
static int	SIZE_UNLIMITED

Constructor Summary

PageControl()

PageControl(int pageNumber, int pageSize)

PageControl(int pageNumber, int pageSize, OrderingField... orderingFields)

Method Summary

void	addDefaultOrderingField(String defaultField)
void	addDefaultOrderingField(String defaultField, PageOrdering defaultPageOrdering)
Object	clone()
List<OrderingField>	getOrderingFields()
OrderingField[]	getOrderingFieldsAsArray()
int	getPageNumber()
int	getPageSize()
String	getPrimarySortColumn()
PageOrdering	getPrimarySortOrder()
static PageControl	getSingleRowInstance()
int	getStartRow() Get the index of the first item on the page as dictated by the page size and page number.
static PageControl	getUnlimitedInstance()
void	initDefaultOrderingField(String defaultField)
void	initDefaultOrderingField(String defaultField, PageOrdering defaultPageOrdering)
void	reset()
void	setPageNumber(int pageNumber)
void	setPageSize(int pageSize)
void	setPrimarySort(String sortColumn, PageOrdering sortOrder)
void	setPrimarySortOrder(PageOrdering sortOrder)
void	sortBy(String sortField)
String	toString()
void	truncateOrderingFields(int keepFieldCount)

Methods inherited from class java.lang.Object

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

Field Detail

SIZE_UNLIMITED

public static final int SIZE_UNLIMITED

See Also:

Constant Field Values

SIZE_MAX

public static final int SIZE_MAX

See Also:

Constant Field Values

Constructor Detail

PageControl

public PageControl()

PageControl

public PageControl(int pageNumber,
                   int pageSize)

PageControl

public PageControl(int pageNumber,
                   int pageSize,
                   OrderingField... orderingFields)

Method Detail

getUnlimitedInstance

public static PageControl getUnlimitedInstance()

getSingleRowInstance

public static PageControl getSingleRowInstance()

initDefaultOrderingField

public void initDefaultOrderingField(String defaultField)

addDefaultOrderingField

public void addDefaultOrderingField(String defaultField)

initDefaultOrderingField

public void initDefaultOrderingField(String defaultField,
                                     PageOrdering defaultPageOrdering)

addDefaultOrderingField

public void addDefaultOrderingField(String defaultField,
                                    PageOrdering defaultPageOrdering)

getPageNumber

public int getPageNumber()

Returns:

The current page number (0-based)

setPageNumber

public void setPageNumber(int pageNumber)

getPageSize

public int getPageSize()

setPageSize

public void setPageSize(int pageSize)

getPrimarySortOrder

public PageOrdering getPrimarySortOrder()

setPrimarySortOrder

public void setPrimarySortOrder(PageOrdering sortOrder)

getPrimarySortColumn

public String getPrimarySortColumn()

setPrimarySort

public void setPrimarySort(String sortColumn,
                           PageOrdering sortOrder)

getOrderingFieldsAsArray

public OrderingField[] getOrderingFieldsAsArray()

getOrderingFields

public List<OrderingField> getOrderingFields()

truncateOrderingFields

public void truncateOrderingFields(int keepFieldCount)

sortBy

public void sortBy(String sortField)

getStartRow

public int getStartRow()

Get the index of the first item on the page as dictated by the page size and page number.

Returns:

the index of the starting row for the page

reset

public void reset()

toString

public String toString()

Overrides:

toString in class Object

clone

public Object clone()
             throws CloneNotSupportedException

Overrides:

clone in class Object

Throws:

CloneNotSupportedException