JavaFX TableView更新列表后未刷新问题排查与解决

为什么TableView不更新？ #

核心问题出在数据源的可观察性上：
你用FXCollections.observableArrayList(list)创建了一个ObservableList，但这个方法只是把普通ArrayList里的现有元素拷贝到新的ObservableList中，并不会让原来的list本身变成可观察集合。当你后续调用list.clear()和list.addAll(newList)修改普通ArrayList时，TableView绑定的那个ObservableList完全不知道底层数据变了——tableView.refresh()只是刷新当前已加载的内容，不会触发数据源的重新读取，所以界面自然没变化。

两种解决办法，推荐第一种： #

方法一：直接使用ObservableList作为全局数据源（最省心）

把全局的普通List换成JavaFX的ObservableList，它自带数据变化通知机制，修改时TableView会自动更新，不需要手动调用refresh()：

// 全局变量改成ObservableList
static ObservableList<Foo> list = FXCollections.observableArrayList();

@Override
public void start(Stage primaryStage){
    TableView<Foo> tableView = new TableView<>();
    tableView.setPlaceholder(new Label("No data"));
    
    TableColumn<Foo, Integer> colIndex = new TableColumn<>("index");
    colIndex.setCellValueFactory(new PropertyValueFactory<>("index"));
    tableView.getColumns().add(colIndex);
    
    // 直接绑定ObservableList
    tableView.setItems(list);
    
    Button btn = new Button("update list");
    btn.setOnMouseClicked(e -> {
        Random r = new Random();
        List<Foo> newList = new ArrayList<>();
        newList.add(new Foo(r.nextInt()));
        newList.add(new Foo(r.nextInt()));
        
        list.clear();
        list.addAll(newList);
        list.forEach(e1 -> System.out.println(e1.getIndex()));
        
        // 这里完全不需要调用tableView.refresh()！
    });
    
    VBox vbox = new VBox();
    vbox.getChildren().addAll(btn, tableView);
    primaryStage.setScene(new Scene(vbox));
    primaryStage.show();
}

方法二：如果必须用普通ArrayList，手动更新ObservableList

要是你坚持用普通ArrayList，那每次修改后需要让TableView绑定的ObservableList同步更新，比如重新设置items，或者更新已有ObservableList的内容：

// 先在start方法里保存ObservableList的引用
ObservableList<Foo> observableItems = FXCollections.observableArrayList(list);
tableView.setItems(observableItems);

// 按钮点击事件里，修改完list后同步更新observableItems
btn.setOnMouseClicked(e -> {
    Random r = new Random();
    List<Foo> newList = new ArrayList<>();
    newList.add(new Foo(r.nextInt()));
    newList.add(new Foo(r.nextInt()));
    
    list.clear();
    list.addAll(newList);
    list.forEach(e1 -> System.out.println(e1.getIndex()));
    
    // 同步更新ObservableList，触发TableView更新
    observableItems.setAll(list);
    // 或者重新设置items：tableView.setItems(FXCollections.observableArrayList(list));
});

额外优化建议：让Foo类支持属性监听 #

如果后续需要修改单个Foo对象的index值，希望TableView也能自动更新，建议把Foo的属性改成JavaFX的Property类型：

public class Foo {
    private final IntegerProperty index = new SimpleIntegerProperty();
    
    public Foo(int index) {
        this.index.set(index);
    }
    
    public int getIndex() {
        return index.get();
    }
    
    public IntegerProperty indexProperty() {
        return index;
    }
    
    public void setIndex(int index) {
        this.index.set(index);
    }
}

然后TableColumn的cellValueFactory可以改成更规范的写法：

colIndex.setCellValueFactory(cellData -> cellData.getValue().indexProperty());

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