JavaFX FilteredList搜索过滤时无匹配提示Label显示异常

问题背景 #

• 在JavaFX项目中通过给TextField绑定变更监听器实现TableView过滤功能，通过Predicate判断输入文本是否匹配零件ID或名称，基础搜索功能运行符合预期。
• 需求为搜索无匹配项时显示提示Label：初始将提示Label可见性设为false，每次监听器触发时先将Label重置为不可见，所有匹配判断完成后若无匹配项则将Label设为可见。
• 异常表现：当搜索结果包含列表最后一项时运行正常，Label不会显示；如果搜索结果不包含列表最后一项，即使过滤后的列表存在匹配项，Label也会错误变为可见状态。

问题根因 #

Predicate会对列表内每一个元素单独执行一次匹配判断，你把Label可见性的更新逻辑写在了Predicate内部，会导致Label状态被单元素的判断逻辑反复覆盖：
假设列表有3个元素[A,B,C]，搜索关键词匹配A：

1. 判断元素A：匹配返回true，Predicate开头逻辑将Label设为不可见
2. 判断元素B：不匹配，走到分支末尾将Label设为可见，返回false
3. 判断元素C：不匹配，再次将Label设为可见，返回false
   最终Label状态会停在true，哪怕实际存在匹配项也会错误显示提示。只有当最后一个元素恰好匹配时，判断最后一个元素不会触发设置Label可见的逻辑，才会表现正常，和你遇到的现象完全吻合。

修复方案 #

Predicate只保留纯单元素匹配逻辑，不要在内部写依赖整体过滤结果的UI更新代码；等Predicate应用到所有元素之后，再通过过滤后列表的总长度判断是否需要显示无匹配提示。
修复后代码如下：

FilteredList<Part> filteredParts = new FilteredList<>(Inventory.getAllParts(), p -> true);       

partFilter.textProperty().addListener((ob, ol, newValue) -> {
    // 监听器触发时先统一重置提示状态，不要写在Predicate内部
    partSearchMismatch.setVisible(false);
    String lowerCaseFilter = newValue == null ? "" : newValue.toLowerCase();

    filteredParts.setPredicate(part -> {
        // 搜索框为空时返回全量数据
        if (lowerCaseFilter.isEmpty()){
            return true;
        }
        // 匹配零件ID
        if(String.valueOf(part.getId()).contains(lowerCaseFilter)){
            return true;
        }
        // 匹配零件名称
        if(part.getName().toLowerCase().contains(lowerCaseFilter)){
            return true;
        }
        // 单元素不匹配仅返回false，不在这里修改全局UI状态
        return false;
    });

    // 所有元素判断完成后，根据过滤列表总长度统一设置提示可见性
    partSearchMismatch.setVisible(filteredParts.isEmpty());
});

// 包装过滤列表为支持排序的列表
SortedList<Part> sortedParts = new SortedList<>(filteredParts);
// 绑定表格排序规则到排序列表
sortedParts.comparatorProperty().bind(partsTable.comparatorProperty());
partsTable.setItems(sortedParts);

注意事项 #

• Predicate的职责仅为单元素匹配判断，会被每个列表元素各调用一次，禁止在其中编写依赖全局遍历结果的逻辑，否则会出现状态被反复覆盖的问题。
• 过滤结果的全局判断要等Predicate完全应用后，通过FilteredList本身的属性（比如长度）判断，结果才准确。

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