Leonardi, une approche de l'IHM en Java

La première étape de développement d'une application cliente avec Leonardi est la modélisation. Les données de l'application sont d'abord décrites par le développeur pour aboutir à un méta modèle (format XML) : c'est le MMI Model™, décrivant les données du monde métier, leur structure (basée sur des classes et des attributs typés) et les traitements que l'utilisateur final peut leur soumettre. Le MMI Model™ peut être généré de manière automatique par introspection de données existantes (SGBD, Java...), par import XMI ou encore de manière assistée grâce à l'atelier de LEONARDI Studio.

Pour comprendre cette modélisation, expliquons les étapes de création des diverses classes de l'application HOTEL. Nous allons expliquer la définition des classes applicatives de cette application de réservation de chambres.

Créons tout d'abord une application dont l'identifiant sera HOTEL et le titre HOTEL également.

La première classe à créer est la classe " province ". Pour cela, il suffit de cliquer sur l'action Créer … dans la barre d'outils Edition. Dans la fenêtre qui apparaît, nous allons saisir les champs :

• Identifiant : province
• Nom : Région
• Image : une petite image qui représente cette classe

Après validation, la classe " province " est visible dans l'onglet Arborescence des classes avec l'image qui lui a été associée. Si on n'a pas rempli le champ image, une image par défaut est affichée.

Maintenant, il faut décrire les attributs de la classe " province ". Nous allons affecter deux attributs à cette classe : un identifiant et un nom. Pour créer l'attribut " identifiant ", sélectionner la classe province et déclencher le clic droit pour afficher un menu contextuel : cliquer sur Créer Attribut textuel. La fenêtre de création d'un nouvel attribut textuel de classe apparaît alors à l'écran. Nous allons saisir dans cette fenêtre les champs suivants :

• Identifiant : province_id
• Nom : Identifiant

Nous allons ensuite créer le deuxième attribut sur le nom :

• Identifiant : province_name
• Nom : Nom

Nous allons maintenant configurer leur comportement (behaviour) en modifiant les marques : sélectionner l'attribut dans le panneau droit de l'écran puis cliquer sur Modifier les marques … dans la barre d'outils des attributs.

La fenêtre de modification des marques s'affiche alors et propose un ensemble de choix qui vont nous permettre de paramétrer le comportement des attributs. Pour le premier attribut nous sélectionnons les marques id, create et hidden. Pour le deuxième attribut nous sélectionnons les marques name, create, set, unique et main.

Remarque : Il y a aussi une astuce rapide pour créer et paramétrer les attributs. Double cliquez sur la classe applicative en question puis basculer dans l'onglet Attributs, il suffit d'écrire en une seule ligne les informations sur l'attribut avec ses marques génériques.

Nous allons maintenant nous intéresser aux actions disponibles sur la classe " province ". Nous allons donc seulement autoriser les actions de création, de modification et de suppression sur cette classe. Pour cela nous allons nous positionner dans l'onglet Action. On peut alors enrichir cette application avec de nouvelles classes plus complexes : villes, gérants, établissements, chambres, réservations, réservations en cours, etc. L'attribut employé jusque là n'est que l'attribut textuel, il faut préciser que Leonardi en possède tant d'autres : numérique, temporel, énuméré, relationnel, fichier, tableau, champ typé, etc. L'attribut relationnel permet par exemple de lier une classe existante avec la classe qui l'utilise. L'attribut fichier est souvent utilisé pour associer une image comme attribut d'une classe en cochant le type image lors de la création de l'attribut .

