SimpleStringPropertyおよびSimpleIntegerPropertyTableView JavaFX

Question

だから私はJavaFxTableviewの使い方を学ぼうとしていますが、このチュートリアルで困惑しました。

Oracleテーブルビューチュートリアル

このチュートリアルでは、tableViewを埋めるには文字列を埋める必要があることを示していますが、文字列だけでなく、StringをSimpleStringPropertyにフォーマットする必要があります。

フォーマットなしで試してみたところ、どの情報も表示されませんでした。

また、テーブルにIntegerを追加する場合は、それをSimpleIntegerPropertyとして宣言する必要があることもわかりました。

今、私はJavaFxにかなり慣れていませんが、これは、オブジェクトを作成するときに、TableViewを満たすことができるように、すべての整数と文字列をフォーマットする必要があることを意味しますか？それはかなり愚かなようですが、おそらくより高い目的がありますか？またはそれを回避する方法はありますか？

Answer 1

特定の状況でプロパティを使用することが望ましい場合でも、テーブルデータオブジェクトを表示するためにプロパティを使用する必要はありません。

次のコードは、Stringフィールドのみを持つPersonクラスに基づく人々のテーブルを表示します。

import javafx.application.Application;
import javafx.collections.*;
import javafx.geometry.Insets;
import javafx.scene.*;
import javafx.scene.control.*;
import javafx.scene.control.cell.PropertyValueFactory;
import javafx.scene.layout.VBox;
import javafx.scene.text.Font;
import javafx.stage.Stage;

public class ReadOnlyTableView extends Application {
  private TableView<Person> table = new TableView<Person>();
  private final ObservableList<Person> data =
    FXCollections.observableArrayList(
      new Person("Jacob", "Smith", "[email protected]"),
      new Person("Isabella", "Johnson", "[email protected]"),
      new Person("Ethan", "Williams", "[email protected]"),
      new Person("Emma", "Jones", "[email protected]"),
      new Person("Michael", "Brown", "[email protected]")
    );

  public static void main(String[] args) { launch(args); }

  @Override public void start(Stage stage) {
    stage.setTitle("Table View Sample");
    stage.setWidth(450);
    stage.setHeight(500);

    final Label label = new Label("Address Book");
    label.setFont(new Font("Arial", 20));

    TableColumn firstNameCol = new TableColumn("First Name");
    firstNameCol.setMinWidth(100);
    firstNameCol.setCellValueFactory(new PropertyValueFactory<Person, String>("firstName"));

    TableColumn lastNameCol = new TableColumn("Last Name");
    lastNameCol.setMinWidth(100);
    lastNameCol.setCellValueFactory(new PropertyValueFactory<Person, String>("lastName"));

    TableColumn emailCol = new TableColumn("Email");
    emailCol.setMinWidth(200);
    emailCol.setCellValueFactory(new PropertyValueFactory<Person, String>("email"));

    table.setItems(data);
    table.getColumns().addAll(firstNameCol, lastNameCol, emailCol);

    final VBox vbox = new VBox();
    vbox.setSpacing(5);
    vbox.setPadding(new Insets(10, 0, 0, 10));
    vbox.getChildren().addAll(label, table);

    stage.setScene(new Scene(new Group(vbox)));
    stage.show();
  }

  public static class Person {
    private String firstName;
    private String lastName;
    private String email;

    private Person(String fName, String lName, String email) {
      this.firstName = fName;
      this.lastName = lName;
      this.email = email;
    }

    public String getFirstName() { return firstName; }
    public void setFirstName(String fName) { firstName = fName; }
    public String getLastName() { return lastName; }
    public void setLastName(String lName) { lastName = lName; }
    public String getEmail() { return email; }
    public void setEmail(String inMail) { email = inMail; }
  }
}

説明

PropertiesとObservableListsを使用する目的は、これらがリッスン可能な要素であるということです。プロパティが使用されている場合、データモデルのプロパティ属性の値が変更されると、TableViewのアイテムのビューは、更新されたデータモデルの値と一致するように自動的に更新されます。たとえば、個人の電子メールプロパティの値が新しい値に設定されている場合、プロパティの変更をリッスンするため、その更新はTableViewに反映されます。代わりに、プレーンな文字列が電子メールを表すために使用されていた場合、TableViewは電子メールの値の変更を認識しないため、更新されません。

PropertyValueFactory ドキュメントでは、このプロセスについて詳しく説明しています。

このクラスの使用方法の例は次のとおりです。

TableColumn<Person,String> firstNameCol = new TableColumn<Person,String>("First Name");
firstNameCol.setCellValueFactory(new PropertyValueFactory<Person,String>("firstName"));  

