Skip to content
Vincent Richard edited this page Nov 27, 2023 · 4 revisions

Copyright © 2008, 2023 Obeo – All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v2.0

ISD – Outillage de databinding

L’outillage de databinding permet de modéliser le databinding entre types structurés (Entity, DTO ou Domain class).
L’objectif classique est de spécifier la façon dont des structures de données vont être transformées pour convertir par exemple une Entity en DTO.

Point de vue IS Databading

L’outillage de databinding embarque un point vue fournissant :

  • Un diagramme permettant de créer un databinding entre deux types structurés
  • Un éditeur spécifique permettant de lier les attributs et références des types structurés

Pour activer le point de vue IS Databinding, sur une session Viewpoint ouverte, lancer le menu

Viewpoint Selection

Choisir le point de vue IS Databinding.

Databinding diagram

Le Databinding Diagram permet de créer un Binding entre deux types structurés (Entity, DTO ou Domain class). Cet objet peut ensuite être édité en détail en lançant l’éditeur spécifique Binding editor par un double-clic sur l’élément.
Ce diagramme peut être créé sur un package (Namespace).

Eléments affichés et palette d’outils

Les éléments suivants sont affichés sur le diagramme :

  • Entity : entité impliquée dans un binding
  • DTO : DTO impliqué dans un binding
  • Domain class : Classe participante impliquée dans un binding
  • Binding : élément portant les informations de databinding entre deux types structurés.

Les outils fournis par la palette sont :

Création d’un Binding entre deux éléments. Un assistant permet de sélectionner un premier type structuré parmi ceux contenus par le package, puis de sélectionner un deuxième type structuré dans toute la session de travail.
Création d’un Binding entre un type structuré déjà affiché sur le diagramme et un deuxième type structuré. Un assistant permet de sélectionner ce deuxième type structuré dans toute la session de travail.

Navigation vers l’éditeur de binding

Il est possible de naviguer depuis ce diagramme vers l’éditeur de binding :

  • Sur un Binding, un double-clic ou le menu Open permettent d’ouvrir un Binding Editor sur l’élément sélectionné.

Binding editor

Le Binding editor est un éditeur spécifique permettant décrire en détail le databinding entre deux types structurés. Le moyen le plus simple pour l’ouvrir est de double-cliquer sur le Binding voulu sur le diagramme décrit au chapitre précédent.

Structure générale de l’éditeur

L’éditeur est divisé en différentes parties :

  • Une vue arborescente du premier type structuré à gauche
  • Une vue arborescente du deuxième type structuré à droite
  • Une zone centrale affichant les liens entre types
  • Un bouton Auto bind !
  • Une zone inférieure permettant d’éditer des expressions pour convertir les valeurs

Vue arborescente d’un type structuré

Cette vue présente les attributs et les références du type structuré.
Dans le cas des références, il est possible de déplier la référence pour avoir accès aux attributs et références du type référencé.

A partir de cette vue, il est possible de sélectionner un attribut ou une référence et de la faire glisser jusqu’à la vue opposée sur un attribut ou une référence. Un lien est alors créé entre les deux éléments.

Lorsqu’un ou des éléments sont sélectionnés, les liens les concernant sont affichés de façon plus visible sur la zone centrale.

Zone centrale

La zone centrale permet de visualiser les liens entre éléments.

Il est possible de sélectionner un ou plusieurs liens pour les rendre plus visibles. La sélection multiple se fait en maintenant la touche Ctrl enfoncée.
Lorsqu’un lien est sélectionné, les éléments liés sont mis en surbrillance et le contenu de la zone inférieure est mis à jour.

Quand des liens sont sélectionnées, un appui sur la touche Del permet de les supprimer après un message de confirmation.

Zone inférieure

La zone inférieure affiche des champs de saisie en fonction des liens sélectionnés :

  • un premier groupe affiche un champ texte pour chaque attribut ou référence concerné dans la vue arborescente de gauche.
  • un deuximèe groupe affiche un champ texte pour chaque attribut ou référence concerné dans la vue arborescente de droite.

Les champs de saisie permettent de saisir des expressions utilisées pour décrire comment les données sont converties. Le texte saisi n’est pas interprété, c’est à l’utilisateur de choisir le pseudo-langage qui lui convient le mieux.

La zone inférieure peut être réduite ou agrandie en hauteur en sélectionnant la limite de la zone centrale juste au dessus du bouton Auto bind !.

Bouton Auto bind !

Le bouton Auto bind ! permet de créer automatiquement des liens entre les éléments à gauche et à droite nommés de la même façon.