如何将 JavaFX TableView 与 java 记录一起使用？

Question

记录是Java 16的一项新功能。在JEP 395：记录中定义。

假设您有这样的记录。

public record Person(String last, String first, int age)
{
    public Person()
    {
        this("", "", 0);
    }
}

这是最后一堂课。它自动生成 getter 方法first()、last() 和age()。

现在这是 JavaFX 中的 TableView。

/**************************************************
*   Author: Morrison
*   Date:  10 Nov 202021
**************************************************/

import javafx.application.Application;
import javafx.application.Platform;
import javafx.stage.Stage;
import javafx.scene.Scene;
import javafx.scene.layout.BorderPane;
import javafx.scene.control.TableView;
import javafx.scene.control.TableColumn;
import javafx.scene.control.cell.PropertyValueFactory;

public class TV extends Application
{
    public TV()
    {
    }

    @Override
    public void init()
    {
    }

    @Override
    public void start(Stage primary)
    {
        BorderPane root = new BorderPane();
        TableView<Person> table = new TableView<>();
        root.setCenter(table);

        TableColumn<Person, String> lastColumn = new TableColumn<>("Last");
        lastColumn.setCellValueFactory(new PropertyValueFactory<Person,
            String>("last"));

        TableColumn<Person, String> firstColumn = new TableColumn<>("First");
        firstColumn.setCellValueFactory(new PropertyValueFactory<Person,
            String>("first"));

        TableColumn<Person, Integer> ageColumn = new TableColumn<>("Age");
        ageColumn.setCellValueFactory(new PropertyValueFactory<Person,
            Integer>("age"));

        table.getColumns().add(lastColumn);
        table.getColumns().add(firstColumn);
        table.getColumns().add(ageColumn);
        table.getItems().add(new Person("Smith", "Justin", 41));
        table.getItems().add(new Person("Smith", "Sheila", 42));
        table.getItems().add(new Person("Morrison", "Paul", 58));
        table.getItems().add(new Person("Tyx", "Kylee", 40));
        table.getItems().add(new Person("Lincoln", "Abraham", 200));
        Scene s = new Scene(root, 500, 500);
        primary.setTitle("TableView Demo");
        primary.setScene(s);
        primary.show();
    }

    @Override
    public void stop()
    {
    }
}

问题就出在这里。

TableColumn<Person, String> lastColumn = new TableColumn<>("Last");
        lastColumn.setCellValueFactory(new PropertyValueFactory<Person,
            String>("last"));
        

TableView 需要 name getFirst、getLast、 和方法getAge来完成其工作。除了做这种可怕的事情之外，还有其他解决方法吗？

public record Person(String last, String first, int age)
{
    public Person()
    {
        this("", "", 0);
    }
    public String getLast()
    {
        return last;
    }
    public String getFirst()
    {
        return first;
    }
    public int getAge()
    {
        return age;
    }
}

Answer 1

解决方案

使用 lambda 单元值工厂而不是PropertyValueFactory.

有关两者之间差异的一些解释，请参见：

• Java: setCellValuefactory; Lambda 与 PropertyValueFactory；优点缺点

为什么这有效

正如您所注意到的，问题在于记录访问器不遵循标准JavaBean属性命名约定，而这正是我们所PropertyValueFactory期望的。例如，记录使用first()而不是getFirst()作为访问器，这使得它与PropertyValueFactory.

您是否应该应用“做这件可怕的事情”的解决方法，向记录中添加额外的 get 方法，这样您就可以使用 aPropertyValueFactory与 a 进行交互TableView？->绝对不是，有更好的方法:-)

修复它需要定义您自己的自定义单元工厂，而不是使用PropertyValueFactory.

最好使用 lambda（或用于非常复杂的单元值工厂的自定义类）来完成此操作。PropertyValueFactory使用 lambda 单元工厂具有 a所没有的类型安全和编译时检查的优点（有关更多信息，请参阅前面引用的答案）。

定义 lambda 而不是 PropertyValueFactories 的示例

SimpleStringProperty

记录字段的 lambda 单元工厂定义的示例用法String：

TableColumn<Person, String> lastColumn = new TableColumn<>("Last");
lastColumn.setCellValueFactory(
        p -> new SimpleStringProperty(p.getValue().last())
);

为了清楚起见，我们可以明确该p变量的类型：对对象的引用TableColumn.CellDataFeatures。

