Primefaces 8迁移至12：如何通过SortEvent获取排序列？

方法一：使用官方推荐的SortEvent（优先选择） #

PrimeFaces 10+的SortEvent直接提供了排序元数据，无需从数据源间接获取，替代原有的AjaxBehaviorEvent即可：

1. 修改JSF页面的Ajax监听

无需额外传参，保持原有写法：

<p:dataTable id="searchResultsTable" 
    value="#{nameBackingBean.queryResults}"
    var="searchResultsRow" widgetVar="tableWidget"
    sortBy="#{searchResultsRow.name}" sortOrder="ascending">
    
    <p:ajax event="sort" listener="#{nameBackingBean.sortedColumnSelected}" />
    
    <!-- 列定义保持不变 -->
</p:dataTable>

2. 更新托管Bean方法

替换事件类型为SortEvent，直接获取排序信息：

import org.primefaces.event.SortEvent;
import org.primefaces.model.SortMeta;
import org.primefaces.model.SortOrder;

public void sortedColumnSelected(SortEvent event) {
    List<SortMeta> sortMetaList = event.getSortMeta();
    if (!sortMetaList.isEmpty()) {
        // 单排序场景取第一个元素，多排序需遍历list
        SortMeta sortMeta = sortMetaList.get(0);
        String sortField = sortMeta.getSortField(); // 对应列sortBy的属性名（如"name"）
        SortOrder sortOrder = sortMeta.getSortOrder(); // 排序顺序：ASCENDING/DESCENDING/UNSORTED
        
        // 按字段执行对应逻辑
        if ("name".equals(sortField)) {
            // Name列排序后的操作
        } else if ("age".equals(sortField)) {
            // Age列排序后的操作
        }
    }
}

方法二：通过EL表达式直接传递排序信息 #

如果需要显式通过EL传参到监听方法，可直接引用DataTable组件的sortMeta属性：

1. 修改JSF页面的Ajax监听

<p:ajax event="sort" listener="#{nameBackingBean.sortedColumnSelected(searchResultsTable.sortMeta)}" />

2. 更新托管Bean方法

接收List<SortMeta>参数：

import org.primefaces.model.SortMeta;
import org.primefaces.model.SortOrder;

public void sortedColumnSelected(List<SortMeta> sortMetaList) {
    if (!sortMetaList.isEmpty()) {
        SortMeta sortMeta = sortMetaList.get(0);
        String sortField = sortMeta.getSortField();
        SortOrder sortOrder = sortMeta.getSortOrder();
        
        // 执行对应逻辑
        if ("name".equals(sortField)) {
            // 操作
        } else if ("age".equals(sortField)) {
            // 操作
        }
    }
}

也可以单独传递排序字段和顺序：

<p:ajax event="sort" listener="#{nameBackingBean.sortedColumnSelected(searchResultsTable.sortMeta[0].sortField, searchResultsTable.sortMeta[0].sortOrder)}" />

对应Bean方法：

import org.primefaces.model.SortOrder;

public void sortedColumnSelected(String sortField, SortOrder sortOrder) {
    if ("name".equals(sortField)) {
        // 根据排序顺序执行操作
    } else if ("age".equals(sortField)) {
        // 操作
    }
}

注意事项 #

• sortMeta是List类型，支持多列排序，单排序场景取第一个元素即可
• 用sortField（对应列sortBy的属性名）替代原有的headerText判断，避免因国际化或文本修改导致逻辑失效
• 优先使用SortEvent方式，符合PrimeFaces官方设计规范，兼容性更好

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