JavaFX TableView数据过滤与结果获取教程

本教程详细介绍了如何在javafx应用程序中实现`tableview`的动态数据过滤功能，并能在用户点击按钮时准确获取到当前`tableview`中显示（即已过滤）的数据。内容涵盖了`filteredlist`和`sortedlist`的集成使用、`textfield`与过滤谓词的绑定，以及如何在事件处理方法中安全有效地提取过滤结果，为后续的数据处理或视图切换提供基础。

在JavaFX应用开发中，TableView是展示列表数据的常用组件。当数据量较大时，用户往往需要通过输入关键词进行过滤，以便快速定位所需信息。本教程将指导您如何结合TextField和Button，实现TableView的动态过滤，并在点击按钮时获取到过滤后的数据，以便进行进一步的处理，例如将数据传递给另一个FXML视图。

1. JavaFX TableView数据过滤机制概览

JavaFX提供了一套强大的机制来处理TableView的数据过滤和排序，主要通过以下几个核心类协同工作：

ObservableList: 这是TableView的基础数据源，存储着所有原始数据。当列表内容发生变化时，它会通知所有监听器。FilteredList: 这是一个包装ObservableList的列表。它不直接存储数据，而是根据一个Predicate（谓词）来决定其底层ObservableList中的哪些元素应该被“显示”出来。当谓词改变或底层数据改变时，FilteredList会自动更新其视图。SortedList: 这是一个包装FilteredList（或任何ObservableList）的列表。它根据一个Comparator（比较器）来对数据进行排序。通常，TableView的排序功能会自动与SortedList绑定。TableView: 最终的显示组件，其setItems()方法可以接受ObservableList、FilteredList或SortedList。为了同时支持过滤和排序，通常会将TableView绑定到SortedList，而SortedList又包装着FilteredList。

这种链式结构允许我们先过滤数据，再对过滤后的数据进行排序，并将最终结果展示在TableView中。

2. 构建基础界面与数据模型

首先，我们需要一个简单的数据模型和FXML界面。

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

2.1 数据模型：Employee 类

创建一个代表员工信息的POJO类，包含ID、姓名和薪水。

