Configuration Interface for MEssage ROuting

Transcription

1 ConfigurationInterfaceforMEssageROuting Date:21/05/07 Version:0.3 Statut:diffusable Auteurs: 1/22 BAGNARDNatacha FOROTJulien

2 Tabledesrévisions Version Date Modifications /04/07 Créationdudocument /05/07 Modificationdudocumentsuiteàunerelectureinformellede JérômeCamilleri /07/07 Modificationssuiteaudéveloppementdel'application 2/22

3 Table des matières 1.Introduction Butdudocument Portéedudocument Organisationdudocument Priseencomptedesfacteursqualitéattendus Rappeldesfacteursattendus Applicationdestactiques Maintenabilité Portabilité LeframeworkGMF Modèledesdonnées,EMF Présentation,GEF Mapping Outilsutilisés JET JDOM Architecture Vuelogique Architecturedel'éditeurgénéréparGMF Modèlededonnées Présentation Validateur Contrôleur Générateurdemodèle Coordinateur Générateurdepackage ImportateurdefichierCimero Monitoring ServiceMix Vuephysique Définitiondescénarios /22

4 5.3.1.Chargerungraphe Sauvegarderungraphe Créerungraphe DémarrerServiceMix ArrêterServiceMix CréerunpackageJBI DéployerunpackageJBI MigrerunfichierdeCimero1versCimero Ajouteruncomposant Éditeruncomposant GénérerunetâcheAntpourunflux Monitorerunflux Utiliseruncomposant Supprimeruncomposant Ajouterunlienentre2composants Supprimerunlienentre2composants Modifierlespropriétésd'uncomposant /22

5 1.Introduction 1.1.But du document CedocumentdéfinitlaconceptionglobaleduprojetCIMERO. Ce document suit la phase despécifications externes et a pour but d exposerles choix d architectureretenus.lesaspectssuivantssonttraités: Vuelogique:Représentationdetouslescomposantsdel applicationetdeleurs interactions. Vuephysique:Cettevuemontrecommentlesélémentsdelavuelogiquesont allouésàdesplate formesd exécution. Vuedynamique:Vuepermettantdemodéliserlasuccessiondesactivitésetla naturedesinteractionsentrelesdifférentsmodules. Leslangagesetframeworksdeprogrammationutiliséssontégalementspécifiésainsique l'architectureutiliséepourl'interfacegraphique. 1.2.Portée du document Cedocumentserviradebaseàlaconceptionetaudéveloppementduproduitàlivrer. Cedocumentestdestiné: auresponsabledustage,jérômecamilleri àlaconsultante:martinetasset aujurydumaster2progipourl'évaluationdustage àl'équipeprojet:natachabagnardetjulienforot 1.3.Organisation du document Lasuitedecedocumentdonneunevuegénéraledel'architecturelogiciellequifaitl'objetde cetravail. Leparagraphe2rappellelesfacteursqualitésattenduspourcelogicieletexpliquecomment mettreenoeuvredestechniquespouratteindrecesfacteurs. Le paragraphe 3 décrit le fonctionnement du framework GMF et sa place dans le développementdecimero. Leparagraphe4détaillelesdifférentesvuesarchitecturales(diagrammedecontexte,vue logique,diagrammesdeséquence). 5/22

