PrimeFaces autocomplete的groupBy仅对有序条目生效，如何避免重复分组？

我在使用PrimeFaces的AutoComplete组件并启用groupBy功能，相关代码如下：

页面代码 #

<h:form>
    <p:autoComplete placeholder="Select something"
                    size="27"
                    dropdown="true"
                    forceSelection="true"
                    var="value"
                    itemLabel="#{value}"
                    itemValue="#{value}"
                    value="#{autoCompleteGroupByBean.selection}"
                    completeMethod="#{autoCompleteGroupByBean.complete}"
                    groupBy="#{autoCompleteGroupByBean.getGroup(value)}" />
</h:form>

后端Bean代码 #

package org.primefaces.test.view;

import lombok.Getter;
import lombok.Setter;
import org.apache.commons.lang3.StringUtils;

import javax.annotation.PostConstruct;
import javax.faces.view.ViewScoped;
import javax.inject.Named;
import java.io.Serializable;
import java.util.*;
import java.util.stream.Collectors;

@Setter
@Getter
@Named
@ViewScoped
public class AutoCompleteGroupByBean implements Serializable {

    private List<String> values;
    private List<String> groups;
    private String selection;

    @PostConstruct
    public void initialize() {
        values = Arrays.asList(
                "ABC value0", "ABC value1", "ABC value2", "ABC value3",
                "DEF value0", "DEF value1", "DEF value2", "DEF value3",
                "GHI value0", "GHI value1", "GHI value2", "GHI value3");
        // 如果打乱值的顺序，分组会重复出现
        // Collections.shuffle(values);
        groups = Arrays.asList("ABC", "DEF", "GHI");
    }

    public List<String> complete(final String query) {
        return values.stream()
                .filter(v -> StringUtils.containsIgnoreCase(v, query))
                .collect(Collectors.toList());
    }

    public String getGroup(final String value) {
        return groups.stream()
                .filter(g -> StringUtils.startsWithIgnoreCase(value, g))
                .findAny()
                .orElse("MISC");
    }
}

当值按分组有序排列时，组件显示正常（每个分组仅显示一次标题）；但将值打乱顺序后（示例中启用Collections.shuffle()），会出现同一分组多次显示标题的情况。

实际项目中，我从外部服务获取数据，且分组标识并不总是在条目开头，请问有没有办法避免重复分组，还是必须预先对所有值按分组排序？

解决方案：通过分组聚合重组结果列表，无需全量排序 #

PrimeFaces AutoComplete的groupBy逻辑是按返回列表的顺序依次渲染，只有当遇到新的分组键时才会创建分组标题。因此只要保证同一分组的所有项连续排列，就能避免重复分组，不需要预先对全量数据排序，仅需处理过滤后的结果即可。

方案1：基于预设分组列表的聚合（适用于分组已知的场景）

修改complete方法，先过滤数据，再按预设分组顺序聚合项，确保同分组项连续：

public List<String> complete(final String query) {
    // 1. 过滤符合查询条件的项
    List<String> filteredItems = values.stream()
            .filter(v -> StringUtils.containsIgnoreCase(v, query))
            .collect(Collectors.toList());
    
    // 2. 按预设分组顺序，依次收集对应分组的项
    List<String> groupedResult = new ArrayList<>();
    for (String group : groups) {
        filteredItems.stream()
                .filter(item -> StringUtils.startsWithIgnoreCase(item, group))
                .forEach(groupedResult::add);
    }
    
    // 3. 添加不属于预设分组的MISC项
    filteredItems.stream()
            .filter(item -> groups.stream().noneMatch(g -> StringUtils.startsWithIgnoreCase(item, g)))
            .forEach(groupedResult::add);
    
    return groupedResult;
}

方案2：动态分组聚合（适用于分组键动态计算的场景）

如果分组键是通过getGroup方法动态计算的，可通过groupingBy先分组，再重组为连续列表：

public List<String> complete(final String query) {
    return values.stream()
            .filter(v -> StringUtils.containsIgnoreCase(v, query))
            // 按动态分组键分组，用LinkedHashMap保证分组顺序稳定
            .collect(Collectors.groupingBy(this::getGroup, LinkedHashMap::new, Collectors.toList()))
            .entrySet().stream()
            // 可选：按分组键排序，让分组显示顺序更规整
            .sorted(Map.Entry.comparingByKey())
            // 将每个分组的所有项展开为连续列表
            .flatMap(entry -> entry.getValue().stream())
            .collect(Collectors.toList());
}

核心逻辑 #

两种方案都是通过先按分组键聚合，再将同分组的项连续排列，让AutoComplete组件渲染时每个分组仅触发一次标题创建，从根源避免重复分组。这种方式仅处理过滤后的结果，比全量排序更高效，也适配外部服务返回的无序数据。

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