public class Employee {    private final SimpleIntegerProperty id;    private final SimpleStringProperty name;    private final SimpleStringProperty salary; // 使用StringProperty方便演示，实际可为DoubleProperty    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); }    @Override    public String toString() {        return "Employee{" +               "id=" + id.get() +               ", name='" + name.get() + ''' +               ", salary='" + salary.get() + ''' +               '}';    }}

2.2 FXML 布局

在您的FXML文件中，添加一个TableView、一个TextField和一个Button。

Typewise.app

面向客户服务和销售团队的AI写作解决方案。

39 查看详情

2.3 控制器骨架

在控制器中声明FXML组件：

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.scene.control.Button;import javafx.scene.control.TableColumn;import javafx.scene.control.TableView;import javafx.scene.control.TextField;import javafx.beans.property.SimpleIntegerProperty;import javafx.beans.property.SimpleStringProperty;import javafx.fxml.Initializable;import java.net.URL;import java.util.ResourceBundle;import java.util.List;import java.util.stream.Collectors;public class EmployeeController 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 masterData = FXCollections.observableArrayList();    private FilteredList filteredData;    private SortedList sortedData;    @Override    public void initialize(URL url, ResourceBundle resourceBundle) {        // 初始化列        idColumn.setCellValueFactory(cellData -> cellData.getValue().idProperty().asObject());        nameColumn.setCellValueFactory(cellData -> cellData.getValue().nameProperty());        salColumn.setCellValueFactory(cellData -> cellData.getValue().salaryProperty());        // 加载并设置数据        loadRecords();        // 绑定TextField到FilteredList        setupFiltering();    }    // ... handleSearch 方法将在后面实现    @FXML    public void handleSearch(ActionEvent event) {        // 实现搜索按钮点击逻辑    }}

3. 实现动态数据过滤

3.1 数据加载与 TableView 初始化

在initialize方法中，或者由initialize调用的方法中，加载数据并设置TableView。

// EmployeeController.java// ... (其他代码)    private void loadRecords() {        // 模拟从数据库加载数据        masterData.add(new Employee(101, "Alice", "5000"));        masterData.add(new Employee(102, "Bob", "6000"));        masterData.add(new Employee(103, "Charlie", "5500"));        masterData.add(new Employee(201, "David", "7000"));        masterData.add(new Employee(202, "Eve", "6200"));        masterData.add(new Employee(301, "Frank", "8000"));        masterData.add(new Employee(104, "Grace", "5100"));        // 1. 用原始数据初始化 FilteredList        filteredData = new FilteredList(masterData, p -> true); // p -> true 表示初始显示所有数据        // 2. 用 FilteredList 初始化 SortedList        sortedData = new SortedList(filteredData);        // 3. 将 SortedList 的比较器属性绑定到 TableView 的比较器属性        //    这样 TableView 的列点击排序功能将作用于 sortedData        sortedData.comparatorProperty().bind(mTableView.comparatorProperty());        // 4. 将 SortedList 设置为 TableView 的数据源        mTableView.setItems(sortedData);    }// ... (其他代码)

3.2 将 TextField 输入绑定到 FilteredList 的 Predicate

这是实现动态过滤的核心。我们将监听mTextField的textProperty，当文本发生变化时，更新FilteredList的谓词。

// EmployeeController.java// ... (其他代码)    private void setupFiltering() {        mTextField.textProperty().addListener((observable, oldValue, newValue) -> {            filteredData.setPredicate(employee -> {                // 如果搜索框为空或空白，则显示所有员工                if (newValue == null || newValue.isEmpty() || newValue.isBlank()) {                    return true;                }                String searchKeyword = newValue.toLowerCase();                // 根据ID进行过滤，您可以扩展到姓名、薪水等                // 这里我们只演示ID的过滤                if (String.valueOf(employee.getId()).toLowerCase().contains(searchKeyword)) {                    return true; // 匹配ID                }                // 您可以添加更多过滤条件，例如：                // if (employee.getName().toLowerCase().contains(searchKeyword)) {                //     return true; // 匹配姓名                // }                // if (employee.getSalary().toLowerCase().contains(searchKeyword)) {                //     return true; // 匹配薪水                // }                return false; // 不匹配任何条件            });        });    }// ... (其他代码)

现在，当您在mTextField中输入内容时，TableView会实时更新，只显示匹配的数据。

4. 在按钮点击时获取过滤结果

当用户点击“搜索”按钮时，我们需要获取当前TableView中显示的数据。由于TableView已经绑定到SortedList（而SortedList又包装了FilteredList），mTableView.getItems()方法将直接返回经过过滤和排序后的数据。

// EmployeeController.java// ... (其他代码)    @FXML    public void handleSearch(ActionEvent event) {        // 获取当前 TableView 中显示的所有项目（即过滤后的数据）        ObservableList displayedEmployees = mTableView.getItems();        if (displayedEmployees != null && !displayedEmployees.isEmpty()) {            // 示例：获取第一个过滤结果            Employee firstFilteredResult = displayedEmployees.get(0);            System.out.println("搜索按钮点击：第一个过滤结果是: " + firstFilteredResult);            // 如果您希望获取所有过滤结果，可以遍历 displayedEmployees            System.out.println("所有过滤结果:");            for (Employee emp : displayedEmployees) {                System.out.println("- " + emp);            }            // 在这里，您可以将 firstFilteredResult 或整个 displayedEmployees 列表            // 传递给另一个 FXML 视图的控制器，例如：            // FXMLLoader loader = new FXMLLoader(getClass().getResource("AnotherView.fxml"));            // Parent root = loader.load();            // AnotherViewController controller = loader.getController();            // controller.initData(firstFilteredResult); // 假设 AnotherViewController 有一个 initData 方法            // Stage stage = new Stage();            // stage.setScene(new Scene(root));            // stage.show();        } else {            System.out.println("搜索按钮点击：没有找到匹配的员工。");        }    }// ... (其他代码)

5. 完整控制器示例代码

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.Initializable;import javafx.scene.control.Button;import javafx.scene.control.TableColumn;import javafx.scene.control.TableView;import javafx.scene.control.TextField;import javafx.beans.property.SimpleIntegerProperty;import javafx.beans.property.SimpleStringProperty;import java.net.URL;import java.util.ResourceBundle;public class EmployeeController 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 masterData = FXCollections.observableArrayList();    private FilteredList filteredData;    private SortedList sortedData;    @Override    public void initialize(URL url, ResourceBundle resourceBundle) {        // 1. 初始化 TableColumn 的 CellValueFactory        idColumn.setCellValueFactory(cellData -> cellData.getValue().idProperty().asObject());        nameColumn.setCellValueFactory(cellData -> cellData.getValue().nameProperty());        salColumn.setCellValueFactory(cellData -> cellData.getValue().salaryProperty());        // 2. 加载原始数据并设置 TableView 的数据源        loadRecords();        // 3. 设置 TextField 的监听器以实现动态过滤        setupFiltering();    }    /**     * 加载模拟数据并配置 TableView 的 FilteredList 和 SortedList。     */    private void loadRecords() {        // 模拟从数据库加载数据        masterData.add(new Employee(101, "Alice", "5000"));        masterData.add(new Employee(102, "Bob", "6000"));        masterData.add(new Employee(103, "Charlie", "5500"));        masterData.add(new Employee(201, "David", "7000"));        masterData.add(new Employee(202, "Eve", "6200"));        masterData.add(new Employee(301, "Frank", "8000"));        masterData.add(new Employee(104, "Grace", "5100"));        // 用原始数据初始化 FilteredList，初始谓词为 true（显示所有数据）        filteredData = new FilteredList(masterData, p -> true);        // 用 FilteredList 初始化 SortedList        sortedData = new SortedList(filteredData);        // 将 SortedList 的比较器属性绑定到 TableView 的比较器属性，        // 这样 TableView 的列点击排序功能将作用于 sortedData。        sortedData.comparatorProperty().bind(mTableView.comparatorProperty());        // 将 SortedList 设置为 TableView 的数据源        mTableView.setItems(sortedData);    }    /**     * 设置 TextField 的文本属性监听器，以根据输入内容动态过滤 TableView。     */    private void setupFiltering() {        mTextField.textProperty().addListener((observable, oldValue, newValue) -> {            filteredData.setPredicate(employee -> {                // 如果搜索框为空或空白，则显示所有员工                if (newValue == null || newValue.isEmpty() || newValue.isBlank()) {                    return true;                }                String searchKeyword = newValue.toLowerCase();                // 过滤逻辑：匹配员工ID（转换为字符串并小写）                if (String.valueOf(employee.getId()).toLowerCase().contains(searchKeyword)) {                    return true; // 匹配ID                }                // 您可以根据需要添加更多过滤条件，例如姓名、薪水等                // if (employee.getName().toLowerCase().contains(searchKeyword)) {                //     return true;                // }                // if (employee.getSalary().toLowerCase().contains(searchKeyword)) {                //     return true;                // }                return false; // 不匹配任何条件            });        });    }    /**     * 处理搜索按钮点击事件。     * 获取当前 TableView 中显示（已过滤和排序）的数据。     *     * @param event 触发事件。     */    @FXML    public void handleSearch(ActionEvent event) {        // 获取当前 TableView 中显示的所有项目（即过滤后的数据）        ObservableList displayedEmployees = mTableView.getItems();        if (displayedEmployees != null && !displayedEmployees.isEmpty()) {            // 示例：获取第一个过滤结果            Employee firstFilteredResult = displayedEmployees.get(0);            System.out.println("搜索按钮点击：第一个过滤结果是: " + firstFilteredResult);            // 如果需要所有过滤结果，可以遍历 displayedEmployees 列表            System.out.println("n所有过滤结果:");            for (Employee emp : displayedEmployees) {                System.out.println("- " + emp);            }            // 此处是您将过滤结果传递给另一个 FXML 视图的逻辑点。            // 例如，加载一个新的 FXML 文件，并调用其控制器的方法来传递数据。            // 示例伪代码：            /*            try {                FXMLLoader loader = new FXMLLoader(getClass().getResource("/com/example/demo/AnotherView.fxml"));                Parent root = loader.load();                AnotherViewController anotherController = loader.getController();                anotherController.setEmployeeData(firstFilteredResult); // 假设 AnotherViewController 有一个 setEmployeeData 方法                Stage stage = new Stage();                stage.setTitle("员工详情");                stage.setScene(new Scene(root));                stage.show();            } catch (IOException e) {

以上就是JavaFX TableView数据过滤与结果获取教程的详细内容，更多请关注创想鸟其它相关文章！