JavaFX教程 – JavaFX绑定
JavaFX绑定同步两个值:当因变量更改时,其他变量更改。
要将属性绑定到另一个属性,请调用bind()方法,该方法在一个方向绑定值。例如,当属性A绑定到属性B时,属性B的更改将更新属性A,但不是相反。
绑定选项
JavaFX提供了许多绑定选项,以便在域对象和GUI控件中的属性之间进行同步。
我们可以在JavaFX的属性API中使用以下三种绑定策略:
- Java Bean上的双向绑定
- 与Fluent API的高级绑定
- 使用
javafx.beans.binding.*
中定义的绑定对象进行低级绑定。
双向绑定
双向绑定绑定相同类型的属性,并同步两侧的a值。
当与bindBidirectional()方法双向绑定时,需要两个属性都必须是可读/可写的。
以下代码显示如何在firstName属性和字符串属性变量之间进行双向绑定
import javafx.beans.property.SimpleStringProperty; import javafx.beans.property.StringProperty; public class Main { public static void main(String[] args) { User contact = new User("Jame", "Bind"); StringProperty fname = new SimpleStringProperty(); fname.bindBidirectional(contact.firstNameProperty()); contact.firstNameProperty().set("new value"); fname.set("New First Name"); System.out.println("firstNameProperty = " + contact.firstNameProperty().get()); System.out.println("fname = " + fname.get()); } } class User { private SimpleStringProperty firstName = new SimpleStringProperty(); private SimpleStringProperty lastName = new SimpleStringProperty(); public User(String fn, String ln) { firstName.setValue(fn); lastName.setValue(ln); } public final String getFirstName() { return firstName.getValue(); } public StringProperty firstNameProperty() { return firstName; } public final void setFirstName(String firstName) { this.firstName.setValue(firstName); } public final String getLastName() { return lastName.getValue(); } public StringProperty lastNameProperty() { return lastName; } public final void setLastName(String lastName) { this.lastName.setValue(lastName); } }
上面的代码生成以下结果。
高级绑定
我们还可以使用JavaFX fluent API来绑定属性。流利的API使用类似英语的方法名称对属性执行操作。
例如,multiply(),divide(),subtract(),isEqualTo(),isNotEqualTo(),concat()。请注意,方法名称中没有get或set。当链接流畅的API在一起,我们可以编写代码,如同我们正在写句子,例如 width().multiply(height()).divide(2)
。
以下代码显示如何创建表示计算矩形面积的公式的属性。
它通过使用 javafx.beans.binding.IntegerExpression
接口中的fluent API来执行高级绑定。
该代码使用 multiply()
方法,该方法返回包含计算值的NumberBinding。
这种绑定是延迟评估的,这意味着乘法不会发生,除非我们通过 get()
或 getValue()
方法调用属性的值。
import javafx.beans.binding.NumberBinding; import javafx.beans.property.IntegerProperty; import javafx.beans.property.SimpleIntegerProperty; public class Main { public static void main(String[] args) { // Area = width * height IntegerProperty width = new SimpleIntegerProperty(10); IntegerProperty height = new SimpleIntegerProperty(10); NumberBinding area = width.multiply(height); System.out.println(area.getValue()); } }
上面的代码生成以下结果。
低级绑定
当对 NumberBinding
类进行子类化时,我们使用低级绑定,例如Double类型的DoubleBinding类。
在DoubleBinding类的子类中,我们重写其 computeValue()
方法,以便我们可以使用运算符(如*
和 -
)来制定复杂的数学方程。
高级绑定使用诸如multiply(),subtract()等方法低级绑定使用诸如*和 – 之类的运算符。
以下代码显示如何为公式创建低级别绑定以计算矩形的面积。
import javafx.beans.binding.DoubleBinding; import javafx.beans.property.DoubleProperty; import javafx.beans.property.SimpleDoubleProperty; public class Main { public static void main(String[] args) { DoubleProperty width = new SimpleDoubleProperty(2); DoubleProperty height = new SimpleDoubleProperty(2); DoubleBinding area = new DoubleBinding() { { super.bind(width, height); // initial bind } @Override protected double computeValue() { return width.get() * height.get(); } }; System.out.println(area.get()); } }
上面的代码生成以下结果。
UI控件和域模型之间的绑定
在JavaFX中,UI控件和域模型之间的数据绑定很容易。以下代码显示如何创建登录对话框并绑定用户域对象。
首先,我们定义域对象,它是描述用户名和密码的JavaFX JavaBean。
class User { private final ReadOnlyStringWrapper userName; private StringProperty password; public User() { userName = new ReadOnlyStringWrapper(this, "userName", "ABC"); password = new SimpleStringProperty(this, "password", ""); } public final String getUserName() { return userName.get(); } public ReadOnlyStringProperty userNameProperty() { return userName.getReadOnlyProperty(); } public final String getPassword() { return password.get(); } public StringProperty passwordProperty() { return password; } }
我们创建了两个UI控件,一个是用Text控件显示用户名,另一个是PasswordField控件,它将输入值绑定到域对象中的密码字段。
Text userName = new Text(); userName.textProperty().bind(user.userNameProperty()); PasswordField passwordField = new PasswordField(); passwordField.setPromptText("Password"); user.passwordProperty().bind(passwordField.textProperty());
BooleanProperty accessGranted在passwordField的文本值属性的更改侦听器中设置。
passwordField.textProperty().addListener((obs, ov, nv) -> { boolean granted = passwordField.getText().equals(MY_PASS); accessGranted.set(granted); if (granted) { primaryStage.setTitle(""); } });
在enter键hit事件中访问BooleanProperty accessGranted。
// user hits the enter key passwordField.setOnAction(actionEvent -> { if (accessGranted.get()) { System.out.println("granted access:"+ user.getUserName()); System.out.println("password:"+ user.getPassword()); Platform.exit(); } else { primaryStage.setTitle("no access"); } });
完整的源代码。
import javafx.application.Application; import javafx.application.Platform; import javafx.beans.property.BooleanProperty; import javafx.beans.property.ReadOnlyStringProperty; import javafx.beans.property.ReadOnlyStringWrapper; import javafx.beans.property.SimpleBooleanProperty; import javafx.beans.property.SimpleStringProperty; import javafx.beans.property.StringProperty; import javafx.scene.Group; import javafx.scene.Scene; import javafx.scene.control.PasswordField; import javafx.scene.layout.VBox; import javafx.scene.text.Text; import javafx.stage.Stage; public class Main extends Application { private final static String MY_PASS = "asdf"; private final static BooleanProperty accessGranted = new SimpleBooleanProperty(false); @Override public void start(Stage primaryStage) { User user = new User(); Group root = new Group(); Scene scene = new Scene(root, 320, 100); primaryStage.setScene(scene); Text userName = new Text(); userName.textProperty().bind(user.userNameProperty()); PasswordField passwordField = new PasswordField(); passwordField.setPromptText("Password"); user.passwordProperty().bind(passwordField.textProperty()); // user hits the enter key passwordField.setOnAction(actionEvent -> { if (accessGranted.get()) { System.out.println("granted access:"+ user.getUserName()); System.out.println("password:"+ user.getPassword()); Platform.exit(); } else { primaryStage.setTitle("no access"); } }); passwordField.textProperty().addListener((obs, ov, nv) -> { boolean granted = passwordField.getText().equals(MY_PASS); accessGranted.set(granted); if (granted) { primaryStage.setTitle(""); } }); VBox formLayout = new VBox(4); formLayout.getChildren().addAll(userName, passwordField); formLayout.setLayoutX(12); formLayout.setLayoutY(12); root.getChildren().addAll(formLayout); primaryStage.show(); } public static void main(String[] args) { launch(args); } } class User { private final ReadOnlyStringWrapper userName; private StringProperty password; public User() { userName = new ReadOnlyStringWrapper(this, "userName", "ABC"); password = new SimpleStringProperty(this, "password", ""); } public final String getUserName() { return userName.get(); } public ReadOnlyStringProperty userNameProperty() { return userName.getReadOnlyProperty(); } public final String getPassword() { return password.get(); } public StringProperty passwordProperty() { return password; } }
上面的代码生成以下结果。