PRISE EN MAIN RAPIDE Référence: APPCOMPOSER_QUICKSTART_043_FR

Transcription

1 PRISE EN MAIN RAPIDE Référence: APPCOMPOSER_QUICKSTART_043_FR Retrouvez ce document et ses prochaines mises à jour dans le W4 Documentation Browser

2

3 PRISE EN MAIN RAPIDE Référence: APPCOMPOSER_QUICKSTART_043_FR

4 W4. Tous droits réservés. L'acquisition du présent document confère un droit d'utilisation incessible, non exclusif et personnel et non un droit de propriété. L'utilisation, la copie, la reproduction et la distribution du présent document sont permises à condition: 1. que la mention de droits d'auteur ci-dessus figure sur toutes les copies et que cette mention de droits d'auteur et la présente mention d'autorisation apparaissent conjointement ; 2. que le présent document ne soit utilisé qu'à des fins d'information et non commerciales ; 3. que le présent document ne soit modifié de quelque manière que ce soit. Tous les produits et marques cités sont la propriété de leurs titulaires respectifs. Les informations contenues dans ce document pourront faire l objet de modifications sans préavis.

5

6 Sommaire Présentation 6 Étape 1 : description du modèle de données 8 Étape 2 (facultative) : description de la navigation 16 Étape 3 (facultative) : spécialisation de l application 22 Étape 4 (facultative) : connexion à une base MySQL 28 Perspectives 30 Application Composer Prise en main rapide 4

7 5 Sommaire

8 Chapitre 1 1 Présentation Est-il possible de développer simplement une IHM (interface homme-machine), en client riche, léger ou lourd, sans aucune connaissance préalable de ces technologies? Oui, en se concentrant sur son métier et en ne manipulant que des concepts applicatifs. Cette approche est celle d Application Suite, suite logicielle de W4. Dans Application Suite, Application Composer et Application Engine proposent un environnement Model-Driven permettant d industrialiser le développement d applications métier complexes et évolutives en mode agile. Site web de W4 : > Dans cette section : > Tutoriel Prise en main rapide, page 6 > Application Suite, page 7 > Principe de fonctionnement, page 7 Ce tutoriel comporte les étapes suivantes : > 2 Étape 1 : description du modèle de données, page 8 > 3 Étape 2 (facultative) : description de la navigation, page 16 > 4 Étape 3 (facultative) : spécialisation de l application, page 22 > 5 Étape 4 (facultative) : connexion à une base MySQL, page 28 > 6 Perspectives, page 30 Tutoriel Prise en main rapide Ce tutoriel va vous permettre, sans aucune connaissance technique préalable, de réaliser en moins d une heure votre première application avec Application Composer. Application Composer Prise en main rapide 6

9 En vous guidant par itérations successives, ce tutoriel va vous permettre d atteindre progressivement d un résultat élaboré couvrant l ensemble des fonctionnalités attendues d une application de gestion d une vidéothèque personnelle. Application Suite Application Suite s inscrit dans une offre plus globale de W4, BUSINESS FIRST Application Composer, une suite logicielle de composition d applications métier. BUSINESS FIRST Application Composer comporte deux sous-ensembles : Application Suite et Process Suite. Au sein d Application Suite, Application Composer, l atelier de conception graphique au centre de ce tutoriel, gère les aspects modélisation et production de l IHM, et Application Engine est le moteur en charge de l exécution du résultat. Au sein de Process Suite, Process Composer et Process Engine offrent un environnement BPM complet pour la conception et l exécution des processus d entreprise. Principe de fonctionnement Avec Application Composer, le modèle de données est au centre des développements et doit être mis en place en premier lieu. Par simple paramétrage de ce modèle, le concepteur indique quelles sont les différentes vues présentées à l utilisateur final et comment s effectue la navigation entre les écrans. Toutes les contraintes techniques de présentation des données (production des vues, récupération et affichage de ces données, maintien en cohérence des différentes fenêtres de l application, etc.) sont prises en charge par la plate-forme elle-même, et plus particulièrement par le moteur Application Engine qui interprète le modèle pour produire dynamiquement les écrans de l application au moment où ils sont requis. A ce stade, le résultat est déjà exécutable en client lourd ou en mode web. Il peut ensuite être spécialisé itérativement par l ajout des comportements fonctionnels spécifiques et des ressources graphiques (couleurs, images, polices, etc.) pour proposer une application finalisée disponible en différents modes : Swing, Web (Struts), Web 2.0 (jquery). 7 Chapitre 1 Présentation