6 2.Prise en compte des facteurs qualité attendus 2.1.Rappel des facteurs attendus LePAQL1définitdeuxexigencesnonfonctionnellesquidevrontêtrevalidées: Maintenabilité:Aptitudedulogicielàpouvoirêtrecorrigéfacilement. Portabilité : Aptitude du logiciel à être transféré d'un matériel et/ou d'un environnementlogicielàunautre. 2.2.Application des tactiques Lestactiquesdeconceptionarchitecturalespermettentdedéfinirunensemblederèglesde bonne conduite pour tendre vers les exigences non fonctionnelles requises du logiciel. Nous présenteronscesrèglesenfonctiondesfacteursdequalité.ledéveloppementdulogicieldevra s'appuyer sur ces règles. Nous présenterons ci dessous 2 tactiques pour tendre vers un logiciel maintenableetunepourlaportabilitéenexpliquantcommentlesappliqueràceprojet Maintenabilité Localiser les modifications Les composants d'un même module doivent avoir une forte cohésion. Ceci permet une recherche efficacedes modules à modifier et limite leur nombre. Le nombre de composants à modifierpourlesévolutionslesplusprobablesdoitêtreminimales.ilfaudradonctenircomptedes évolutionscommelesupportdenouveauxesb.lescomposantsdevrontêtreleplusgénérique possible. Éviter les effets de bord L'utilisationdedonnéesprivées(accessiblesuniquementparuncomposant)etladéfinition d'interface permet d'isoler les modifications au niveau des données privées tout en conservant l'interface.lescomposantseninteractionaveclecomposantmodifiéviauneinterfacen'aurontdonc pasbesoind'êtremodifiés.lescomposantsdoiventêtreleplusfaiblementcoupléspossibleentre eux,lenombredecommunicationsdevradoncêtrelimitéetcelles ciserontdescommunications parvaleur Portabilité Utiliser une couche d'abstraction Si l'appel de fonctions est spécifique à un OS ou à un programme dont on veut être indépendant,ilseranécessairedeprévoiruncomposantspécifiqueàcetosouceprogrammeou 1 Voirsection10.1duPlanAssuranceQualiteLogicielle.odt 6/22

7 danslecasd'unelistelimitéedeprévoirtoutlescas. 3.Le framework GMF L'éditeurCIMEROestconstruitgrâceauframeworkGMFsurlabased'unéditeursimple permettantdecréerdesgraphescontenantdescomposantsgénériquesreliésentreeux.ilestensuite modifié manuellement pour proposer dans la palette les différents composants basés sur le composantgénérique. GMF permetdeconstruirelemodèlededonnées,lemodèlegraphiqueetdedéfinirun mappingentrecesmodèles,puisdegénérerlecodedel'éditeur.gmfproposeunoutilpermettant defacilementenchaînerlesétapesdelacréationdesmodèles,puisdumappingetenfindumodèle global:ledashboard.lorsquetouteslesétapessontterminéesetquelemodèleglobalàétégénéré, ilestpossibledegénérerlecodedel'éditeuretdeletester.lesétapesdoivents'enchaînerensuivant lanumérotationindiquéesurleschéma. Illustration1 :DashboarddeGMF 3.1.Modèle des données, EMF GMFutiliseleframeworkEMFpourgénérerlecodedelagestiondumodèle. Lemodèlepeutêtredécritde4manièresdifférentes:GrâceàunschémaUML,grâceàdes classesjavaannotées,grâceàunmodèleroseougrâceàunxmlschéma.laméthodechoisieest lacréationdumodèleenumlviaunfichierecore_diagramquipeutêtrecréédanseclipsegrâceau frameworkgmf. Ladescriptiondumodèlepermetdegénérerunfichierecoreetunfichiergenmodel.Ceux ci permettentlagénérationducodedumodèleainsiquesonparamétrage.desmécanismespourla manipulationdumodèlesontégalementfournisviaunaffichagespécifiqueplusfacileàmanipuler quelaversiontexte. 7/22

