Specifies a control that traverses a com.webmethods.caf.faces.data.ITableContentProvider object displaying the control's content for each row in the provider.

Standard list-like containers 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 data model is mapped to a row in the list. The content of the list is rendered multiple times, once for each row displayed. The difference between the async list and a regular list is that the async list pages asynchronously. See the Async Table control (caf_h\dataAsyncTable) for more information about configuring its asynchronous properties.

To enable restful paging, you must set the list's firstParamName property to the name of the request parameter from which the list derives its first property. For example, conider a case where the list binds the myFirst request parameter to its first property, where an example URL is /myTable?myFirst=10. Using a value binding expression, #{param.myFirst}, you would set the value of the list's firstParamName property to "myFirst". Note that to bind the value of a request parameter to the list's first property, you must manually convert the request parameter value to a primitive int (see the getMyFirst() method below). The list does not need to be contained within a Command Form to do restful paging.

To enable restful page sizing, you must set the list's rowsParamName property to the name of the request parameter from which the list derives its rows property. For example, if the list binds the myRows request parameter to its rows property, where an example URL might be /myTable?myRows=10, you would set the value of the list's rowsParamName property to "myRows". To bind the value of a request parameter to the list's rows property, you must manually convert the request parameter value to a primitive int, see the getMyRows() method below for an example. The list does not need to be contained within a Command Form to do restful paging.

// 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;
}


Children

Any.