10 Chapitre 2 2 Étape 1 : description du modèle de données Pour composer l application de ce tutoriel, nous utiliserons l atelier de composition Application Composer. Application Composer est disponible soit dans sa version intégrée à Eclipse, soit en version autonome. Application Composer permet de créer la description d une application sans devoir écrire une seule ligne de code. Dans cette section : > Création de l application Vidéothèque, page 8 > Création de la classe Category, page 10 > Création de la classe Film, page 12 > Exécution de l application en client lourd (afficheur SWING), page 13 Création de l application Vidéothèque Au cours de ce tutoriel vous allez développer une application simple pour la gestion d une vidéothèque personnelle. Au démarrage d Application Composer, la fenêtre principale s affiche et présente sur la partie droite l arborescence des classes, vide pour l instant : Application Composer Prise en main rapide 8

11 Fig 2.1 Application Composer au démarrage Vous allez maintenant créer une nouvelle application. 0 POUR CRÉER L APPLICATION 1 Double-cliquez sur Nouveau / New... sur la fenêtre principale. La fenêtre Nouveau : Application / New : Application s affiche. 2 Renseignez l identifiant de la classe : videolibrary. Cet identifiant est interne. Il est utilisé par le concepteur. 3 Renseignez le titre de la classe : Videolibrary. Ce titre est externe. Il est visible par l utilisateur final. Le répertoire de sauvegarde ainsi que la langue peuvent être choisis librement, mais pour cet exemple vous pouvez conserver les options par défaut. Fig 2.2 Création de l application 9 Chapitre 2 Étape 1 : description du modèle de données

12 4 Cliquez sur Valider / Validate. L application est désormais créée, ce qui a pour effet d initialiser l arborescence de l Arbre des classes / Class hierarchy : Fig 2.3 Arbre des classes après la création de l application 5 Vous pouvez à ce stade sauvegarder votre travail : cliquez sur le bouton Enregistrer / Save sous la barre de menus, puis pensez à enregistrer régulièrement par la suite. Création de la classe Category Vous allez maintenant créer votre première classe applicative, représentant les catégories de films de la vidéothèque. Les catégories seront par exemple : comédie, drame, science-fiction, etc. 0 POUR CRÉER LA CLASSE CATÉGORIE 1 Dans l arbre des classes, cliquez sur Créer une classe... / Create class... La fenêtre Créer une classe / Create a class s affiche. Cette fenêtre vous permet de renseigner des informations sur la nouvelle classe, mais pour cet exemple, vous pouvez vous contenter de renseigner son nom. 2 Renseignez le nom : Category. Fig 2.4 Création d une classe 3 Cliquez sur Valider / Validate. Un nouveau nœud apparaît dans l arbre des classes : Application Composer Prise en main rapide 10

13 Fig 2.5 Arbre des classes après la création de la classe Catégorie La sélection d un nœud dans l arbre des classes affiche un aperçu des formulaires associés dans l onglet Editeur graphique / Visual builder. Le formulaire visualisé dans la zone centrale de l éditeur graphique est de type WYSIWYG : il correspond à celui qui sera utilisé à l exécution. Il est relatif, premièrement à la classe sélectionnée, et ensuite à l action concernée. Si vous sélectionnez la classe Category dans l arbre des classes, vous pouvez constater que pour l'instant, le formulaire est vide car la classe ne possède pas d attributs : Fig 2.6 Aperçu de la classe dans l Editeur graphique 4 Double-cliquez sur le libellé du champ pour le modifier : Fig 2.7 Modification d un libellé 5 Saisissez : Genre puis validez par ENTREE. Le genre Genre servira à afficher les catégories de films dans les différentes vues. 11 Chapitre 2 Étape 1 : description du modèle de données