8 UML Annoted Java Rose class model.genmodel X EMF XML Schema.ecore Définition du modèle X Fichier généré Choix exclusif Illustration2 :FonctionnementsimplifiédeEMF GMF génère les classes Java correspondant à chacune des classes UML du fichier ecore_diagram,ainsiquedesfabriquespermettantdecréerdesinstancesdesclassesdumodèles. 3.2.Présentation, GEF GMFutiliseleframeworkGEFpourgénérerlecodedelapartiegraphiquedel'éditeur. Le framework GEFpermetdegénérerlecodedelareprésentationgraphiquegrâceàla définitiond'unmodèle.cesreprésentationsgraphiquessontfaitesgrâceauframeworkdraw2d. Lemodèleestdécritdans2fichiers:Unfichiergmfgraphquipréciselesfiguresutilisées danslegrapheetunfichiergmftoolquipréciselesélémentsutilisésdansl'éditeurcommelapalette, lesmenus... Desmécanismespourlamanipulationdumodèlesontégalementfournisviaunaffichage spécifiqueplusfacileàmanipulerquelesversionstexte. 3.3.Mapping Unefoislemodèlededonnéesetlemodèlegraphiquecréé,GMFpermetdefairelemapping entreeuxdemanièresimplifiée,grâceaufichiergmfmap. Lesliensentrelesentitésdumodèlededonnées,l'outilassociédanslapaletteetlafigure danslegrapheestdéfinieàcetteétape.commeparexemple,lelienentrel'imagereprésentantle composant,l'outildelapalette«ajouterunnouveaucomposant»etl'entité«component».ceci permetensuitedepouvoirutiliserl'outil«ajouterunnouveaucomposant»pourajouterdesimages decomposantsdanslazonededessindel'éditeur.chacunedecesimagesestliéeeninterneàune instancedel'entité«component». Le fichier gmfmap permet aussi de définir des contraintes OCL sur les éléments du diagramme.cescontraintespeuventêtreexpriméesdansplusieurslangages,dontlelanagageocl. Ilexiste2typesdecontraintes: 8/22

9 Lescontraintessurlesliensentrelescomposants(LinkConstraint) Lescontraintessurlesélémentsdudiagram(AuditRule) Desmécanismespourlamanipulationdumappingsontégalementfournisviaunaffichage spécifiqueplusfacileàmanipulerquelaversiontexte. 4.Outils utilisés 4.1.JET LepluginCIMEROpermet,commecelaestindiquédanslecahierdescharges,degénérerà partirdel'instanciationd'unmodèleuneconfigurationpourservicemix. Cependant,beaucoupdepartiesdesfichiersgénérésquiserontcrééssurcemodèleseront similaires.eneffet,lorsqu'unnouveaucomposantdumodèlecimeroestcréé(ftpparexemple)le codesourcequiluiestassociéesttoujourslemême,seuleslesvaleursdespropriétésdécrivantce composant varient. Créer un code distinct pour chacun de ces points spécifiques rendrait le développementdel'applicationcomplexeetinadaptédansuneoptiquedemaintenabilité. LeframeworkJETproposedecréerdesfichiers«templates»permettantderésoudrece problème.ilpermetd'écrirefacilementdestemplatesgrâceàunesyntaxeprochedujsp.c'estun générateurdefichiergénériquequipeutêtreutiliséaussibienpourécriredesfichierssql,xml, Java,etc...CeframeworkestdoncutilisédanslepluginCIMEROafindecréerlesfichiersXMLde configuration. Unfichier«template»deJETseprésentecommesuit: <%ListelementList=(List)argument;%> <?xmlversion="1.0"encoding="utf 8"?> <demo> <%for(iteratori=elementlist.iterator();i.hasnext();){%> <element><%=i.next().tostring()%></element> <%}%> </demo> Figure1:Exemplede«template»JET Le fichier JAVA permettant d'invoquer letemplateet degénérerunfichierxml est le suivant: 9/22

