FAQ JavaFXConsultez toutes les FAQ

Pour créer une liaison simple entre deux propriétés de types compatibles, la propriété A et la propriété B, il suffit d'invoquer la méthode bind() de la propriété B en passant en paramètre la propriété A.



Imaginons que nous avons un objet1 disposant de la propriété A et un objet 2 disposant de la propriété B. Établissons une liaison entre A et B, ceci nous donne:

objet2.bProperty().bind(objet1.aProperty());

1
2
objet2.bProperty().bind(objet1.aProperty()); 
objet2.bProperty().bind(objet3.cProperty());

1
2
3
objet2.bProperty().bind(objet1.aProperty()); 
objet3.cProperty().bind(objet1.aProperty()); 
objet4.dProperty().bind(objet1.aProperty());

Il suffit d'appeler la méthode unbind() de la propriété.

Reprenons notre exemple de la propriété B liée à la propriété A. Si maintenant nous faisons :

objet2.bProperty().unbind();

Pour savoir si une propriété est déjà "bindée", c'est-à-dire si elle est liée à la valeur d'une autre propriété par une liaison simple ou unidirectionnelle, il suffit de tester la valeur retournée par sa méthode isBound(). Si cette méthode retourne true, alors cette propriété est liée à une autre et tout appel à un setter lèvera une exception.

Pour établir une liaison bidirectionnelle entre deux propriétés de types compatibles, la propriété A et la propriété B, il suffit d'invoquer la méthode bindBidirectional() de la propriété B en passant en paramètre la propriété A.



Ce qui nous donne :

objet2.bProperty().bindBidirectional(objet1.aProperty());

• Si on invoque un des setters de la propriété A, la valeur de la propriété B sera modifiée.
• Si on invoque un des setters de la propriété B, la valeur de la propriété A sera modifiée.
  

1
2
objet2.bProperty().bindBidirectional(objet1.aProperty()); 
objet2.bProperty().bindBidirectional(objet3.cProperty());

• si on invoque un des setters de la propriété A, les valeurs des propriétés B et C sont modifiées ;
• si on invoque un des setters de la propriété B, les valeurs des propriétés A et C sont modifiées ;
• si on invoque un des setters de la propriété C, les valeurs des propriétés A et B sont modifiées.
  

Il suffit d'appeler la méthode unbindBidirectional() de la propriété en passant en paramètre la propriété liée.

Reprenons notre exemple de la propriété B liée bidirectionnellement à la propriété A. Si nous faisons :

objet2.bProperty().unbindBidirectional(objet1.aProperty());

Il est en effet possible dans le code d’établir des liaisons simples et bidirectionnelles à partir d'une seule et même propriété. Rien ne l’empêche, mais ce n'est pas recommandé.



En effet une propriété qui établit une liaison simple se place dans un état dans lequel on ne peut plus appeler son setter. Si la valeur de la propriété doit être modifiée à cause d'une modification propagée via la liaison bidirectionnelle, cela peut provoquer la levée d'une exception ou placer votre graphe de propriétés liées entre elles dans un état incohérent dans lequel elles n'auraient pas les valeurs escomptées.

Imaginons que nous ayons une propriété currentUser qui contient un objet de type Person (une personne). La classe Person dispose d'une propriété name contenant le nom de cette personne sous forme de String. Or c'est cette propriété name que nous désirons manipuler ou afficher : nous voulons donc accéder à la propriété d'une propriété.

Nous avons les cas de figure suivants :

• si la propriété currentUser est à la valeur null, nous voulons manipuler une chaine de caractères observable qui contient null (un utilisateur null n'a pas de nom) ;
• si la propriété currentUser est à l'utilisateur "Cyril Lacroix", nous voulons manipuler une chaine de caractères observable qui contient "Lacroix" ;
• si la propriété currentUser est à l'utilisateur "Ingrid Etiakov", nous voulons manipuler une chaine de caractères observable qui contient "Etiakov".
  

final StringBinding currentUserName = Bindings.selectString(currentUserProperty(), "name");

final StringBinding currentUserName = currentUserProperty().get().nameProperty();

Il faut faire… exactement comme dans la question précédente !

En fait, il est possible de spécifier les différents niveaux de propriété que nous devons traverser jusqu'à la propriété ciblée en spécifiant les différentes étapes à traverser dans des paramètres distincts :

final IntegerBinding currentCountryCode = Bindings.selectInteger(currentUserProperty(), "country", "countryCode");

final IntegerBinding currentCountryCode = currentUserProperty().get().countryProperty().get().countryCodeProperty();

La classe utilitaire javafx.beans.binding.Bindings dispose de plusieurs méthodes permettant d'effectuer des opérations arithmétiques entre des propriétés numériques.

Ainsi, imaginons que nous ayons plusieurs variables x, y et z, et que nous désirions effectuer l’opération suivante :

w = 5 * x + y / z

final DoubleBinding w = Bindings.multiply(5, xProperty()).add(Bindings.divide(yProperty(), zProperty());