14 Création de la classe Film En suivant le même principe, vous allez créer la seconde classe de votre application : Film. 0 POUR CRÉER LA CLASSE FILM 1 La classe Category est actuellement sélectionnée dans l arbre des classes. Avant de créer la classe Film, sélectionnez le second nœud de l arbre des classes, correspondant au projet Videolibrary. Fig 2.8 Arbre des classes avant la création de la classe Film 2 Créez une nouvelle classe. 3 Sur la fenêtre Créer une classe / Create class, renseignez les champs : Identifiant / ID: film Nom / Name: Film 4 Cliquez sur Valider / Validate. Un film est décrit par un titre, une catégorie et une année de sortie : Title est un champ texte simple, comme celui utilisé lors de la définition de la catégorie. Genre correspond à une relation simple vers la classe Catégorie définie précédemment. Release date correspond à un champ de type date (format JJ/MM/AAAA). 5 Créez le champ Title : 5.1 Dans l arbre des classes, sélectionnez la classe Film. 5.2 Dans l éditeur graphique, renommez le champ Name (créé par défaut) par : Title. 6 Créez le champ Genre : 6.1 Ajoutez un champ de type relation simple : faites glisser le composant Relations, à partir de la zone Types standard de l éditeur graphique, sur l aperçu du formulaire, sous le champ Title. La fenêtre Sélectionnez la classe cible s affiche. 6.2 Sélectionnez la classe Category dans la liste déroulante puis cliquez sur Valider / Validate. 6.3 Renommez le champ. 6.4 L attribut Genre n étant pas obligatoire pour la définition d'un film, ajoutez au champ la marque optional : sélectionnez le champ Genre sur l aperçu du formulaire, puis sélectionnez la case à cocher Optional dans la zone Propriétés / Properties. 7 Créez le champ Release date : 7.1 Ajoutez un champ de type date. 7.2 Renommez le champ. 7.3 L attribut Date de sortie n étant pas obligatoire pour la définition d'un film, ajoutez au champ la marque optional. Application Composer Prise en main rapide 12

15 La classe doit désormais se présenter comme suit : Fig 2.9 Formulaire de création d'un film, dans l éditeur et aperçu dans l application finale NOTE Les caractéristiques des classes métier ou de leurs attributs peuvent être modifiées par double-clic à partir de la zone Outline, en bas à droite, contextuelle à la sélection graphique dans le formulaire. Vous pouvez par exemple modifier l image associée à la classe. Lorsque la classe (et non ses champs) est sélectionnée dans l éditeur, double-cliquez sur le champ Image dans la zone Outline. Si aucune image n'est spécifiée, une image par défaut est utilisée, qui affiche la première lettre du nom de la classe en majuscule (F pour films, et C pour catégories). Vous pouvez constater que ce champ est facultatif car il est affiché en style normal, et non en gras. La description du modèle de données de votre vidéothèque est désormais terminée. Vous disposez désormais d une application opérationnelle. Exécution de l application en client lourd (afficheur SWING) Avant l exécution, vous allez indiquer à l application que les données manipulées devront être sauvegardées à l issue de la session utilisateur. Cela permettra de créer des données persistantes (films et catégories) réutilisables ultérieurement. Pour cela, vous allez éditer les propriétés de l application. De plus, étant donné que vous allez exécuter votre application en SWING, vous allez devoir éditer les préférences afin de renseigner le JDK à utiliser. 0 POUR MODIFIER LES PROPRIÉTÉS POUR L ÉTAPE 1 1 Cliquez sur le bouton Propriétés / Properties, sous la barre de menus. La fenêtre Modifier : Application : Videolibrary / Modify : Application : Videolibrary s affiche. 2 Affichez l onglet Environnement / Environment. 13 Chapitre 2 Étape 1 : description du modèle de données

16 3 Modifiez la variable LY_SAVE_FILES : 3.1 Cliquez dans la colonne Valeur en regard de la variable LY_SAVE_FILES. 3.2 Remplacez la valeur actuelle par true puis appuyez sur la touche ENTREE de votre clavier. 3.3 Cliquez sur Valider / Validate en regard de la variable LY_SAVE_FILES. 3.4 Cliquez sur Valider / Validate. Fig 2.10 Mise à jour des propriétés pour la persistance des données 0 POUR MODIFIER LES PRÉFÉRENCES POUR L ÉTAPE 1 1 Cliquez sur le bouton Préférences / Preferences, sous la barre de menus. La fenêtre Préférences / Preferences s affiche. 2 Affichez l onglet Java. 3 Renseignez le répertoire du JDK à utiliser. 4 Cliquez sur Valider / Validate. 0 POUR EXÉCUTER L APPLICATION EN SWING 1 Pour exécuter cette application métier sans le moindre effort, il vous suffit de choisir un environnement graphique tel que l afficheur SWING : sélectionnez Exécuter / Run Afficheur SWING / Display SWING. Application Composer Prise en main rapide 14

