JavaFX TableView 动态过滤与选中项获取及跨视图数据传递教程

本教程详细阐述了如何在 javafx 中实现 tableview 的动态数据过滤功能，通过 textfield 实时更新显示内容。重点讲解了如何在用户点击按钮时，从已过滤的 tableview 中准确获取当前显示的数据（特别是第一个匹配项），并演示了如何将这些获取到的数据安全地传递给另一个 fxml 视图及其控制器，以实现复杂的应用交互逻辑。

JavaFX TableView 高级用法：实现动态过滤与选中项获取

在 JavaFX 应用开发中，TableView 是一个常用的组件，用于展示结构化数据。当数据量较大时，用户往往需要通过搜索或过滤功能来快速定位所需信息。本教程将指导您如何实现一个带有动态过滤功能的 TableView，并在用户点击按钮时，获取当前过滤结果中的数据，并将其传递给另一个 FXML 视图。

1. 核心组件概览

为了实现动态过滤和数据获取，我们将使用以下 JavaFX 组件和集合类：

• TableView: 显示数据的表格。
• TableColumn: TableView 中的列定义。
• TextField: 用户输入过滤关键词的文本框。
• Button: 触发数据获取和视图切换的按钮。
• ObservableList: 存储原始数据，支持数据变更通知。
• FilteredList: 基于 ObservableList 创建，通过 Predicate 实现数据过滤。
• SortedList: 基于 FilteredList 创建，支持数据排序，并最终绑定到 TableView。

2. 构建数据模型

首先，我们需要一个简单的数据模型来表示表格中的每一行。以 Employee 为例：

// Employee.java
public class Employee {
    private final SimpleIntegerProperty id;
    private final SimpleStringProperty name;
    private final SimpleStringProperty salary;

    public Employee(int id, String name, String salary) {
        this.id = new SimpleIntegerProperty(id);
        this.name = new SimpleStringProperty(name);
        this.salary = new SimpleStringProperty(salary);
    }

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

    public SimpleIntegerProperty idProperty() {
        return id;
    }

    public void setId(int id) {
        this.id.set(id);
    }

    public String getName() {
        return name.get();
    }

    public SimpleStringProperty nameProperty() {
        return name;
    }

    public void setName(String name) {
        this.name.set(name);
    }

    public String getSalary() {
        return salary.get();
    }

    public SimpleStringProperty salaryProperty() {
        return salary;
    }

    public void setSalary(String salary) {
        this.salary.set(salary);
    }
}

3. FXML 布局配置

在 FXML 文件中，我们需要定义 TableView、TextField 和 Button。确保为它们设置 fx:id 和 onAction 属性，以便在控制器中引用和处理事件。

立即学习“Java免费学习笔记（深入）”；

Otter.ai

一个自动的会议记录和笔记工具，会议内容生成和实时转录

下载

4. 控制器逻辑实现

控制器是实现所有业务逻辑的地方。我们将在这里初始化 TableView、绑定数据、实现过滤逻辑以及处理按钮点击事件。

// YourController.java
package yourpackage;

import javafx.collections.FXCollections;
import javafx.collections.ObservableList;
import javafx.collections.transformation.FilteredList;
import javafx.collections.transformation.SortedList;
import javafx.event.ActionEvent;
import javafx.fxml.FXML;
import javafx.fxml.FXMLLoader;
import javafx.fxml.Initializable;
import javafx.scene.Parent;
import javafx.scene.Scene;
import javafx.scene.control.TableColumn;
import javafx.scene.control.TableView;
import javafx.scene.control.TextField;
import javafx.scene.control.cell.PropertyValueFactory;
import javafx.stage.Stage;

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

public class YourController implements Initializable {

    @FXML
    private TableView mTableView;
    @FXML
    private TableColumn idColumn;
    @FXML
    private TableColumn nameColumn;
    @FXML
    private TableColumn salColumn;
    @FXML
    private TextField mTextField;
    @FXML
    private Button searchBtn;

    private ObservableList mList = FXCollections.observableArrayList();
    private FilteredList filteredList;

