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
作爲前綴的包裝類。創建只讀屬性需要兩個步驟。
- 實例化只讀包裝類
- 調用方法
getReadOnlyProperty()
返回一個真正的只讀屬性對象
ReadOnlyStringWrapper userName = new ReadOnlyStringWrapper("yiibai.com");
ReadOnlyStringProperty readOnlyUserName = userName.getReadOnlyProperty();
JavaFX JavaBean
以下代碼顯示瞭如何創建JavaFX JavaBean。當構建基於Swing的應用程序時,我們使用getter
和setter
創建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()
方法,它接受兩種類型的功能接口:ChangeListener
和invalidationListener
。
所有JavaFX屬性都是實現了ObservableValue
和Observable
接口,它們分別爲ChangeListener
和invalidationListener
提供了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());
});
}
}
ChangeListener
和invalidationListener
之間的區別。
- 使用
ChangeListener
將可獲取Observable(ObservableValue)
的舊值和新值。 - 使用
invalidationListener
只獲取Observable
對象(屬性)