17 Fig 2.11 Exécution de l application en SWING (1/2) Le modèle est alors interprété par le moteur qui, à ce stade, est capable de générer un arbre des vues par défaut, calqué sur votre modèle de données et permettant d accéder aux différents écrans pour l administration de vos données. Vous pouvez créer des catégories et des films. Fig 2.12 Exécution de l application en SWING (2/2) Les services de consultation, création, modification et suppression sont d ores et déjà utilisables, de même que le tri, le filtrage etc. 15 Chapitre 2 Étape 1 : description du modèle de données

18 Chapitre 3 3 Étape 2 (facultative) : description de la navigation Nous l avons vu, cette étape n est pas indispensable pour obtenir une application rapidement opérationnelle. Cependant, elle est nécessaire pour particulariser les vues et il est utile de s y intéresser dans le cadre de ce tutoriel. Dans cette section : > Actions et arbre de navigation, page 16 > Création de l action composite Films par genres, page 17 Actions et arbre de navigation Intéressons-nous maintenant à la définition de l arbre de navigation. L onglet Arbre des vues permet d indiquer le mode d affichage des données applicatives à l utilisateur final et la navigation d un écran à l autre. L arbre ne contient pour le moment aucune action. Dans un premier temps, vous allez vous contenter d utiliser le bouton de génération automatique de l interface graphique. 0 POUR GÉNÉRER L IHM PAR DÉFAUT 1 Affichez l arbre des vues. 2 Cliquez sur Générer l IHM par défaut / Generate default GUI. Cette option crée une action racine (la première exécutée au lancement de l application par Application Engine) qui permet d accéder aux écrans associés aux différentes classes métier, présentées sous forme de tables. L arbre de navigation généré dans notre exemple contient donc une fenêtre principale permettant d afficher la liste des films et celle des catégories : Application Composer Prise en main rapide 16

19 Fig 3.1 Arbre de navigation La sélection d une action dans l arbre de navigation permet alors l affichage de l aperçu de la vue correspondante dans la zone centrale. Création de l action composite Films par genres Vous allez maintenant composer une vue supplémentaire présentant un accès aux films par genre. Pour cela, vous allez créer une vue composée à partir de deux vues élémentaires : un arbre visualisant les catégories sur la gauche (nouvelle action à créer) une table visualisant les films associés à la catégorie sélectionnée sur la droite (action existante à réutiliser) 0 POUR CRÉER L ACTION COMPOSITE 1 Dans l Arbre des vues, cliquez-droit sur le nœud racine puis sélectionnez l option de menu contextuel Créer une action composite... / Create a compound action... La fenêtre Créer une action composite / Create a compound action s affiche. 2 Nommez l action : Films by genres. 3 Créez la première vue (l arbre des catégories) : 3.1 Dans le cadre Composition, cliquez sur Créer une action / Create an action. La fenêtre Créer une action / Create an action 1/2 s affiche. 3.2 Dans le cadre Caractéristiques / Characteristics, sélectionnez Arbre / Tree. 3.3 Dans le cadre Identification, remplacez le nom par défaut par Genres. 3.4 Cliquez sur Suivant / Next. La fenêtre Créer une action / Create an action 2/2 s affiche. 3.5 Dans la liste déroulante Classe cible / Target class, sélectionnez Category. 17 Chapitre 3 Étape 2 (facultative) : description de la navigation

20 Fig 3.2 Création d une action arbre dans le cadre d une action composite 3.6 Cliquez sur Valider / Validate. Votre première action est désormais créée et apparaît dans la partie droite du cadre Composition : Application Composer Prise en main rapide 18

21 Fig 3.3 Première action de l action composite 4 Pour la seconde action, il vous suffit de réutiliser l action Film qui a été générée automatiquement lors de la génération de l IHM par défaut : sélectionnez l action Films dans le cadre de gauche puis cliquez sur Sélectionner / Select. La seconde action apparaît dans le cadre de droite : Fig 3.4 Seconde action de l action composite 19 Chapitre 3 Étape 2 (facultative) : description de la navigation