    @Override
    public void initialize(URL url, ResourceBundle resourceBundle) {
        // 1. 初始化 TableColumn 的单元格值工厂
        idColumn.setCellValueFactory(new PropertyValueFactory<>("id"));
        nameColumn.setCellValueFactory(new PropertyValueFactory<>("name"));
        salColumn.setCellValueFactory(new PropertyValueFactory<>("salary"));

        // 2. 加载数据 (这里使用模拟数据，实际应用中可能从数据库加载)
        loadRecords();

        // 3. 创建 FilteredList 并绑定到原始数据
        filteredList = new FilteredList<>(mList, b -> true); // b->true 表示默认显示所有数据

        // 4. 为 TextField 添加监听器，实现动态过滤
        mTextField.textProperty().addListener((observable, oldValue, newValue) -> {
            filteredList.setPredicate(employee -> {
                // 如果搜索框为空或空白，则显示所有数据
                if (newValue == null || newValue.isEmpty() || newValue.isBlank()) {
                    return true;
                }

                String searchKeyword = newValue.toLowerCase();

                // 根据 ID 进行过滤 (这里只过滤ID，您可以扩展到其他字段)
                return String.valueOf(employee.getId()).toLowerCase().contains(searchKeyword);
            });
        });

        // 5. 将 FilteredList 包装成 SortedList
        SortedList sortedList = new SortedList<>(filteredList);

        // 6. 将 SortedList 的比较器属性绑定到 TableView 的比较器属性
        // 这样 TableView 的排序操作会影响 SortedList
        sortedList.comparatorProperty().bind(mTableView.comparatorProperty());

        // 7. 将 SortedList 设置为 TableView 的数据源
        mTableView.setItems(sortedList);
    }

    /**
     * 模拟加载数据到 ObservableList
     * 实际应用中会从数据库或其他数据源获取
     */
    private void loadRecords() {
        mList.add(new Employee(101, "Alice", "50000"));
        mList.add(new Employee(102, "Bob", "60000"));
        mList.add(new Employee(103, "Charlie", "75000"));
        mList.add(new Employee(201, "David", "55000"));
        mList.add(new Employee(202, "Eve", "62000"));
        mList.add(new Employee(301, "Frank", "80000"));
    }

    /**
     * 处理搜索按钮点击事件
     * 获取当前 TableView 中过滤后的数据，并传递给另一个 FXML 视图
     */
    @FXML
    public void handleSearch(ActionEvent event) {
        // 获取 TableView 当前显示的所有项 (这些项已经是经过过滤和排序的)
        ObservableList currentDisplayedItems = mTableView.getItems();

        if (!currentDisplayedItems.isEmpty()) {
            // 获取第一个匹配的员工对象
            Employee selectedEmployee = currentDisplayedItems.get(0);
            System.out.println("Selected Employee (first filtered): " + selectedEmployee.getName() + " (ID: " + selectedEmployee.getId() + ")");

            // 示例：加载另一个 FXML 视图并传递数据
            try {
                // 假设您有一个名为 "DetailView.fxml" 的新视图
                FXMLLoader loader = new FXMLLoader(getClass().getResource("/yourpackage/DetailView.fxml"));
                Parent root = loader.load();

                // 获取新视图的控制器
                DetailController detailController = loader.getController();
                // 调用新控制器的方法来传递数据
                detailController.setEmployeeDetails(selectedEmployee);

                // 创建并显示新场景
                Stage stage = new Stage();
                stage.setTitle("Employee Details");
                stage.setScene(new Scene(root));
                stage.show();

                // 可选：关闭当前窗口
                // ((Stage) searchBtn.getScene().getWindow()).close();

            } catch (IOException e) {
                e.printStackTrace();
                // 处理加载 FXML 失败的错误
            }
        } else {
            System.out.println("No employee found matching the filter criteria.");
            // 可以在此处显示一个警告框通知用户
        }
    }
}

5. 创建目标 FXML 视图及控制器

为了演示数据传递，我们需要一个接收数据的目标 FXML 视图和其对应的控制器。

// DetailController.java
package yourpackage;

import javafx.fxml.FXML;
import javafx.scene.control.Label;

public class DetailController {

    @FXML
    private Label idLabel;
    @FXML
    private Label nameLabel;
    @FXML
    private Label salaryLabel;

    /**
     * 设置员工详细信息到 UI 控件
     * @param employee 接收到的员工对象
     */
    public void setEmployeeDetails(Employee employee) {
        if (employee != null) {
            idLabel.setText("ID: " + employee.getId());
            nameLabel.setText("Name: " + employee.getName());
            salaryLabel.setText("Salary: " + employee.getSalary());
        }
    }
}

6. 注意事项与最佳实践