Tutorial - Mia

MIA - Generation – Manuel de l'utilisateur
- Tutorial -

MIA - Generation - Tutorial Table des matières i
Table des matières
TUTORIAL ................................................................................................................................................................ .1
P RESENTATION ........................................................................................................................................................... 1
P REMIERE GENERATION J AVA .................................................................................................................................... 2
Création du projet de génération .......................................................................................................................... 3
Création d'un package ........................................................................................................................................... 4
Ecriture d'un file template ..................................................................................................................................... 5
Sauvegarde d'un script et de son package ............................................................................................................. 8
Chargement d'un modè le ....................................................................................................................................... 9
Importer un modèle depuis un AGL ...................................................................................................................................... 9
Test d'un file template ..........................................................................................................................................12
Création d'une génération unitaire .......................................................................................................................................12
Sélection des objets source pour les tests ............................................................................................................................14
Génération d'un file template ...............................................................................................................................................17
Propriété Filename d'un File Template ................................................................................................................................19
A MELIORATION DE LA GE NERATION J AVA ...............................................................................................................20
Génération de l'héritage ......................................................................................................................................20
Création d'un service superClasses ......................................................................................................................................20
Correspondance entre les propriétés du méta - modèle et les scripts "System" .....................................................................23
Création d'une macro superClassName ...............................................................................................................................25
Appel à la macro s uperClassName ......................................................................................................................................26
Génération avec trace ..........................................................................................................................................................27
Génération des attributs ......................................................................................................................................29
Ajout d'un template de déclaration d'un attribut ..................................................................................................................29
Ajout d'un template de génération d'accesseurs ...................................................................................................................31
Génération des attributs depuis la classe .............................................................................................................................33
Création d'une macro avec paramètre ..................................................................................................................................36
Appel d'un script avec paramètre depuis un script Java ......................................................................................................38
Appel des scripts avec paramètres depuis les templates ......................................................................................................39
Gestion du code utilisateur ..................................................................................................................................40
Résolution des noms de fichiers générés .............................................................................................................................44
G ENERATION PAR SCENAR IO ....................................................................................................................................47
Création et exécution d'un scénario ....................................................................................................................47
Utilisation des services dans les scénarios ..........................................................................................................50
Explorer tous les packages d'un modèle UML ....................................................................................................................50
Appel du service allClass es dans un scénario ......................................................................................................................52
P ROGRAMMATION AVANCEE ....................................................................................................................................53
Gestion des stéréotypes .......................................................................................................................................53
Utilisation des profils ..........................................................................................................................................60
Création d'un profil ..............................................................................................................................................................61
Création de scripts sur des types du profil ...........................................................................................................................62
Refactoring des scripts .........................................................................................................................................................62
Prise en compte des règles de codage, patterns et frameworks ...........................................................................67
Règles de codage et de patterns ...........................................................................................................................................67
Prise en compte d'un framework ..........................................................................................................................................73
Utilisation des composants J2SE dans les scripts ...............................................................................................75
La variable context ..............................................................................................................................................77
Javadoc de MIA - Generation ...............................................................................................................................80

MIA - Generation Tutorial 1
Cette documentation est la propriété de Mia - Software.
Elle ne peut être reproduite, même partiellement, sous quelque forme que ce soit, sans autorisation écrite préalable.
Tutorial
Présentation
Le but de ce tutorial n'est pas de présenter l'ensemble des fonctionnalités de MIA - Generation , mais
de vous familiariser avec cet environnement de travail, et de vous faire découvrir à l'aide d'un
simple exemple de génération de code Java les principes de base de la génération avec MIA -
Generation .
Les exemples présentés dans ce tutorial repose sur l'utilisation de MIA - Generation . Tous les scripts
définis au cours de ce tutorial sont disponibles dans différents projets Tutorial, situés dans le
répertoire :
<MIA-Generation>\metamodels\UML\examples\generators
Le projet "Tutorial (scenario generation).prj" vous permet de charger les scripts et
scénarios de la génération Java™ jusqu'au chapitre "Génération par scénario". Les scripts du
chapi tre "Programmation avancée" sont accessibles avec les projets "Tutorial (with
stereotype).prj", "Tutorial (with profile).prj", "Tutorial (with profile and
pattern).prj ".
Toutes les notions abordés dans ce tutorial sont détaillées dans le manuel de l'utili sateur MIA -
Generation . Une FAQ technique complète également le manuel et ce tutorial pour répondre aux
questions les plus fréquemment posées lors d'un développement de générateur.

MIA - Generation Tutorial 2
Cette documentation est la propriété de Mia - Software.
Elle ne peut être reproduite, même partiellement, sous quelque forme que ce soit, sans autorisation écrite préalable.
Première génération Java
Lancez MIA -Generation Architect à l'aide du menu Windows "Démarrer". MIA -Generation Architect est
l'application qui va vous permettre de construire un générateur sur mesure pour un contexte donné.
Ce générateur est packagé sous la forme d'un projet de génération.
Figure 1 - M IA - Generation Architect
MIA - Generation Architect p ropose deux vues principales :
- une vue Edition dans laquelle vous allez pouvoir concevoir votre générateur, c'est-à-dire éditer
votre projet de génération,
- une vue Generation dans laquelle vous allez pouvoir exécuter votre générateur et visualiser les
résultats de génération.

MIA - Generation Tutorial 3
Cette documentation est la propriété de Mia - Software.
Elle ne peut être reproduite, même partiellement, sous quelque forme que ce soit, sans autorisation écrite préalable.
Création du projet de génération
Un projet de génération regroupe un ensemble de scripts qui réalisent une génération. Ces scripts
sont organisés au sein de packages et de scéna rios. Les scripts permettent de décrire comment du
texte peut être généré à partir des objets du modèle. Un projet définit ainsi un générateur, basé sur
l'utilisation d'un méta-modèle, sans être lié à tel ou tel modèle physique. C'est une évaluation du
gé nérateur qui fera appel à des modèles physiques pour son exécution.
Par défaut, un projet Default est présent dans l'environnement. Commencons par créer un nouveau
projet de génération. Depuis le menu contextuel du navigateur de projet, vous pouvez renommer le
projet Default existant ou en créer un nouveau avec New > Project :
Figure 2 - Création d'un projet de génération
Si vous cliquez sur New puis l'item , une boîte de dialogue apparaît vous demandant de
saisir le nom de vot re projet, par exemple Tutorial . Validez le nom saisi avec le bouton OK.
Figure 3 - Saisie du nom d'un projet
Le projet Tutorial doît être visible dans le navigateur sur la gauche de l'écran.