22 Notez qu il est possible de définir le contexte entre les vues. Dans notre exemple, la sélection d un genre de film dans l arbre détermine les films visualisés, vous pouvez donc laisser l option par défaut La 1ère action définit le contexte. 5 Cliquez sur Valider / Validate. L arbre des vues actualisé affiche cette nouvelle action composite : Fig 3.5 Arbre des vues après la création de l'action composite 6 Vous pouvez à ce stade exécuter à nouveau votre application et visualiser par la même occasion le résultat opérationnel en mode web : sélectionnez Exécuter / Run Afficheur Web / Display Web. A l exécution, vous pouvez remarquer que la fenêtre principale propose un menu Film avec deux entrées : Film (l action générée automatiquement) et Films by genre, l action composée que nous avons créée. NOTE Pour obtenir des entrées séparées, il suffit d associer des images différentes aux deux actions. Après avoir créé quelques données dans les catégories et les films en utilisant l application comme le ferait un utilisateur final, vous pouvez vérifier que la sélection d un genre, dans l arbre de gauche, met bien à jour la liste des films présentés dans la liste, à droite. Le résultat obtenu doit se présenter comme suit : Application Composer Prise en main rapide 20

23 Fig 3.6 Application vidéothèque en mode web 21 Chapitre 3 Étape 2 (facultative) : description de la navigation

24 Chapitre 4 4 Étape 3 (facultative) : spécialisation de l application Bien qu étant opérationnelle, votre application reste à ce stade relativement basique et doit être spécialisée. Pour cela vous allez maintenant développer deux comportements spécifiques en Java, l un assurant le respect d une règle métier, l autre spécialisant un comportement graphique. Dans cette section : > Premier comportement : règle métier sur la date de sortie du film, page 23 > Second comportement : spécialiser la représentation graphique de certains films, page 25 Avant de débuter cette étape, il convient de vérifier les préférences définies dans Application Composer. La définition de comportements spécifiques implique qu un éditeur de texte par défaut soit défini mais également qu Application Composer soit lancé par un profil autre que débutant. 0 POUR CONFIGURER LES PRÉFÉRENCES POUR L ÉTAPE 3 1 Cliquez sur Préférences / Preferences. 2 Sur l onglet Général / General, sélectionnez un profil autre que débutant : niveau standard, avancé ou expert. 3 Affichez l onglet Java. 4 Dans le champ Editeur / Editor, renseignez le chemin complet de l exécutable de l éditeur de texte à utiliser par défaut. 5 Cliquez sur Valider / Validate. 6 Redémarrez Application Composer. 7 Ouvrez l application Videolibrary. Application Composer Prise en main rapide 22

25 Premier comportement : règle métier sur la date de sortie du film Supposons que vous souhaitiez limiter les films de votre vidéothèque aux films sortis au cours du 20ème siècle. Votre premier comportement spécifique va donc consister à vérifier que l année de sortie d un film, saisie par l utilisateur est valide, c est-à-dire antérieure au 1er janvier La génération des actions, des classes et des champs lors de la première étape a produit automatiquement des identifiants que nous avons conservés en l état jusqu à présent dans un souci de gain de temps. Cependant ces identifiants peuvent être adaptés pour une manipulation plus aisée. 0 POUR MODIFIER L IDENTIFIANT DE LA CLASSE FILM 1 Dans l arbre des classes, cliquez-droit sur la classe Film puis sélectionnez l option de menu contextuel Modifier... / Modify... La fenêtre Modifier : Classe : Film / Modify : Class : Film s affiche. 2 Remplacez l identifiant existant par : film 3 Cliquez sur Valider / Validate. 0 POUR MODIFIER L IDENTIFIANT DU CHAMP DATE DE SORTIE 1 Dans l arbre des classes, sélectionnez la classe Film. 2 Affichez l éditeur graphique. 3 Cliquez-droit sur le champ Release date puis sélectionnez l option de menu contextuel Modifier... / Modify... La fenêtre Modifier : Attribut temporel : release date / Modify : Time attribute : Release date s affiche. 4 Remplacez l identifiant existant par : film_date. 5 Cliquez sur Valider / Validate. 0 POUR AJOUTER LE CONTRÔLE DE VALIDITÉ DES DATES 1 Dans l arbre des classes, cliquez-droit sur la classe Film puis sélectionnez l option de menu contextuel Comportement de classe... / Class behavior... La fenêtre Comportement de classe / Class behavior s affiche : 23 Chapitre 4 Étape 3 (facultative) : spécialisation de l application

