javax.faces.model

Class ArrayDataModel<E>

Contents
  • All Implemented Interfaces:
    Iterable<E>

    public class ArrayDataModel<E>
extends DataModel<E>

    ArrayDataModel is a convenience implementation of DataModel that wraps an array of Java objects.

    • Constructor Detail

      • ArrayDataModel

        public ArrayDataModel()

        Construct a new ArrayDataModel with no specified wrapped data.

      • ArrayDataModel

        public ArrayDataModel(E[] array)

        Construct a new ArrayDataModel wrapping the specified array.

        Parameters:
        array - Array to be wrapped (if any)

    • Method Detail

      • isRowAvailable

        public boolean isRowAvailable()

        Return true if there is wrappedData available, and the current value of rowIndex is greater than or equal to zero, and less than the length of the array. Otherwise, return false.

        Specified by:
        isRowAvailable in class DataModel<E>
        Throws:
        FacesException - if an error occurs getting the row availability

      • getRowCount

        public int getRowCount()

        If there is wrappedData available, return the length of the array. If no wrappedData is available, return -1.

        Specified by:
        getRowCount in class DataModel<E>
        Throws:
        FacesException - if an error occurs getting the row count

      • getRowData

        public E getRowData()

        If row data is available, return the array element at the index specified by rowIndex. If no wrapped data is available, return null.

        Specified by:
        getRowData in class DataModel<E>
        Throws:
        FacesException - if an error occurs getting the row data
        IllegalArgumentException - if now row data is available at the currently specified row index

      • getRowIndex

        public int getRowIndex()
        Description copied from class: DataModel

        Return the zero-relative index of the currently selected row. If we are not currently positioned on a row, or no wrappedData is available, return -1.

        Specified by:
        getRowIndex in class DataModel<E>
        Throws:
        FacesException - if an error occurs getting the row index

      • setRowIndex

        public void setRowIndex(int rowIndex)
        Description copied from class: DataModel

        Set the zero-relative index of the currently selected row, or -1 to indicate that we are not positioned on a row. It is possible to set the row index at a value for which the underlying data collection does not contain any row data. Therefore, callers may use the isRowAvailable() method to detect whether row data will be available for use by the getRowData() method.

        If there is no wrappedData available when this method is called, the specified rowIndex is stored (and may be retrieved by a subsequent call to getRowData()), but no event is sent. Otherwise, if the currently selected row index is changed by this call, a DataModelEvent will be sent to the rowSelected() method of all registered DataModelListeners.

        Specified by:
        setRowIndex in class DataModel<E>
        Parameters:
        rowIndex - The new zero-relative index (must be non-negative)
        Throws:
        FacesException - if an error occurs setting the row index
        IllegalArgumentException - if rowIndex is less than -1

      • setWrappedData

        public void setWrappedData(Object data)
        Description copied from class: DataModel

        Set the object representing the data collection wrapped by this DataModel. If the specified data is null, detach this DataModel from any previously wrapped data collection instead.

        If data is non-null, the currently selected row index must be set to zero, and a DataModelEvent must be sent to the rowSelected() method of all registered DataModelListeners indicating that this row is now selected.

        Specified by:
        setWrappedData in class DataModel<E>
        Parameters:
        data - Data collection to be wrapped, or null to detach from any previous data collection
        Throws:
        ClassCastException - if data is non-null and is not an array of Java objects.

Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/faces/model/ArrayDataModel.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : https://docs.oracle.com, ArrayDataModel (Java(TM) EE 7 Specification APIs)

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.