如何向JavaFX TableView特定行添加数据并实现追加不覆盖？

开发者阿泽

2026-8-7

JavaFX TableView 数据追加与重复行检测解决方案

问题根源分析

从你的代码来看，数据被覆盖无法追加的核心原因有三点：

User类单例滥用：User采用单例模式，每次点击添加都是修改同一个实例的属性，没有创建新用户对象，导致旧数据被覆盖。
数据未持久化共享：每次打开用户列表页面时，都会新建UsersController并重新初始化列表，之前添加的用户数据没有被保留。
缺少追加逻辑：当前代码仅在初始化时设置一次列表，没有实现向现有列表中添加新用户的逻辑。

分步解决方案

1. 重构User类，移除单例模式

每个用户应该是独立的对象，单例会导致所有操作指向同一个实例，直接修改就会覆盖旧数据。修改后的User类：

package entropy.myproject1;

import javafx.beans.property.SimpleIntegerProperty;
import javafx.beans.property.SimpleStringProperty;

public class User {
    private SimpleIntegerProperty id;
    private SimpleStringProperty username;
    private SimpleStringProperty password;

    public User(Integer id, String username, String password) {
        this.id = new SimpleIntegerProperty(id);
        this.username = new SimpleStringProperty(username);
        this.password = new SimpleStringProperty(password);
    }

    public User() {}

    public int getId() {
        return id.get();
    }

    public String getUsername() {
        return username.get();
    }

    public String getPassword() {
        return password.get();
    }

    public void setId(int id) {
        this.id = new SimpleIntegerProperty(id);
    }

    public void setUsername(String username) {
        this.username = new SimpleStringProperty(username);
    }

    public void setPassword(String password) {
        this.password = new SimpleStringProperty(password);
    }

    @Override
    public String toString() {
        return getId() + " " + getUsername() + " " + getPassword();
    }
}

2. 修改RegisterController，实现数据存储与重复检测

将用户列表存储在RegisterController中，每次添加时创建新User实例，并检查ID是否已存在（实现行占用检测）：

package entropy.myproject1;

import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.fxml.FXMLLoader;
import javafx.scene.Node;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.control.Button;
import javafx.scene.control.TextField;
import javafx.stage.Stage;

import java.io.IOException;

public class RegisterController {
    private Stage stage;
    private Scene scene;
    private static final RegisterController instance = new RegisterController();
    public static RegisterController getInstance(){
        return instance;
    }

    // 全局共享的用户列表
    private ObservableList<User> userList = FXCollections.observableArrayList();

    @FXML
    private Button buttonAdd;

    @FXML
    private TextField tfID;

    @FXML
    private TextField tfPassword;

    @FXML
    private TextField tfUsername;

    @FXML
    void addOnClick(ActionEvent event){
        // 获取输入数据并创建新用户实例
        int id = Integer.parseInt(tfID.getText());
        String username = tfUsername.getText();
        String password = tfPassword.getText();
        User newUser = new User(id, username, password);

        // 检测ID是否已存在（判断目标行/用户是否被占用）
        boolean idExists = userList.stream().anyMatch(user -> user.getId() == id);
        if(idExists){
            System.out.println("ID " + id + " 已被占用，请更换");
            return;
        }

        // 将新用户追加到列表
        userList.add(newUser);
        System.out.println(newUser.toString());

        // 清空输入框
        tfID.clear();
        tfUsername.clear();
        tfPassword.clear();
    }

    @FXML
    void showListOnClick(ActionEvent event) throws IOException {
        FXMLLoader loader = new FXMLLoader(getClass().getResource("userspage.fxml"));
        Parent root = loader.load();

        // 将共享列表传递给UsersController
        UsersController usersController = loader.getController();
        usersController.setUserList(userList);

        stage = (Stage)((Node)event.getSource()).getScene().getWindow();
        scene = new Scene(root);
        stage.setScene(scene);
        stage.setTitle("User List");
        stage.show();
    }

    public ObservableList<User> getUserList() {
        return userList;
    }
}

3. 修改UsersController，接收共享数据并初始化表格

不再自行初始化列表，而是接收RegisterController传递的共享列表，确保每次打开页面都能显示所有已添加的用户：

package entropy.myproject1;

import javafx.collections.ObservableList;
import javafx.fxml.FXML;
import javafx.fxml.Initializable;
import javafx.scene.control.TableColumn;
import javafx.scene.control.TableView;
import javafx.scene.control.cell.PropertyValueFactory;

import java.net.URL;
import java.util.ResourceBundle;

public class UsersController implements Initializable {

    @FXML
    private TableColumn<User, Integer> colID;

    @FXML
    private TableColumn<User, String> colPassword;

    @FXML
    private TableColumn<User, String> colUsername;

    @FXML
    private TableView<User> table;

    private ObservableList<User> userList;

    @Override
    public void initialize(URL url, ResourceBundle resourceBundle) {
        // 绑定表格列与User类属性
        colID.setCellValueFactory(new PropertyValueFactory<>("id"));
        colUsername.setCellValueFactory(new PropertyValueFactory<>("username"));
        colPassword.setCellValueFactory(new PropertyValueFactory<>("password"));
    }

    // 接收共享的用户列表并设置给表格
    public void setUserList(ObservableList<User> userList) {
        this.userList = userList;
        table.setItems(userList);
    }
}

核心要点

独立用户实例：每次添加用户都创建新的User对象，避免单例导致的数据覆盖。
共享ObservableList：用同一个可观察列表存储所有用户，确保控制器之间数据同步，TableView会自动刷新显示新数据。
重复检测逻辑：通过流操作检查ID是否已存在，可扩展为检测用户名等其他唯一字段，实现“识别目标行是否被占用”的需求。

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