26 Fig 4.1 Génération d une classe de comportement 2 Cliquez sur Valider / Validate. Le fait de valider les options par défaut sur la fenêtre de création de comportement de classe génère automatiquement une classe Java - FilmClassBehavior.java - qui s ouvre dans l éditeur configuré dans les préférences. Dans cette classe, vous allez surcharger la méthode controlnewvalues(). Cette méthode est en effet appelée par Application Engine dès lors que l on crée ou modifie un objet de la classe applicative concernée (ici, un film) ; elle effectue un contrôle global des données de l objet avant validation de la création ou de la modification. La documentation complète de l API Java et des méthodes pouvant être spécialisées est disponible dans le W4 Documentation Browser. 3 Pour pouvoir manipuler les dates en Java, ajoutez les instructions suivantes en tête de fichier : import java.util.date; import java.text.dateformat; import java.text.simpledateformat; 4 Pour implémenter le contrôle sur l année de sortie des films, insérez le code suivant dans le fichier Java, en lieu et place du squelette de méthode auto-généré : public short controlnewvalues(lysetcontroller set, LyValueSet newvalues) { // Retrieve the date LyValue val = newvalues.getfieldvalue("film_date"); if ((val!= null) && (val.getvalue()!= null)) { // Get the film date Date filmdate = ((Date)val.getValue()); // Test if the film date is before 2001 DateFormat df = new SimpleDateFormat("yyyy-MM-dd"); Date limitdate = null; try {limitdate = df.parse(" ");} Application Composer Prise en main rapide 24

27 } catch (Exception e){e.printstacktrace();} if (filmdate.compareto(limitdate) > 0) { // Display error message and return an error set.showerror("la date de sortie n'est pas valide!"); return STATUS_KO; } } // Generic processing return super.controlnewvalues(set, newvalues); 5 Sauvegardez le fichier Java. 6 Compilez le fichier Java : 6.1 Dans l arbre des classes, sélectionnez la classe Film. 6.2 Affichez la fenêtre des comportements Java : sélectionnez Fenêtre / Window Comportements Java / Java classes. 6.3 Dans la fenêtre Comportements Java, sélectionnez la classe videotheque.behavior.filmclassbehavior 6.4 Cliquez sur Compiler / Compile (ou compilez le projet Eclipse correspondant). La puce préfixant la bibliothèque doit passer du rouge au vert, indiquant que la classe a été correctement compilée. 7 Relancez l application dans l afficheur de votre choix et vérifiez que le contrôle sur la date de sortie des films est bien effectué lors de la création ou de la modification d un film. Essayez maintenant de créer un film sorti au 21ème siècle! Second comportement : spécialiser la représentation graphique de certains films Vous allez maintenant utiliser une seconde classe Java pour personnaliser votre application. Vous allez créer un comportement d action pour agir sur la présentation : vous allez afficher les films sortis en 2000 en jaune dans la table des films. 0 POUR AJOUTER LE CONTRÔLE DE VALIDITÉ DES DATES 1 Dans l arbre des vues, cliquez-droit sur la classe représentant la liste des films puis sélectionnez l option de menu contextuel Comportement de l action... / Action behavior La fenêtre Comportement de l action / Action behavior s affiche. 2 Pour plus de lisibilité, remplacez le nom de classe existant par : FilmTableBehavior 3 Cliquez sur Valider / Validate. Le fait de valider les options par défaut sur la fenêtre de création de comportement d action génère automatiquement une classe Java - FilmTableBehavior.java - qui s ouvre dans l éditeur configuré dans les préférences. 25 Chapitre 4 Étape 3 (facultative) : spécialisation de l application

28 Dans cette classe, vous allez surcharger la méthode getrowcolor(). Cette méthode est appelée par Application Engine à l affichage d une ligne de la table des films pour définir la couleur à utiliser. 4 Pour pouvoir manipuler les dates en Java, rajoutez les instructions suivantes en tête de fichier : import java.util.date; import java.text.dateformat; import java.text.simpledateformat; 5 Pour implémenter le changement de couleur d une ligne, insérez le code suivant dans le fichier Java, en lieu et place du squelette de méthode auto-généré : public String getrowcolor(lysimpletablecontroller tablecontroller, LyObject object) { // Retrieve the film date LyValue val = object.getfieldvalue("film_date"); if ((val!= null) && (val.getvalue()!= null)) { Date filmdate = ((Date)val.getValue()); // Test if the film date is before 2001 and after 2000 DateFormat df = new SimpleDateFormat("yyyy-MM-dd"); Date limit1 = null, limit2 = null; try { limit1 = df.parse(" "); limit2 = df.parse(" "); } catch (Exception e){e.printstacktrace();} // Check the date to return adequate color if (filmdate.compareto(limit2) < 0 && filmdate.compareto(limit1) >= 0) return "yellow"; } // Generic processing return super.getrowcolor(tablecontroller, object); } 6 Sauvegardez le fichier Java. 7 Sélectionnez le premier nœud (celui de l application) dans l arbre des classes. 8 Compilez le fichier Java. 9 Relancez l application dans l afficheur de votre choix et vérifiez que le comportement graphique sur la table des films est bien appliqué lors de la création ou de la modification d un film pour l année Application Composer Prise en main rapide 26

29 27 Chapitre 4 Étape 3 (facultative) : spécialisation de l application

30 Chapitre 5 5 Étape 4 (facultative) : connexion à une base MySQL Jusqu'à présent, l'application a été utilisée avec des fichiers plats, c'est-à-dire que les données sont sauvegardées sur des fichiers stockés sur le disque dur de votre ordinateur, à côté de l'application. Cependant, ces données sont difficilement partageables avec d'autres personnes : pour qu elles le soient le répertoire data de l'application devrait être copié de machine en machine, aux dépens de la cohérence des données. L'utilisation d'une base de données permet de conserver la cohérence des données entre toutes les applications clientes. Nous allons maintenant créer une base de données pour l application. Nous utiliserons pour cela MySQL. Dans cet exemple nous supposons que vous disposez d un serveur de base de données MySQL installé et opérationnel. Un catalogue peut déjà exister dans la base, mais ce n'est pas nécessaire. Application Composer requiert les drivers JDBC des bases auxquelles il peut se connecter. Dans notre cas, il faut donc récupérer le connecteur JDBC pour MySQL, disponible sur : > 0 POUR AJOUTER LE DRIVER MYSQL 1 Affichez la fenêtre Comportements Java / Java classes. 2 Dans la zone Bibliothèques (Classpath) / Libraries (classpath), cliquez sur Ajouter une archive... / Add an archive... pour ajouter une archive Java dans la liste des bibliothèques utilisées. 3 Sélectionnez le fichier Jar du connecteur MySQL. Application Composer Prise en main rapide 28

31 Fig 5.1 Ajout du driver MySQL aux bibliothèques (classpath Java) 4 Cliquez sur Appliquer / Apply. 5 Sélectionnez Générer / Generate Générer / Modifier la base de données / Generate / Alter database. La fenêtre Générer / modifier la base de données / Generate / alter database s affiche. 6 Renseignez le champ Type de la base / Database type : mysql. 7 Vous allez maintenant créer une location de base de données. Il s agit d un paramétrage comportant les éléments d identification nécessaires à la connexion à une base de données. 7.1 Cliquez sur le bouton Créer données SGBDR / New RDBMS data en regard du champ Location SGBDR / RDBMS location. La fenêtre Créer : Données SGBDR / New : RDBMS data s affiche. 7.2 Renseignez l identifiant : videolibrary_db. 7.3 Renseignez le driver. Le driver correspond au nom de la classe Java d'entrée du driver JDBC. 7.4 Renseignez l URL de connexion. Cette URL dépend de la base de données et de son driver JDBC. Généralement, pour MySQL, c'est une URL de la forme jdbc:mysql://[host]:[port]/[catalogue]. 7.5 Si le catalogue fourni lors de la création de la base de données n'existe pas encore, il ne pourra être associé à l'utilisateur indiqué. Il faut donc spécifier l'identifiant et le mot de passe de l'utilisateur administrateur qui sera chargé de créer la nouvelle base et les tables nécessaires. Par mesure de précaution, il peut être utile de demander à écraser les anciennes entrées dans la base et les anciens liens avec d'autres bases dans Application Composer, cela étant laissé à l'appréciation de l'utilisateur. 7.6 Cliquez sur Valider / Validate. 8 Cliquez sur Valider / Validate. Après validation, la base de données sera créée et utilisée automatiquement par l'application. Ne pas oublier de créer et d'assigner un utilisateur aux droits restreints si la base a été créée par l'administrateur. 29 Chapitre 5 Étape 4 (facultative) : connexion à une base MySQL

32 Chapitre 6 6 Perspectives Nous venons de développer une application simple permettant de gérer une vidéothèque personnelle. Elle permet, directement en base de données, de créer des objets, de les éditer, de les consulter et d effectuer des opérations standard telles que des recherches, des tris, des filtrages, des impressions, etc. Et tout cela, en écrivant seulement du code fonctionnel (facultatif) : contrôle fonctionnel sur les données (vérification de la date de sortie d un film) et personnalisation des couleurs d une liste (mise en évidence des films de l année 2000). Cette première version opérationnelle, que l on pourrait qualifier de maquette, n utilise qu une infime partie des capacités d Application Composer. Pour aboutir à une véritable application, il faudrait poursuivre en connectant nos classes à des sources de données évoluées : annuaires LDAP, serveurs d applications, etc. et le cas échéant, ajouter un bus JMS pour bénéficier de la mise à jour en temps réel. Ensuite, nous pourrions enrichir notre modèle : ajouter de nouvelles classes applicatives (en s aidant de l import UML, via XMI, ou de la découverte d une base existante), de nouveaux comportements sur les données et de nouvelles vues plus complexes (tables complexes, vues cartographiques, vues composées, diagrammes de Gantt, tables paginées, import/export Excel, impression PDF, etc.). Enfin, l application pourrait être personnalisée en vue d obtenir la charte graphique désirée en utilisant feuilles de styles, images, couleurs, contraintes de positionnement des champs dans les vues, etc. Application Composer Prise en main rapide 30

33 31 Chapitre 6 Perspectives

34 Illustrations Application Composer au démarrage 9 Création de l application 9 Arbre des classes après la création de l application 10 Création d une classe 10 Arbre des classes après la création de la classe Catégorie 11 Aperçu de la classe dans l Editeur graphique 11 Modification d un libellé 11 Arbre des classes avant la création de la classe Film 12 Formulaire de création d'un film, dans l éditeur et aperçu dans l application finale 13 Mise à jour des propriétés pour la persistance des données 14 Exécution de l application en SWING (1/2) 15 Exécution de l application en SWING (2/2) 15 Arbre de navigation 17 Création d une action arbre dans le cadre d une action composite 18 Première action de l action composite 19 Seconde action de l action composite 19 Arbre des vues après la création de l'action composite 20 Application vidéothèque en mode web 21 Génération d une classe de comportement 24 Ajout du driver MySQL aux bibliothèques (classpath Java) 29 Application Composer Prise en main rapide 32

35 33 Illustrations

36 Index A Afficheur SWING 13 Afficheur Web 20 Ajouter une archive 28 Application Composer 7, 8 Application Engine 7 Application Suite 7 Arborescence des classes 8 Arbre de navigation 16 Arbre des vues 16 C Compiler 25 Comportements 7 Comportements Java 25 Comportements spécifiques 22 Connexion à une base 28 Créer données SGBDR 29 Créer l application 8 Créer une action composite 17 Créer une classe 10 E Editeur graphique 11 Enregistrer l application 10 Exécuter l application en mode web 20 Exécution de l application en client lourd 13 Application Composer Prise en main rapide 34

37 F Fenêtre Comportement de classe 23 Fenêtre Comportement de l action 25 Fenêtre Comportements Java 28 Fenêtre Créer Données SGBDR 29 Fenêtre Créer une action composite 17 Fenêtre Créer une classe 10 Fenêtre Nouveau Application 9 G Générer / Modifier la base de données 29 Générer l IHM par défaut 16 J JDK 14 M Model-Driven 6 Modèle de données 7, 8 O Outline 13 P Persistance des données 13 Préférences 13 Process Composer 7 Process Engine 7 S SWING Index

38 V Variable LY_SAVE_FILES 14 Application Composer Prise en main rapide 36

39 PRISE EN MAIN RAPIDE Référence: APPCOMPOSER_QUICKSTART_043_FR Pour toute remarque ou suggestion concernant ce document, vous pouvez contacter le W4 Customer Support, en précisant la référence du document : par le service de traitement des dossiers Supportflow sur MyW4.com, à l adresse : Par courrier électronique : support@w4.eu Par téléphone : +33 (0)