如何使用Java记录从数据库中获取数据并填充JavaFX表格

Question

简要问题： 使用记录（record）从数据库获取数据并填充 JavaFX 表格视图的最佳方法是什么？（相比于使用具有 getter 和 setter 的常规对象类）

完整问题：

最近我创建了 InventoryRecord.java 文件，用于替换之前用来填充表格视图的传统对象类 Inventory：

import java.util.List;

public record InventoryRecord(
        String make,
        String model,
        String officialModel,
        String upc,
        List category,
        String type,
        String description,
        String vendor,
        Double cost,
        Double price
) {}

我想使用这个记录作为框架，从数据库（这里是 Neo4j，但数据库类型不重要）中获取数据来填充表格视图。

在拥有 InventoryRecord 之前，我使用的 Inventory 类大致如下（为了便于阅读，已缩短代码，假设每个属性都有对应的 getter 和 setter）：

public class Inventory {
    private String make;
    private String model;
    // 其他属性...
    private List category;
    private Double cost;
    private Double price;

    public Inventory(String make, String model, /*其他参数...*/, List category, Double cost, Double price) {
        // 调用 setter 方法初始化属性
    }
    // getter 和 setter 方法
}

以下是使用查询结果填充表格的方式：

while (result.hasNext()) {
    Record record = result.next();
    
    // 获取各个字段值
    String make = record.get("make").asString();
    // 其他字段...
    List category = record.get("categories").asList(Value::asString);
    Double cost = record.get("cost").isNull() ? null : record.get("cost").asDouble();
    Double price = record.get("price").isNull() ? null : record.get("price").asDouble();
    
    // 创建匿名 Inventory 对象并添加到表格项中
    inventoryTable.getItems().add(new Inventory(make, model, /*其他参数...*/, category, cost, price));
}

// 设置列的 CellValueFactory
makeColumn.setCellValueFactory(new PropertyValueFactory<>("make"));
// 其他列的设置...
categoryColumn.setCellValueFactory(new PropertyValueFactory<>("category"));
costColumn.setCellValueFactory(new PropertyValueFactory<>("cost"));
priceColumn.setCellValueFactory(new PropertyValueFactory<>("price"));

inventoryTable.setItems(inventoryTable.getItems());

现在我想将所有内容改为使用 InventoryRecord，而不是仅使用 Inventory 对象，但 setCellValueFactory 和 PropertyValueFactory 对于记录的表现并不友好。尝试以下代码片段：

makeColumn.setCellValueFactory(cellData -> new SimpleStringProperty(cellData.getValue().make()));
// 字符串属性的设置没有错误...

categoryColumn.setCellValueFactory(cellData -> new SimpleListProperty>(cellData.getValue().category()));
costColumn.setCellValueFactory(cellData -> new SimpleDoubleProperty(cellData.getValue().cost()));

但出现以下错误：

Type mismatch: cannot convert from SimpleListProperty> to ObservableValue>
Type mismatch: cannot convert from SimpleDoubleProperty to ObservableValue

尝试将查询结果直接转换为 InventoryRecord 并添加到表格项中：

while (result.hasNext()) {
    // 获取记录值
    // ...

    // 创建 InventoryRecord 实例
    InventoryRecord inventoryRecord = new InventoryRecord(make, model, /*其他参数...*/, category, type, desc, vendor, cost, price);

    // 添加 InventoryRecord 到表格项中
    inventoryTable.getItems().add(inventoryRecord);
}

// 设置列的 CellValueFactory
makeColumn.setCellValueFactory(cellData -> new SimpleStringProperty(cellData.getValue().make()));
// 其他列的设置...
categoryColumn.setCellValueFactory(cellData -> new SimpleListProperty<>(cellData.getValue().category()));
upcColumn.setCellValueFactory(cellData -> new SimpleStringProperty(cellData.getValue().upc()));
// ...
costColumn.setCellValueFactory(cellData -> new SimpleDoubleProperty(cellData.getValue().cost()).asObject());
priceColumn.setCellValueFactory(cellData -> new SimpleDoubleProperty(cellData.getValue().price()).asObject());

inventoryTable.setItems(inventoryTable.getItems());

但依然出现类似错误：

Type mismatch: cannot convert from SimpleListProperty> to ObservableValue>
Type mismatch: cannot convert from SimpleDoubleProperty to ObservableValue

期待的结果类似于之前使用 Inventory 类时的效果。

Nicol Bolas · Answer