TableColumn<Person, String> lastColumn = new TableColumn<>("Last");
lastColumn.setCellValueFactory(
        p -> new SimpleStringProperty(p.getValue().last())
);

有必要将记录字段包装在属性或绑定中，因为单元值工厂实现需要可观察值作为输入。

ReadOnlyStringWrapper

您也许可以使用 aReadOnlyStringWrapper代替SimpleStringProperty，如下所示：

lastColumn.setCellValueFactory(
        p -> new ReadOnlyStringWrapper(p.getValue().last()).getReadOnlyProperty()
);

在一个有效的快速测试中。对于不可变记录，这可能是一个更好的方法，但我还没有彻底测试它以确保安全，因此，为了安全起见，我在本示例的其余部分中使用了简单的读写属性。

对于其他类型的数据

同样，对于一个int字段：

TableColumn<Person, Integer> ageColumn = new TableColumn<>("Age");
ageColumn.setCellValueFactory(
        p -> new SimpleIntegerProperty(p.getValue().age()).asObject()
);

如果您好奇的话，这里解释了放在 lambda 末尾的必要性asObject()（但这只是 JavaFX 框架使用 java 泛型的一个奇怪的方面，不值得花费大量时间研究，只需添加asObject()呼叫并继续 IMO）：

• 为什么 asObject 允许将 SimpleLongProperty 与 setCellValueProperty 一起使用？

同样，如果您的记录包含其他对象（或其他记录），那么您可以为 定义一个单元格值工厂SimpleObjectProperty<MyType>。

注意：这种 lambda 单元工厂定义方法和上面定义的模式也适用于标准（非记录）类。这里没有什么特别需要记录的地方。getValue()唯一需要注意的是在lambda 调用后注意使用正确的访问器名称。例如，使用first()而不是标准getFirst()而不是通常在类上定义的这样做的真正好处是，如果您错误地定义了访问器名称，您将收到编译器错误，并且在尝试运行代码之前就知道确切的问题和位置。

示例代码

基于问题中的代码的完整可执行示例。

人.java

public record Person(String last, String first, int age) {}

RecordTableViewer.java

import javafx.application.Application;
import javafx.beans.property.*;
import javafx.scene.Scene;
import javafx.scene.control.*;
import javafx.stage.Stage;

public class RecordTableViewer extends Application {
    @Override
    public void start(Stage stage) {
        TableView<Person> table = new TableView<>();

        TableColumn<Person, String> lastColumn = new TableColumn<>("Last");
        lastColumn.setCellValueFactory(
                p -> new SimpleStringProperty(p.getValue().last())
        );

        TableColumn<Person, String> firstColumn = new TableColumn<>("First");
        firstColumn.setCellValueFactory(
                p -> new SimpleStringProperty(p.getValue().first())
        );

        TableColumn<Person, Integer> ageColumn = new TableColumn<>("Age");
        ageColumn.setCellValueFactory(
                p -> new SimpleIntegerProperty(p.getValue().age()).asObject()
        );

        //noinspection unchecked
        table.getColumns().addAll(lastColumn, firstColumn, ageColumn);

        table.getItems().addAll(
                new Person("Smith", "Justin", 41),
                new Person("Smith", "Sheila", 42),
                new Person("Morrison", "Paul", 58),
                new Person("Tyx", "Kylee", 40),
                new Person("Lincoln", "Abraham", 200)
        );

        stage.setScene(new Scene(table, 200, 200));
        stage.show();
    }
}

应该PropertyValueFactory“修复”记录吗？

记录字段访问器遵循自己的访问命名约定，fieldname()就像 Java Bean 一样，getFieldname()。

可能会提出增强请求PropertyValueFactory更改其在核心框架中的实现，以便它也可以识别记录访问器命名标准。

不过我不相信更新PropertyValueFactory以识别记录字段访问器是一个好主意。

更好的解决办法是不更新PropertyValueFactory记录支持，而只允许本答案中概述的类型安全自定义单元格值方法。

我相信这一点是因为 kleopatra 在评论中提供的解释：

自定义 valueFactory 绝对是可行的方法:) 即使对某些人来说实现与 PropertyValueFactory 等效的方案可能很有吸引力 - 但是：这将是一个坏主意，看看“数据未显示在表中”类型的问题的绝对数量“由于打字错误..