10 Listdata=newArrayList(); data.add("first"); data.add("second"); data.add("third"); XMLDemoTemplategenerateXml=newXMLDemoTemplate(); Stringresult=generateXml.generate(data); System.out.println(result); Figure2:ClasseJAVAassociéeàl'exempleJET LerésultatobtenuestlefichierXMLsuivant: <?xmlversion="1.0"encoding="utf 8"?> <demo> <element>first</element> <element>second</element> <element>third</element> </demo> Figure3:ClasseJAVAassociéeàl'exempleJET L'utilisationdeceframeworkpermetderendrelecodeplusclairetrentreainsidansune optiquedequalitécommespécifiédansledocument:plandequalitélogiciel. 4.2.JDOM JDOMestuneAPIfacilitantlamanipulationdedocumentsXML.Ellepermetdereprésenter sousformed'arbreundocumentxmlafindelerendreplusfacileàlire,écrireetmanipuler.jdom s'appuie sur des parsers tels Xerces ou Crimson pour construire un tel arbre. Elle fournit un ensembledeméthodespermettantd'éditerfacilementetefficacementdesdocumentsxml.jdom aétéspécialementdéveloppépourjavaetdansleparadigmeobjet. L'utilisationdecetAPIpermettradefaciliterlesécrituresetlecturesdesdifférentsfichiers XMLquiserontutiliséspourstockerlesdonnéesduplugin. 10/22

11 5.Architecture 5.1.Vue logique Voicilavuelogiquedel'application: Illustration3 :Vuelogique Architecture de l'éditeur généré par GMF LeséditeursgénérésparGMFsontbaséssurunearchitectureMVC.Lesmodules«modèle de données» et «présentation» sont générés par GMF et donc modifiables. Le module «contrôleur»nel'estpas. 11/22

12 5.1.2.Modèle de données Lemodule«modèlededonnées»gèrelesinformationsnongraphiquesdel'éditeur. Lors de l'ouverture d'un fichier d'extension «.cimero2» ou du chargement du plugin CIMERO,lesinformationscontenuesdanscefichiersontinterprétéessouslaformedumodèle CIMEROetpermettentdecréerdesinstancesdumodèle. LemodèlededonnéescontientlesclassesJavadesdifférentscomposantsdel'éditeurainsi quedesfabriquespermettantdecréeretgérercesinstances Présentation Lerôledecemoduleconsisteàafficherlesinformationscontenuesdanslemodule«modèle dedonnées»souslaformed'ungrapheetàmettreàdispositiondanslapalettelescomposants disponibleslorsdel'ouvertured'unfichierd'extension«.cimero2»oulorsdesacréation. Cemodulecontientunebasedefigures.UnefigureestuneclasseJAVAutiliséepar le framework«draw2d»permettantd'affichergraphiquementdesélémentsdanseclipse.cemodule contientdoncunefigurepourchaqueinstancedecomposantoudeliendumodèle.le mapping entrelemodèleetl'affichageestfacilitéparleframeworkgmf,quiaétéprésentédanslasection 3.3decedocument.Lesfigurespeuventêtrereliéesentreellesparuneouplusieursflèches La représentation graphique de ces figures est décrite dans le dossier de spécifications externes Validateur Le modulevalidateurpermetdevérifierquelegrapheest correct.les contraintes sont expriméessousformesdecontraintesocl.ellesassurentque: Toutes les propriétés nécessaires à la génération d'un package JBI pour ServiceMixsontspécifiées. Legrapheestcorrect Contrôleur Le module «Contrôleur» gère les sauvegardes, chargements, fermetures de fichiers, l'évaluationdecontraintes.cemoduleseprésentesouslaformed'unelibrairie:legmfruntime. Lecoden'estpasaccessiblenimodifiableparledéveloppeur Générateur de modèle Cemodulegèrelescomposantsdisponibles.Cescomposantssontdécritssousformede fichiersxml,etsontplacésdansundossierspécifique.legénérateurdemodèlepossède2parties: 1 Voirsection3.3duDossierSpecificationsExternes.odt 12/22

