A table whose content comes from a javax.faces.model.DataModel object, or a com.webmethods.caf.faces.data.ITableContentProvider object. Standard list-like containers, such as java.util.List are wrapped automatically as an ITableContentProvider. The following containers are wrapped automatically:

• java.lang.Object array
• java.util.List
• javax.sql.rowset.CachedRowset

Each item in the list is mapped to a row in the table. Columns are configured by adding Basic Column controls as children.

To enable restful paging, you must set the tables's firstParamName property to the name of the request parameter from which the table derives its first property. For example, if the table binds the myFirst request parameter, where an example url is '/myTable?myFirst=10' to its first property, using a value binding expression #{param.myFirst}, you would set the value of the table's firstParamName property to "myFirst". Note that in order to bind the value of a request parameter to the table's first property, you must manually convert the request parameter value to a primitive int. You do not need to contain the table in a command Form to do restful paging.

To enable restful page sizing, you must set the tables's rowsParamName property to the name of the request parameter from which the table derives its rows property. For example, if the table binds the myRows request parameter, where an example url is '/myTable?myRows=10' to its rows property, you would set the value of the table's rowsParamName property to "myRows". To bind the value of a request parameter to the table's rows property, you must manually convert the request parameter value to a primitive int (see the following getMyRows() method). You do not need to contain the table in a command Form to do restful page sizing.

To enable "restful" sorting, you must set the tables's sortParamName property to the name of the request parameter from which the table derives its sort property. For example, if the table binds the mySort request parameter, where an example url is '/myTable?mySort=name-,description+' to the ordinals and ascending properties of its contained columns, you would set the value of the table's sortParamName property to "mySort". Note that in order to bind the value of a request parameter to the table's sort property, you must manually convert the request parameter value to an ISortInfo object (see the following getMySort() method). You do not need to contain the table in a command Form to do restful page sizing.

// Convert "myFirst" request parameter to a primitive int.
public int getMyFirst() {
     FacesContext context = FacesContext.getCurrentInstance();
     String s = (String)
context.getExternalContext().getRequestParameterMap().get("myFirst");
     if (s != null)
     return Integer.parseInt(s);
     return 0;
}
// Convert "myRows" request parameter to a primitive int.
public int getMyRows() {
     FacesContext context = FacesContext.getCurrentInstance();
     String s = (String)
context.getExternalContext().getRequestParameterMap().get("myRows");
     if (s != null)
     return Integer.parseInt(s);
     return 10;
}
// Convert "mySort" request parameter to structured ISortInfo data.
public ISortInfo getMySort() {
     FacesContext context = FacesContext.getCurrentInstance();
     String s = (String)
context.getExternalContext().getRequestParameterMap().get("mySort");
     return (s != null ? new SortInfo(s) : new SortInfo());
}