Project Documentation
Foundation

Description

A tag that defines an automatically update DataTable Ajax binding.
This allows you to do frequency controlled update via asynchronous server requests - Ajax.

Note: This component is deprecated; Use pprPeriodicalUpdate instead!

Screen Shot

autoUpdateDataTable

API

component-family javax.faces.Data
renderer-type org.apache.myfaces.AutoUpdateDataTable
component-class org.apache.myfaces.custom.autoupdatedatatable.AutoUpdateDataTable
renderer-class org.apache.myfaces.custom.autoupdatedatatable.AutoUpdateDataTableRenderer
tag-class org.apache.myfaces.custom.autoupdatedatatable.AutoUpdateDataTableTag

Usage

                <s:autoUpdateDataTable [ all standard dataTable attributes allowed ]
                [ preserveDataModel="{true|false}" ]
                [ forceIdIndexFormula="value-binding" ]
                [ sortColumn="value-binding" ]
                [ sortAscending="value-binding" ]
                [ preserveSort="{true|false}" ]
                [ frequency="value-binding" ]>
                standard dataTable body (<h:column> tags and optional "header" and "footer" facets)
                </t:command_sortheader>
                <s:autoUpdateDataTable>
            

Syntax

<s:autoUpdateDataTable>

all standard dataTable attributes allowed
preserveDataModel="{true|false}"
forceIdIndexFormula="value-binding"
sortColumn="value-binding"
sortAscending="value-binding"
preserveSort="{true|false}"
frequency="value-binding"

Instructions

frequency - defines the time in seconds between the Ajax-Requests

Note - This component is different to others, it uses Ajax mechanisms to fetch data from the server, thus the backend binding can and will be used outside of the standard JSF lifecycle to deliver the data.

Use the autoUpdateDataTable tag always within a form tag.

It is also not very advisable, to put some input fields (or checkboxes, radio buttons, etc.) into the dataTable, since after every submit (which happens periodically) all the form data is cleared.

see examples/ajaxDataTableSingle.jsp for an example.