Ainsi, nous avons compris comment définir des classes avec ses attributs sous Leonardi. Laissons cette application de réservation hôtelière mais attaquons avec une toute autre application, une sorte de petit exercice, relativement simple dont voici un tableau récapitulatif de ses classes (application de gestion d'une librairie):

Classe Domaine

Les domaines seront par exemple : arts, informatique, électronique, romans, etc. Le fait que la catégorie ne contient que id assigne que cet attribut est un membre statique de la classe (pas touche !).

Classe Livre

Arbre de navigation de l'application HOTEL :

A partir de maintenant, vous pouvez exécuter votre application Leonardi. Pour cela, il suffit de cliquer sur Exécuter puis de sélectionner parmi les afficheurs au choix : SWT, SWING, DHTML/AJAX et SVG.

Intéressons-nous maintenant à la déclaration de l'arbre de navigation. Il s'agit d'indiquer à Leonardi comment afficher les données applicatives à l'utilisateur final. Il suffit d'aller dans l'onglet Arbre de navigation. On peut faire tout simple en déclenchant le bouton de génération automatique de l'interface graphique : cliquer sur Générer l'IHM par défaut. Au moment où notre arbre de navigation est défini, on est en mesure d'exécuter notre application.

Il est intéressant d'implémenter une action de login pour notre application comme celle de l'application de démo HOTEL.

Nous allons donc créer une action racine qui sera pour notre application une action de login. Dans l'onglet Arbre de navigation nous allons déclencher l'action Créer une action. Choisir le type login et renseigner l'identifiant et le nom, puis cliquer sur suivant.

Il s'avère que l'application créée avant cette section est plutôt basique. Afin de personnaliser l'application, on utilise Java pour attribuer des comportements spécifiques au programme. Pour cela, il faut ouvrir ou créer une application en niveau avancé (l'onglet Classes Java s'ajoute dans la fenêtre principale du Studio).

Sur la classe sur laquelle on voudrait attribuer un comportement spécifique, choisir Comportement de classe dans le menu contextuel et valider les propositions faites dans le formulaire. L'éditeur que vous avez indiqué dans les préférences s'ouvre alors avec une classe Java générée par Leonardi comme le code suivant:

package bibliotheque.behavior;

import java.util.*;
import leon.app.behavior.*;
import leon.app.behaviorinterface.*;
import leon.control.*;
import leon.data.*;
import leon.info.*;
import leon.view.event.*;

public class DomaineClassBehavior extends LyClassBehavior
{
	/**
	 * Default Constructor
	 */
	public DomaineClassBehavior()
	{
	}

	public void init(LyController controller)
	{
		super.init(controller);
	}
}

Vous pouvez alors surcharger toutes les méthodes que vous voulez contrôler : par ex controlNewValues() pour le contrôle sur la saisie d'une valeur lors de la création/modification d'une donnée. On peut aussi basculer dans l'arbre de navigation pour développer des comportements de présentation : choisir Comportement de l'action > Comportement de l'action dans le menu contextuel.

Concernant les classes Java utilisables au sein du framework (ici), outre les classes Java standard, il est fourni avec l'application Leonardi plusieurs documents qui indiquent comment prendre en main la programmation IHM en Java, ainsi qu'une documentation complète des classes et méthodes disponibles au sein de Leonardi. Sous Windows, des liens sont créés dans le menu "Démarrer" pour en savoir plus sur les API Leonardi (import leon.*).

Voici par exemple la liste des méthodes générées automatiquement lors du clic sur le comportement de classe:

Méthodes héritées de la classe leon.app.behavior.LyClassBehavior:
addExtraValues, buildFilterElement, changeState, checkDeletion, checkDeletions, checkNewValue, checkNewValue, controlNewValue, controlNewValue, controlNewValues, copy, enableChoiceOption, enableRelationLink, enableRelationLink, endCreation, endDeletion, endSet, getAction, getAutoCompletionMaximum, getAutoCompletionValues, getChoiceContextOptions, getChoiceDomain, getConfirmDeletionMessage, getDefaultValue, getFacetObjects, getFilterChoiceDomain, getFilterRelationClasses, getFilterRelationDomain, getFilterTransverseActions, getImage, getNextValue, getRelationClasses, getRelationContext, getRelationDomain, getRelationFilter, getTabName, getTitle, getTransverseActions, getTransverseActions, getValue, hide, isDisplayed, isEditable, isEnabled, isOptional, isValidGroup, modify, needCheck, paste, propagate, setObject, show, useEditTable, useEditTable.

Méthodes héritées de la classe leon.app.behavior.LyActionBehavior (la classe mère de LyClassBehaviour):
endAction, getClientContext, getContextTitle, getHelpFile, getImage, getImageTooltip, getMenuItemImage, reset, startAction

Méthodes héritées de la classe leon.app.behavior.LyBehavior:
free, handleDemand, init
etc.

On est alors libre de surcharger ces méthodes pour obtenir des comportements spécifiques pour notre application. Il peut parfois être très utile de consulter le code source des classes API de Leonardi pour mieux comprendre leurs fonctionnements, les sources se trouvent dans le dossier src/leon du répertoire d'installation.

Pour fonctionner, Leonardi nécessite :

• JDK 1.4.2
• Eclipse V3 à V3.2
• Windows 2000, XP et supérieur ou une distribution Linux avec un noyau 2.4.3 et supérieur mais également sous Unix et Mac OS X

Il est intéressant de savoir que Leonardi existe aussi en version Plugin Eclipse Standalone qui permet d'utiliser tout le studio dans le fameux EDI Eclipse. Pour l'utiliser, il faut installer le plugin Eclipse de Leonardi Studio qui se situe au départ dans le fichier compressé com.lyria.studio_3.3.zip qui est à décompresser dans le répertoire des plugin de Eclipse. Pour le lancer, il suffit de suivre le menu Window > Open Perspective > Other sous Eclipse, puis normalement Leonardi Studio doit apparaître dans la liste qui s'affiche, sélectionner et lancer pour utiliser le SDK Eclipse de Leonardi. Ainsi, on peut faire tout ce qu'on peut faire dans Leonardi Studio dans l'EDI de Eclipse.

Remarque : Leonardi Studio n'est pas une application Win32 ou un exécutable Linux à part entière mais un programme Java ! Le raccourci correspondant à Leonardi ne fait qu'ouvrir avec la machine virtuelle Java (JVM) les exécutables JAR correspondant à Leonardi Studio.

Il ne faut pas oublier d'indiquer le répertoire du JDK dans le menu Préférences de Leonardi Studio.