13 unparserxml,quipermetderécupérerlesinformationscontenuesdanschaque ficherxmletquipourchacund'entreeuxappellelafonctiond'instanciation d'uncomposantgénérique. uncréateurdefichierxml,quirécupèrelesinformationssaisiesparl'utilisateur, construitlefichierxmlcorrespondantetl'enregistredansledossierapproprié Coordinateur Tous les échanges entre modules passent par le coordinateur, il ordonnance toutes les communications.seullemoduleservicemix,décritplusloin,n'utilisepaslecontrôleur Générateur de package Cemoduleestutilisépourgénérerl'arborescencecontenantlesdescripteursdupackageetla tâche Ant, ainsi qu'un package JBI pour ServiceMix. La génération est effectuée à partir des donnéescontenuesdanslemodule«modèlededonnées».lemoduledegénérationvérified'abord quelegrapheestvalideavantd'effectuerlagénération.silavalidationestcorrecte,cemodule récupèrel'instancedumodèleetgénèrelaconfigurationpourservicemixbaséesurcesdonnées.ce moduleestleseulmoduledépendantdel'esb.poursupporterd'autresesb,ilfaudradévelopperun nouveaumoduledegénérationdepackage. Lemodulecomprendaussil'importationdespackagesJBI.LespackagesJBIsontlusparun parserquiessaiederemplirlemodèlededonnées,aveclesinformationsdupackagejbi.lagestion deserreurs(packagenonconforme)estessentielledanscemodule Importateur de fichier Cimero1 Cemoduled'importationpermetàl'utilisateurd'importerlesgraphescréésparlaversion1 decimeroviadesfichiersxmlintermédiaires.lesinformationscontenuesdanslefichierxml sonttraduitesenformatcimero2,c'estàdireparun.cimero2etun.cimero2_diagram.legraphe devientéditableparcimero Monitoring Cemodulepermetdemonitorerunflux,danslebutdeletester.Ilestcomposéd'unepartie pourlarécupérationetletraitementdedonnéesrecueilliespardeslistenersplacédansl'esb,etune partiepourl'affichagedurésultatdestraitements,trèsliéeaumoduleprésentationdel'éditeur ServiceMix Lemodule«ServiceMix»estindépendantdesautresmodules.Ilestutilisépourdémarrer ouarrêterservicemix,viaeclipse.cemoduleadéjàétédéveloppéetdétaillédanslecadrede CIMEROVersion1.Néanmoins,unerepriseducodeafindel'adapteraumieuxàlaversionactuelle deservicemixestnécessaire. 13/22

14 5.2.Vue physique Lepluginestdéployésuruneseulemachine,unPC.L'IDEEclipse3.2ouuneversion supérieuredoitêtreinstallé. 5.3.Définition de scénarios Lesdiagrammesdeséquencesuivantsreprésententlescasd'utilisationsdécritsdansle dossierdespécificationsexternes Charger un graphe Illustration4 :Chargerungraphe 1 Voirsection2duDossierSpecificationsExternes.odt 14/22

15 5.3.2.Sauvegarder un graphe Illustration5 :Sauvegarderungraphe Créer un graphe Illustration6 :Créerungraphe 15/22

16 5.3.4.Démarrer ServiceMix Illustration7 :DémarrerServiceMix Arrêter ServiceMix Illustration8 :ArrêterServiceMix 16/22

17 5.3.6.Créer un package JBI Illustration9 :CréerunpackageJBI Déployer un package JBI Illustration10 :DéployerunpackageJBI 17/22

18 5.3.8.Migrer un fichier de Cimero1 vers Cimero2 Illustration11 :ImporterunpackageJBI Ajouter un composant Illustration12 :Ajouteruncomposant 18/22

19 Éditer un composant Illustration13 :Éditeruncomposant Générer une tâche Ant pour un flux Illustration14 :GénérerunetâcheAntpourunflux 19/22

20 Monitorer un flux Illustration15 :Monitorerunflux Utiliser un composant Illustration16 :Utiliseruncomposant 20/22

21 Supprimer un composant Illustration17 :Supprimeruncomposant Ajouter un lien entre 2 composants Illustration18 :Ajouterunlienentre2composants 21/22

22 Supprimer un lien entre 2 composants Illustration19 :Supprimerunlienentre2composants Modifier les propriétés d'un composant Illustration20 :Modifierlespropriétésd'uncomposant 22/22