当前位置：首页 > 文章列表 > 文章 > java教程 > JavaFXTableView过滤与数据获取方法

JavaFXTableView过滤与数据获取方法

2025-11-26 23:15:42 0浏览收藏

你在学习文章相关的知识吗？本文《JavaFX TableView过滤与数据获取教程》，主要介绍的内容就涉及到，如果你想提升自己的开发能力，就不要错过这篇文章，大家要知道编程理论基础和实战操作都是不可或缺的哦！

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界面。

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。

<?xml version="1.0" encoding="UTF-8"?>

<?import javafx.scene.control.Button?>
<?import javafx.scene.control.TableColumn?>
<?import javafx.scene.control.TableView?>
<?import javafx.scene.control.TextField?>
<?import javafx.scene.layout.AnchorPane?>
<?import javafx.scene.layout.HBox?>

<AnchorPane prefHeight="600.0" prefWidth="900.0" xmlns="http://javafx.com/javafx/21" xmlns:fx="http://javafx.com/fxml/1" fx:controller="com.example.demo.EmployeeController">
   <HBox alignment="CENTER_LEFT" layoutX="14.0" layoutY="14.0" spacing="10.0">
      <TextField fx:id="mTextField" prefHeight="28.0" prefWidth="300.0" promptText="输入ID进行搜索" />
      <Button fx:id="searchBtn" mnemonicParsing="false" onAction="#handleSearch" prefHeight="26.0" prefWidth="100.0" text="搜索" />
   </HBox>
   <TableView fx:id="mTableView" layoutX="14.0" layoutY="50.0" prefHeight="530.0" prefWidth="870.0">
     <columns>
       <TableColumn fx:id="idColumn" prefWidth="75.0" text="ID" />
       <TableColumn fx:id="nameColumn" prefWidth="200.0" text="姓名" />
       <TableColumn fx:id="salColumn" prefWidth="150.0" text="薪水" />
     </columns>
   </TableView>
</AnchorPane>

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<Employee> mTableView;
    @FXML
    private TableColumn<Employee, Integer> idColumn;
    @FXML
    private TableColumn<Employee, String> nameColumn;
    @FXML
    private TableColumn<Employee, String> salColumn;
    @FXML
    private TextField mTextField;
    @FXML
    private Button searchBtn;

    private ObservableList<Employee> masterData = FXCollections.observableArrayList();
    private FilteredList<Employee> filteredData;
    private SortedList<Employee> 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<Employee> 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<Employee> mTableView;
    @FXML
    private TableColumn<Employee, Integer> idColumn;
    @FXML
    private TableColumn<Employee, String> nameColumn;
    @FXML
    private TableColumn<Employee, String> salColumn;
    @FXML
    private TextField mTextField;
    @FXML
    private Button searchBtn;

    private ObservableList<Employee> masterData = FXCollections.observableArrayList();
    private FilteredList<Employee> filteredData;
    private SortedList<Employee> 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<Employee> 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) {

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~