JavaFX优化：如何在TableColumn宽度调整结束后仅执行一次保存

我写了一段Java代码，用来把TableView的TableColumn宽度保存到偏好设置里：

column.widthProperty().addListener((obs, oldWidth, newWidth) -> {
            setTablePreference().saveColumnWidthSetting(newWidth.doubleValue(), column.getId().concat(columnWidthSettingsCommons.toString()));
        });

这段代码功能正常，拖动列宽时会自动保存，但有优化空间——调整列宽的过程中，监听器会响应每一次宽度变化，导致这段代码被执行几百次。

我想让这段代码只在宽度停止变化后执行一次。之前试过用独立线程，但反而会创建几百个线程，完全达不到优化性能的目的：

column.widthProperty().addListener((obs, oldWidth, newWidth) -> {
            new Thread(new Task<>() {
                @Override
                protected Object call() {
                    setTablePreference().saveColumnWidthSetting(newWidth.doubleValue(), column.getId().concat(columnWidthSettingsCommons.toString()));
                    return null;
                }
            }).start();
        });

所以我的问题是：有没有办法让这段代码在监听器停止接收新值之后再执行一次？

你需要的是防抖逻辑——在事件停止触发一段时间后再执行目标操作，而不是每次事件触发都执行。JavaFX里可以用PauseTransition来实现这个功能：

// 为每个列创建独立的PauseTransition实例，控制延迟执行
PauseTransition widthChangeDebounce = new PauseTransition(Duration.millis(300));

column.widthProperty().addListener((obs, oldWidth, newWidth) -> {
    // 每次宽度变化时，重置延迟计时器
    widthChangeDebounce.stop();
    widthChangeDebounce.setDuration(Duration.millis(300));
    
    // 设置计时器结束后执行的保存操作
    widthChangeDebounce.setOnFinished(event -> {
        setTablePreference().saveColumnWidthSetting(newWidth.doubleValue(), column.getId().concat(columnWidthSettingsCommons.toString()));
    });
    
    // 启动计时器
    widthChangeDebounce.play();
});

原理说明 #

• 每次拖动列宽触发宽度变化时，都会先停止当前的计时器，再重新启动一个300毫秒的计时器（时长可根据需求调整，比如200-500毫秒都合适）。
• 只有当用户停止拖动列宽，且指定时长内没有新的宽度变化事件触发时，计时器才会完成，执行一次保存偏好设置的代码。
• 这样就能避免频繁执行保存操作，只在用户调整完列宽后执行一次。

注意事项 #

• 务必给每个TableColumn分配独立的PauseTransition实例，不要多个列共享同一个，否则会出现计时器互相干扰的问题。
• 如果保存操作涉及IO或其他耗时逻辑，建议把保存代码放到后台线程执行，但不要每次新建线程——可以复用线程池，或者用Task配合ExecutorService处理；不过JavaFX的Preferences本身是线程安全的，直接执行也不会有问题。

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