PropertyValueFactory 类不适用于记录，至少在 JavaFX 21 中尚不支持（我建议您无论如何都避免使用该类【参见：Stack Overflow 链接】）。您遇到的错误并非直接由于将类更改为记录类型导致。它们是由您在几个单元格值工厂中返回了错误的数据类型引起的。

SimpleListProperty 已经是一个 E 类型的列表。如果您将其参数化为 List，则表示您拥有一个 字符串列表的列表。根据您遇到的错误，这并不是该列的值类型。请改为从相应的单元格值工厂返回 SimpleObjectProperty>。

另外，SimpleDoubleProperty 是一个 ObservableValue。但从错误信息来看，您实际上需要的是一个 ObservableValue。请将相应的单元格值工厂更改为返回 SimpleObjectProperty。另一种选择是将列的值类型从 Double 更改为 Number。但我建议采用前一种方法。

为了简化这个问题，您可以在类中创建一个工具方法。例如：

private  void setCellValueFactory(
    TableColumn column, 
    Callback callback) {
  column.setCellValueFactory(
      data -> {
        T value = callback.call(data.getValue());
        return new SimpleObjectProperty<>(value);
      });
}

这样就可以像下面这样定义所有的单元格值工厂：

setCellValueFactory(makeColumn, InventoryRecord::make);
setCellValueFactory(modelColumn, InventoryRecord::model);
setCellValueFactory(officialModelColumn, InventoryRecord::officialModel);
setCellValueFactory(categoryColumn, InventoryRecord::category);
setCellValueFactory(upcColumn, InventoryRecord::upc);
setCellValueFactory(typeColumn, InventoryRecord::type);
setCellValueFactory(descriptionColumn, InventoryRecord::description);
setCellValueFactory(vendorColumn, InventoryRecord::vendor);
setCellValueFactory(costColumn, InventoryRecord::cost);
setCellValueFactory(priceColumn, InventoryRecord::price);

KV Prajapati · Answer

感谢 @Slaw 提供优雅的解决方案和详尽的解释。我在研究过程中发现我对 JavaFX Beans 不太了解，因此找到了一个略有不同的解决方案。主要解决办法是在实际的 Inventory 构造器中设置使用 Beans “property” 方法的真实 JavaFX getter 和 setter。

这是我的构造器最终针对不同数据类型的简化版本：

public class Inventory {
    private StringProperty officialModel;
    private ListProperty category;
    private DoubleProperty cost;

    public final String getOfficialModel() {
        return this.officialModelProperty().get();
    }

    public final void setOfficialModel(final String officialModel) {
        this.officialModelProperty().set(officialModel);
    }

    public final ListProperty categoryProperty() {
        if (category == null) {
            category = new SimpleListProperty<>(this, "category");
        }
        return category;
    }

    public final ObservableList getCategory() {
        return this.categoryProperty().get();
    }

    public final void setCategory(final ObservableList category) {
        this.categoryProperty().set(category);
    }

    public final DoubleProperty costProperty() {
        if (cost == null) {
            cost = new SimpleDoubleProperty(this, "cost");
        }
        return cost;
    }

    public final double getCost() {
        return this.costProperty().get();
    }

    public final void setCost(final double cost) {
        this.costProperty().set(cost);
    }
}

而我的 CellValueFactory 设置如下所示：

makeColumn.setCellValueFactory(cellData -> cellData.getValue().makeProperty());
modelColumn.setCellValueFactory(cellData -> cellData.getValue().modelProperty());
officialModelColumn.setCellValueFactory(cellData -> cellData.getValue().officialModelProperty());
// categoryColumn 必须设为只读，防止用户修改，从而保护列表数据
categoryColumn.setCellValueFactory(cellData -> new ReadOnlyObjectWrapper<>(cellData.getValue().categoryProperty().get()));
upcColumn.setCellValueFactory(cellData -> cellData.getValue().upcProperty());
typeColumn.setCellValueFactory(cellData -> cellData.getValue().typeProperty());
descriptionColumn.setCellValueFactory(cellData -> cellData.getValue().descriptionProperty());
vendorColumn.setCellValueFactory(cellData -> cellData.getValue().vendorProperty());
costColumn.setCellValueFactory(cellData -> cellData.getValue().costProperty().asObject());  // 将 double 包装为 ObservableValue 的 Object
priceColumn.setCellValueFactory(cellData -> cellData.getValue().priceProperty().asObject()); // 将 double 包装为 ObservableValue 的 Object

不过，请告知此解决方案是否存在重大缺陷。如果有问题的话，我会考虑切换到您的方法！