A utility class for radiobutton and checkbox components used to select rows
of a table.
Note: UI guidelines recomend that rows should be unselected when no longer in
view. For example, when a user selects rows of the table and navigates to
another page. Or, when a user applies a filter or sort that may hide
previously selected rows from view. If a user invokes an action to delete the
currently selected rows, they may inadvertently remove rows not displayed on
the current page. Using TableSelectPhaseListener ensures that invalid row
selections are not rendered by clearing selected state after the render
response phase. That said, there are cases when maintaining state across
table pages is necessary. In this scenario, use the keepSelected method to
prevent state from being cleared by this instance.
Note: To see the messages logged by this class, set the following global
defaults in your JDK's "jre/lib/logging.properties" file.
java.util.logging.ConsoleHandler.level = FINE
com.sun.rave.web.ui.event.TableSelectPhaseListener.level = FINE
|