PrimeFaces DataTable rowSelect与复选框联动及分页状态保存问题

问题根源 #

• 现有全局checked变量是bean级单值，无法对应多行的独立选中状态，完全不支持多选场景
• 行选中/取消事件未同步修改对应行subDir对象的selected属性，导致复选框状态和行状态脱节
• 复选框修改后未同步更新PrimeFaces DataTable内置的selection选中集合，分页切换时PrimeFaces只会基于自身维护的selection集合回显状态，未同步的复选框状态自然会丢失
• 多余的<f:attribute name="checked"/>硬编码属性会和复选框自身绑定的value属性冲突，进一步导致状态混乱

修复方案 #

1. 修改页面代码 #

<p:dataTable value="#{machine.sub}" var="subDir" 
             id="fileDirectories" rowClasses="row1-whitebg,row2-bluebg" 
             selectionMode="multiple" selectionPageOnly="false" 
             rowKey="#{subDir.directory.path}" headerClass="title-column" 
             rowIndexVar="idx" rows="10" rowsPerPageTemplate="10,20,50" paginator="true" 
             paginatorAlwaysVisible="false" 
             paginatorTemplate="#{WebConstant.PAGINATOR_TEMPLATE}"
             <!-- 新增绑定选中行集合 -->
             selection="#{machine.selectedDirs}">

            <!-- 行选中/取消事件传入当前行对象，同步更新行对应的selected属性 -->
            <p:ajax event="rowSelect" listener="#{machine.selectedRow(subDir)}" update="panelGroupChkSelect"/>
            <p:ajax event="rowUnselect" listener="#{machine.unSelectedRow(subDir)}" update="panelGroupChkSelect"/>
    
            <p:column>
                <f:facet name="header">
                    <h:outputText value="#{msg['machine_download']}"/>
                </f:facet>
                <h:panelGroup id="panelGroupChkSelect">
                    <h:selectBooleanCheckbox id="chkSelect" value="#{subDir.selected}"
                                             rendered="#{subDir.directory.file}">
                        <!-- 删除原有的c:if硬编码checked属性逻辑，完全依赖value绑定 -->
                        <!-- 新增复选框change事件，同步更新DataTable选中集合 -->
                        <f:ajax event="change" listener="#{machine.toggleSelection(subDir)}" render="@this fileDirectories"/>
                    </h:selectBooleanCheckbox>
                </h:panelGroup>
            </p:column>
</p:dataTable>

2. 修改Java代码 #

import org.primefaces.PrimeFaces;
import java.util.ArrayList;
import java.util.List;

// 请确保你的bean是@ViewScoped作用域，避免分页时变量重置
private List<SubDir> selectedDirs = new ArrayList<>(); // SubDir替换为你的subDir对应实体类名

// 行选中时同步修改当前行的selected属性
public void selectedRow(SubDir subDir) {
    subDir.setSelected(true);
}

// 行取消选中时同步修改当前行的selected属性
public void unSelectedRow(SubDir subDir) {
    subDir.setSelected(false);
}

// 复选框点击时同步更新DataTable选中集合
public void toggleSelection(SubDir subDir) {
    if (subDir.isSelected()) {
        if (!selectedDirs.contains(subDir)) {
            selectedDirs.add(subDir);
        }
    } else {
        selectedDirs.remove(subDir);
    }
}

// 生成selectedDirs的getter、setter方法
public List<SubDir> getSelectedDirs() {
    return selectedDirs;
}

public void setSelectedDirs(List<SubDir> selectedDirs) {
    this.selectedDirs = selectedDirs;
}

// 删除原有的全局checked变量、checkButton方法相关代码

注意：请确保你的SubDir实体类已经重写equals()和hashCode()方法，判断逻辑基于rowKey对应的directory.path属性，避免selectedDirs的增删判断出错。

验证逻辑 #

修改完成后：

• 点击行选中时，会自动把对应行selected属性设为true，复选框同步勾选
• 勾选复选框时，会自动把对应行加入DataTable的selectedDirs选中集合，行同步高亮选中
• 分页切换时PrimeFaces基于selectedDirs集合回显行选中状态，复选框基于行的selected属性回显，两边状态完全一致不会丢失

内容的提问来源于stack exchange，提问作者janksion