この例では、「firstName」文字列は、Personクラスタイプ（TableViewアイテムリストのクラスタイプ）で想定されるfirstNameProperty（）メソッドへの参照として使用されます。さらに、このメソッドはPropertyインスタンスを返す必要があります。これらの要件を満たすメソッドが見つかった場合、TableCellにはこのObservableValueが入力されます。さらに、TableViewは自動的にオブザーバーを戻り値に追加するため、発生した変更はTableViewによって監視され、セルはすぐに更新されます。

このパターンに一致するメソッドが存在しない場合、get（）またはis（）（つまり、上記の例ではgetFirstName（）またはisFirstName（））を呼び出そうとするためのフォールスルーサポートがあります。このパターンに一致するメソッドが存在する場合、このメソッドから返される値はReadOnlyObjectWrapperでラップされ、TableCellに返されます。ただし、この状況では、これは、TableCellが変更についてObservableValueを監視できないことを意味します（上記の最初のアプローチの場合のように）。

更新

これは、TableViewがアイテムのObservableListの変更とプロパティベースのアイテム属性の値の変更に基づいて監視し、自動的に更新する方法を示す最初の例とは対照的な例です。

import javafx.application.Application;
import javafx.beans.property.*;
import javafx.collections.*;
import javafx.event.*;
import javafx.geometry.Insets;
import javafx.scene.*;
import javafx.scene.control.*;
import javafx.scene.control.cell.PropertyValueFactory;
import javafx.scene.layout.VBox;
import javafx.scene.text.Font;
import javafx.stage.Stage;

public class PropertyBasedTableView extends Application {
  private TableView<Person> table = new TableView<Person>();
  private final ObservableList<Person> data = FXCollections.observableArrayList();
  private void initData() {
    data.setAll(
      new Person("Jacob", "Smith", "[email protected]"),
      new Person("Isabella", "Johnson", "[email protected]"),
      new Person("Ethan", "Williams", "[email protected]"),
      new Person("Emma", "Jones", "[email protected]"),
      new Person("Michael", "Brown", "[email protected]")
    );
  }

  public static void main(String[] args) { launch(args); }

  @Override public void start(Stage stage) {
    initData();

    stage.setTitle("Table View Sample");
    stage.setWidth(450);
    stage.setHeight(500);

    final Label label = new Label("Address Book");
    label.setFont(new Font("Arial", 20));

    TableColumn firstNameCol = new TableColumn("First Name");
    firstNameCol.setMinWidth(100);
    firstNameCol.setCellValueFactory(new PropertyValueFactory<Person, String>("firstName"));

    TableColumn lastNameCol = new TableColumn("Last Name");
    lastNameCol.setMinWidth(100);
    lastNameCol.setCellValueFactory(new PropertyValueFactory<Person, String>("lastName"));

    TableColumn emailCol = new TableColumn("Email");
    emailCol.setMinWidth(200);
    emailCol.setCellValueFactory(new PropertyValueFactory<Person, String>("email"));

    table.setItems(data);
    table.getColumns().addAll(firstNameCol, lastNameCol, emailCol);
    table.setPrefHeight(300);

    final Button setEmailButton = new Button("Set first email in table to [email protected]");
    setEmailButton.setOnAction(new EventHandler<ActionEvent>() {
      @Override public void handle(ActionEvent event) {
        if (data.size() > 0) {
          data.get(0).setEmail("[email protected]");
        }  
      }
    });

    final Button removeRowButton = new Button("Remove first row from the table");
    removeRowButton.setOnAction(new EventHandler<ActionEvent>() {
      @Override public void handle(ActionEvent event) {
        if (data.size() > 0) {
          data.remove(0);
        }  
      }
    });

    final Button resetButton = new Button("Reset table data");
    resetButton.setOnAction(new EventHandler<ActionEvent>() {
      @Override public void handle(ActionEvent event) {
        initData();
      }
    });

    final VBox vbox = new VBox(10);
    vbox.setPadding(new Insets(10, 0, 0, 10));
    vbox.getChildren().addAll(label, table, setEmailButton, removeRowButton, resetButton);

    stage.setScene(new Scene(new Group(vbox)));
    stage.show();
  }

  public static class Person {
    private final StringProperty firstName;
    private final StringProperty lastName;
    private final StringProperty email;

    private Person(String fName, String lName, String email) {
      this.firstName = new SimpleStringProperty(fName);
      this.lastName = new SimpleStringProperty(lName);
      this.email = new SimpleStringProperty(email);
    }

    public String getFirstName() { return firstName.get(); }
    public void setFirstName(String fName) { firstName.set(fName); }
    public StringProperty firstNameProperty() { return firstName; }
    public String getLastName() { return lastName.get(); }
    public void setLastName(String lName) { lastName.set(lName); }
    public StringProperty lastNameProperty() { return lastName; }
    public String getEmail() { return email.get(); }
    public void setEmail(String inMail) { email.set(inMail); }
    public StringProperty emailProperty() { return email; }  // if this method is commented out then the tableview will not refresh when the email is set.
  }
}