org.apache.tapestry.contrib.table.components
Class TableFormRows

java.lang.Object
  extended by org.apache.tapestry.spec.BaseLocatable
      extended by org.apache.tapestry.AbstractComponent
          extended by org.apache.tapestry.BaseComponent
              extended by org.apache.tapestry.contrib.table.components.AbstractTableViewComponent
                  extended by org.apache.tapestry.contrib.table.components.TableRows
                      extended by org.apache.tapestry.contrib.table.components.TableFormRows
All Implemented Interfaces:
ITableRowSource, IComponent, ILocatable, ILocationHolder, IRender

public abstract class TableFormRows
extends TableRows

A low level Table component that generates the rows of the current page in the table. This component is a variant of TablePages, but is designed for operation in a form. The displayed rows are stored in hidden form fields, which are then read during a rewind. This ensures that the form will rewind in exactly the same was as it was rendered even if the TableModel has changed and no StaleLink exceptions will occur. The component must be wrapped by TableView.

The component iterates over the rows of the current page in the table. The rows are wrapped in 'tr' tags by default. You can define columns manually within, or you can use TableValues to generate the columns automatically.

Please see the Component Reference for details on how to use this component. [Component Reference]

Version:
$Id: TableFormRows.java 243791 2004-02-19 17:38:13Z hlship $
Author:
mindbridge

Field Summary
 
Fields inherited from interface org.apache.tapestry.contrib.table.model.ITableRowSource
TABLE_ROW_SOURCE_ATTRIBUTE
 
Constructor Summary
TableFormRows()
           
 
Method Summary
 IPrimaryKeyConvertor getCachedConvertor()
          Returns the PK convertor cached within the realm of the current request cycle.
 Iterator getConvertedTableRowsIterator()
          Get the list of all table rows to be displayed on this page, converted using the PK.convertor.
abstract  Map getConvertedValues()
           
abstract  IPrimaryKeyConvertor getConvertor()
           
abstract  IPrimaryKeyConvertor getConvertorCache()
           
 void setConvertedTableRow(Object objConvertedTableRow)
          Sets the current table row PK and invokes TableRows.setTableRow(Object) as a result.
abstract  void setConvertorCache(IPrimaryKeyConvertor convertor)
           
 
Methods inherited from class org.apache.tapestry.contrib.table.components.TableRows
getRowBinding, getTableRow, getTableRowsIterator, renderComponent, setTableRow
 
Methods inherited from class org.apache.tapestry.contrib.table.components.AbstractTableViewComponent
getTableModelSource
 
Methods inherited from class org.apache.tapestry.BaseComponent
addOuter, finishLoad
 
Methods inherited from class org.apache.tapestry.AbstractComponent
addAsset, addBody, addComponent, cleanupAfterRender, finishLoad, fireObservedChange, fireObservedChange, fireObservedChange, fireObservedChange, fireObservedChange, fireObservedChange, fireObservedChange, fireObservedChange, fireObservedChange, format, format, format, format, formatString, formatString, formatString, formatString, generateAttributes, getAsset, getAssets, getBeans, getBinding, getBindingNames, getBindings, getBody, getBodyCount, getChangeObserver, getComponent, getComponents, getContainer, getExtendedId, getId, getIdPath, getListeners, getMessage, getMessages, getNamespace, getPage, getProperty, getSpecification, getString, pageEndRender, prepareForRender, render, renderBody, renderInformalParameters, setBinding, setContainer, setId, setNamespace, setPage, setProperty, setSpecification, toString
 
Methods inherited from class org.apache.tapestry.spec.BaseLocatable
getLocation, setLocation
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.apache.tapestry.ILocationHolder
setLocation
 
Methods inherited from interface org.apache.tapestry.ILocatable
getLocation
 

Constructor Detail

TableFormRows

public TableFormRows()
Method Detail

getConvertor

public abstract IPrimaryKeyConvertor getConvertor()

getConvertorCache

public abstract IPrimaryKeyConvertor getConvertorCache()

setConvertorCache

public abstract void setConvertorCache(IPrimaryKeyConvertor convertor)

getConvertedValues

public abstract Map getConvertedValues()

getCachedConvertor

public IPrimaryKeyConvertor getCachedConvertor()
Returns the PK convertor cached within the realm of the current request cycle.

Returns:
the cached PK convertor

getConvertedTableRowsIterator

public Iterator getConvertedTableRowsIterator()
Get the list of all table rows to be displayed on this page, converted using the PK.convertor.

Returns:
an iterator of all converted table rows

setConvertedTableRow

public void setConvertedTableRow(Object objConvertedTableRow)
Sets the current table row PK and invokes TableRows.setTableRow(Object) as a result. This method is for internal use only.

Parameters:
objConvertedTableRow - The current converted table row (PK)