本教程详细介绍了如何在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。
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) { 
