JavaFX 11 ChoiceBox修改选项时卡顿问题求助

核心问题分析 #

卡顿根源在于频繁直接修改ChoiceBox的ObservableList，触发UI实时刷新；并发异常则是因为尝试在非JavaFX应用线程（UI线程）操作UI绑定的列表组件——JavaFX所有UI相关操作必须在FX线程执行。

优化方案 #

用数据驱动UI的思路重构代码，结合FilteredList避免直接修改下拉列表，同时通过列表监听器自动同步数据与UI，彻底解决卡顿和并发问题。

重构后代码 #

default VBox newMultiSelectStringEditor(ListProperty<String> property, String caption, ObservableList<String> allValues) {
    VBox vBox = new VBox();
    Label label = new Label(caption);

    // 用FilteredList自动过滤已选中的项，避免直接修改下拉列表
    FilteredList<String> availableValues = new FilteredList<>(allValues, item -> !property.contains(item));
    ChoiceBox<String> choiceBox = new ChoiceBox<>(availableValues);

    VBox innerVBox = new VBox();
    innerVBox.setSpacing(5.0);
    innerVBox.setPadding(new Insets(5));

    // 监听数据源变化，自动同步UI
    property.addListener((ListChangeListener.Change<? extends String> change) -> {
        while (change.next()) {
            // 新增元素时自动创建并添加UI组件
            if (change.wasAdded()) {
                for (String item : change.getAddedSubList()) {
                    MultiSelectStringOption option = new MultiSelectStringOption(item);
                    option.setOnAction(e -> property.remove(item));
                    innerVBox.getChildren().add(option);
                }
            }
            // 移除元素时自动匹配并删除对应UI组件
            if (change.wasRemoved()) {
                innerVBox.getChildren().removeIf(node -> {
                    if (node instanceof MultiSelectStringOption opt) {
                        return change.getRemoved().contains(opt.getText());
                    }
                    return false;
                });
            }
            // 刷新下拉列表的过滤条件
            availableValues.setPredicate(item -> !property.contains(item));
        }
    });

    // 初始化已有的数据到UI
    for (String item : property) {
        MultiSelectStringOption option = new MultiSelectStringOption(item);
        option.setOnAction(e -> property.remove(item));
        innerVBox.getChildren().add(option);
    }

    // 下拉选择逻辑：仅修改数据源，UI自动同步
    choiceBox.getSelectionModel().selectedItemProperty().addListener((obs, oldVal, newVal) -> {
        if (newVal != null && !newVal.isBlank()) {
            choiceBox.getSelectionModel().clearSelection();
            property.add(newVal);
        }
    });

    choiceBox.setMinWidth(680.0);
    choiceBox.setPrefWidth(680.0);

    vBox.getChildren().addAll(label, innerVBox, choiceBox);
    return vBox;
}

关键优化点说明 #

• FilteredList替代直接修改：通过过滤条件隐藏已选中元素，无需频繁增删下拉列表项，彻底消除UI刷新卡顿。
• 数据驱动UI：仅维护property这一个数据源，UI组件的增删通过列表监听器自动完成，减少手动操作UI的重复代码，降低出错概率。
• 避免并发异常：JavaFX的列表监听器默认在FX线程执行，所有UI相关操作都符合线程规范，无需额外处理线程切换。
• 简化移除逻辑：移除按钮只需修改数据源，UI会自动同步，不用同时操作UI组件和数据列表。

额外注意事项 #

• 确保MultiSelectStringOption类提供getText()方法（或类似方法）用于获取显示的字符串，方便匹配移除对应的UI组件。
• 如果需要从后台线程更新property，必须用Platform.runLater(() -> property.add/remove(item))包裹操作，确保在FX线程执行。

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