JavaFX屬性

JavaFX屬性存儲控件的內部狀態,並允許我們監聽來自JavaFX UI控件的狀態更改。JavaFX屬性可以彼此綁定。綁定行爲允許屬性根據來自另一個屬性的更改值來同步其值。

JavaFX屬性的類型

有兩種類型的JavaFX屬性:

  • 讀寫(Read/Writable)
  • 只讀(Read-Only)

JavaFX的屬性包含實際值,並提供更改支持,無效支持和綁定功能。所有JavaFX屬性類都位於javafx.beans.property.*包命名空間中。
下面的列表是常用的屬性類。

  • javafx.beans.property.SimpleBooleanProperty
  • javafx.beans.property.ReadOnlyBooleanWrapper
  • javafx.beans.property.SimpleintegerProperty
  • javafx.beans.property.ReadOnlyintegerWrapper
  • javafx.beans.property.SimpleDoubleProperty
  • javafx.beans.property.ReadOnlyDoubleWrapper
  • javafx.beans.property.SimpleStringProperty
  • javafx.beans.property.ReadOnlyStringWrapper

Simple的屬性是讀/寫屬性類。擁有ReadOnly的屬性是隻讀屬性。

讀/可寫屬性

讀/寫屬性是可以讀取和修改的屬性值。例如,SimpleStringProperty類創建一個字符串屬性,該屬性對包裝的字符串值是可讀寫的。
以下代碼演示了SimpleStringProperty類的一個實例,並通過set()方法修改該屬性。

import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;

public class Main{
  public static void main(String[] args) {
    StringProperty password  = new SimpleStringProperty("yiibai.com");
    password.set("example.com");
    System.out.println("Modified StringProperty "  + password.get() );
  }
}

上面的代碼生成以下結果。

Modified StringProperty example.com

上面的代碼聲明瞭類型爲StringProperty的變量password,並分配給SimpleStringProperty類的實例。實際的值是字符串「yiibai.com」,它被傳遞到SimpleStringProperty類的構造函數中。

要讀取值,請調用get()方法或getValue()方法,該方法返回實際的包裝值。如果要修改這個值,請調用set()方法或setValue()並傳入一個字符串值。

只讀屬性

要創建只讀屬性,請使用以ReadOnly作爲前綴的包裝類。創建只讀屬性需要兩個步驟。

  1. 實例化只讀包裝類
  2. 調用方法getReadOnlyProperty()返回一個真正的只讀屬性對象
ReadOnlyStringWrapper userName = new ReadOnlyStringWrapper("yiibai.com"); 
ReadOnlyStringProperty readOnlyUserName  = userName.getReadOnlyProperty();

JavaFX JavaBean

以下代碼顯示瞭如何創建JavaFX JavaBean。當構建基於Swing的應用程序時,我們使用gettersetter創建JavaBean

然後我們必須通過Swing模型類在UI邏輯中獲取和設置數據。通過使用JavaFX屬性創建JavaFX JavaBean,JavaFX將執行數據綁定,並完成域模型類和UI控件之間的數據交換作業。參考以下代碼 -

import javafx.beans.property.ReadOnlyStringProperty;
import javafx.beans.property.ReadOnlyStringWrapper;
import javafx.beans.property.SimpleStringProperty;
import javafx.beans.property.StringProperty;

class User {
  private final static String USERNAME_PROP_NAME = "userName";
  private final ReadOnlyStringWrapper userName;
  private final static String PASSWORD_PROP_NAME = "password";
  private StringProperty password;

  public User() {
    userName = new ReadOnlyStringWrapper(this, USERNAME_PROP_NAME,"fake user");
    password = new SimpleStringProperty(this, PASSWORD_PROP_NAME, "");
  }
  public final String getUserName() {
    return userName.get();
  }

  public ReadOnlyStringProperty userNameProperty() {
    return userName.getReadOnlyProperty();
  }

  public final String getPassword() {
    return password.get();
  }

  public final void setPassword(String password) {
    this.password.set(password);
  }

  public StringProperty passwordProperty() {
    return password;
  }
}

屬性更改事件

屬性可以通知值更改的事件處理程序,以便在屬性更改時進行響應處理相關操作。JavaFX屬性對象包含一個addListener()方法,它接受兩種類型的功能接口:ChangeListenerinvalidationListener
所有JavaFX屬性都是實現了ObservableValueObservable接口,它們分別爲ChangeListenerinvalidationListener提供了addListener()方法。

以下代碼顯示如何創建ChangeListener來註冊到屬性。當屬性的值發生改變時,將調用change()方法。

import javafx.beans.property.SimpleIntegerProperty;
import javafx.beans.value.ChangeListener;
import javafx.beans.value.ObservableValue;

public class Main {// copyright w  w w .Yi I b A I .COm 
  public static void main(String[] args) {
    SimpleIntegerProperty xProperty = new SimpleIntegerProperty(0);

    // Adding a change listener with anonymous inner class
    xProperty.addListener(new ChangeListener<Number>() {
      @Override
      public void changed(ObservableValue<? extends Number> ov, Number oldVal,
          Number newVal) {
        System.out.println("old value:"+oldVal);
        System.out.println("new value:"+newVal);
      }
    });

    // Adding a change listener with lambda expression
    xProperty.addListener((ObservableValue<? extends Number> ov, Number oldVal,
        Number newVal) -> {
          System.out.println("old value:"+oldVal);
          System.out.println("new value:"+newVal);
      });
  }
}

以下代碼顯示瞭如何創建一個invalidationListener以向屬性註冊。隨着屬性的值改變,將調用invalidated()方法。

import javafx.beans.InvalidationListener;
import javafx.beans.Observable;
import javafx.beans.property.SimpleIntegerProperty;

public class Main {
  public static void main(String[] args) {
    SimpleIntegerProperty xProperty = new SimpleIntegerProperty(0);

    // Adding a invalidation listener (anonymous inner class)
    xProperty.addListener(new InvalidationListener() {
      @Override
      public void invalidated(Observable o) {
        System.out.println(o.toString());
      }
    });

    // Adding a invalidation listener (lambda expression)
    xProperty.addListener((Observable o) -> {
      System.out.println(o.toString());
    });

  }
}

ChangeListenerinvalidationListener之間的區別。

  • 使用ChangeListener將可獲取Observable(ObservableValue)的舊值和新值。
  • 使用invalidationListener只獲取Observable對象(屬性)