Spécification du profil UML d assemblage cible EJB (version 1)

Transcription

1 Spécification du profil UML d assemblage cible EJB (version 1) Auteur : Projet ACCORD (Assemblage de composants par contrats en environnement ouvert et réparti) Référence : Livrable 2.2 Date : 31 mai 2002 : Les partenaires du projet ACCORD sont CNAM, EDF R&D, ENST, ENST-Bretagne, France Telecom R&D, INRIA, LIFL et Softeam. Le projet est conjointement financé par les partenaires et par le RNTL (Réseau National des Techniques Logicielles). Projet RNTL ACCORD Page 1

2 Table des matières 1 Description générale 3 2 Le standard EJB Architecture générale Un nouveau type de Bean : Message Driven Bean Localité du Bean Conteneur, serveur et descripteur de déploiement Définition technique Paquetage UML Stéréotypes Vue externe Vue interne Tagged Values Vue externe Vue interne Contraintes structurelles Méta-modèle virtuel Vue externe Vue interne Bibliographie 13 Projet RNTL ACCORD Page 2

3 Chapitre 1 Description générale Le standard EJB propose une architecture de composants pour le développement et le déploiement d applications réparties fondées sur des composants EJB appelés beans. L objectif de ce profil UML consiste à décrire des composants conformes au modèle de composants EJB 2.0 [SUN01]. Actuellement, il existe un profil standardisé [Gre01] basé sur la spécification EJB 1.1. Ce profil est une extension d UML 1.4. Le profil que nous proposons dans ce document s appuie sur le profil existant et introduit de nouvelles extensions UML 1.4 (stéréotypes, tagged values) nécessaires pour prendre en compte les nouveautés de la spécification 2.0 des EJB. La spécification du profil suit les règles communes décrites dans [ACC02]. Projet RNTL ACCORD Page 3

4 Chapitre 2 Le standard EJB 2.0 La version 2.0 des EJB spécifie un nouveau type de Bean : le Message Driven Bean et introduit la notion de localité du Bean. 2.1 Architecture générale La fabrique d instance : pour que le client puisse accéder aux méthodes métier du bean, il doit tout d abord récupérer un accès au bean. Cela se fait par l intermédiaire de la classe EJBHome, qui renvoie une référence sur la classe EJBObject, représentant le bean correspondant ; La délégation des requêtes : le client n accède pas directement au bean. Ses requêtes doivent être envoyées à l interface du bean : la classe EJBObject qui délèguera la requête vers le bean. Les trois classes Java (EJBHome, EJBObject et Bean) sont gérées par un conteneur (Container), correspondant à l environnement d exécution du bean. Nous allons maintenant détailler les différentes catégories de bean ainsi que les autres éléments de l architecture EJB : conteneur, serveur et descripteur de déploiement. 2.2 Un nouveau type de Bean : Message Driven Bean Le standard EJB 1.1 définit trois types de bean se différentiant essentiellement par rapport à leur cycle de vie : Session Bean : ce bean n existe que pour une session demandée par le client. Deux types de bean session existent : Stateless ou sans état : le bean ne maintient pas d informations suite aux différentes requêtes qui lui sont demandées. Le Conteneur peut alors partager séquentiellement le bean entre plusieurs clients ; Statefull ou avec état : le bean conserve en mémoire l état du client. Chaque instance du bean n appartient alors qu à son client, et ne peut être partagée. Entity Bean : ce bean est une représentation de données persistantes ; il existe tant qu il n a pas été détruit explicitement. Pour récupérer un bean entité, un client peut utiliser la clé primaire du bean donnée lors de la création de ce dernier. L accès au bean peut être partagé entre plusieurs clients. Dans la version 2.0 des EJB apparaît le bean orienté message, Message-Driven Bean : ce bean est utilisé lorsque ses méthodes métiers doivent être asynchrones ; il est invoqué sur réception d un message du client, en utilisant le service JMS de Java (Java Messaging Service). Projet RNTL ACCORD Page 4

5 2.3 Localité du Bean La version 2.0 introduit également la notion de localité du bean. Cette notion ne s applique pas aux beans orientés messages, qui sont nécessairement distants. Pour les beans Remote (issus des versions EJB 1.x), le client n a pas besoin de connaître l emplacement du bean. L accès se fait obligatoirement à l aide de Java RMI. Les beans Local sont par contre situés sur la même machine virtuelle que le client (un bean peut alors, à l intérieur d un même Conteneur, faire appel à un autre bean). Une conséquence fondamentale de la notion de localité concerne le passage de paramètres lors d un appel de méthode : pour les EJB Remote, le passage se fait par valeur tandis que, pour les EJB Local, le passage se fait par référence, les arguments étant alors potentiellement partagés entre le client et le bean. La propriété Local ou Remote du bean est choisie lors de la création du bean. 2.4 Conteneur, serveur et descripteur de déploiement Le rôle principal du conteneur est de gérer les instances des différents beans. Suivant le cas, il prendra en charge un pool d instances (par exemple pour les beans sessions avec état). Le conteneur peut, de plus, proposer différents services aux beans. Le bean s exécute en fait dans un Contexte définissant les différentes propriétés du client (son identité, les différents rôles qui lui sont attribués), et l état des services mis en œuvre. L infrastructure d accueil des composants EJB comprend également une entité appelée «EJB server» - ou serveur - qui représente le logiciel support des communications et des services techniques nécessaires à l exécution du composant et à son accès par le réseau. Les deux principaux services développés dans le standard EJB 2.0 concernent la sécurité et les transactions. Un descripteur de déploiement est associé à un composant et permet de décrire ses caractéristiques. Projet RNTL ACCORD Page 5

6 Chapitre 3 Définition technique 3.1 Paquetage UML Le profil EJB 2.0 étend les paquetages UML 1.4 standards Core et Model Management. Les méta-classes suivantes du paquetage Core ont été étendues : Class type Usage Operation Abstraction Association Attribute De plus, la méta-classe du paquetage Model Management a été étendue. 3.2 Stéréotypes Nous avons conservé dans ce nouveau profil les deux vues interne et externe du profil EJB 1.1[Gre01], et repris autant que possible les stéréotypes qui y sont définis. Nous indiquons dans les tableaux ci-dessous si un nouveau stéréotype a été introduit pour couvrir de nouveaux concepts du modèle EJB 2.0[SUN01]. Le profil EJB 1.1 couvre le modèle d implémentation des EJB (avec notamment le stéréotype «EJB-JAR» pour l archive EJB) et celui de Java (caractéristiques de Java comme les exceptions ou les interfaces). Le lecteur se reportera à [Gre01] pour plus détails. La spécification EJB 2.0 introduit la notion de localité du Bean : distante (remote) ou local. Par soucis de compréhension, nous avons remplacé le terme object des stéréotypes du profil EJB 1.1[Gre01]. En particulier, dans la vue externe, le stéréotype «EJBRemoteInterface» a été renommé «EJBObjectInterface» sa localité étant spécifiée par les tagged values Remote et Local. Ces modifications apparaissent dans les tableaux ci-dessous Vue externe La vue externe représente la vue du client. Projet RNTL ACCORD Page 6

7 Stéréotype s applique à Définition «EJBCreateMethod» Operation Indique que l opération représente une méthode EBJ create. «EJBFinderMethod» Operation Indique que l opération représente une méthode EBJ Finder. «EJBObjectMethod» Operation Spécialise «EJBHomeMethod». Indique que l opération représente une méthode EBJ Remote. EJB 2.0 «EJBObjectInterface» Class Spécialise le stéréotype UML «type». Indique que la classe UML représente une interface EBJ Object. Correspond dans le profil [?] à EJBRemoteInterface qui peut être Remote ou Local dans EJB 2.0 EJB 2.0 «EJBMessageDestination» Class Spécialise le stéréotype UML «type». Indique que la classe UML représente une interface EBJ Message Driven. «EJBHomeInterface» Class Stéréotype abstrait qui spécialise le stéréotype UML «type». Indique que la classe UML représente une interface EBJ Home. «EJBSessionHomeInterface» Class Spécialise «EJBHomeInterface». Indique que la classe UML représente l interface EBJ Home d un Bean Session. «EJBEntityHomeInterface» Class Spécialise «EJBHomeInterface». Indique que la classe UML représente l interface EBJ Home d un Bean Entity. «EJBPrimaryKey» Usage Définit la clé primaire associée à l EJB Entity Vue interne La vue interne représente la vue du conteneur. On y trouvera essentiellement les propriétés du bean. Projet RNTL ACCORD Page 7

8 Stéréotype s applique à Définition «EJBCmpField» Attribute Indique que l attribut représente un champ géré par le conteneur (pour un EJB Entity dont la persistance est gérée par le conteneur). «EJBPrimaryKeyField» Attribute Spécialise «EJBCmpField». Indique que l attribut est la clé primaire pour un EJB Entity dont la persistance est gérée par le conteneur. «EJBRealizeHome» Abstraction Définit le lien Bean-Home. EJB 2.0 «EJBRealizeObject» Abstraction Définit le lien Bean-Remote. Correspond à EJ- BRealizeRemote dans le profil [?]. EJB 2.0 «EJBRealizeDestination» Abstraction Définit le lien Bean-MessageDestination. «EJBImplementation» Class Spécialise le stéréotype UML «implementationclass». Indique que la classe décrit l implémentation du Bean. «EJBEnterpriseBean» Stéréotype abstrait qui indique que le soussystème représente un composant EJB. «EJBSessionBean» Spécialise «EJBEnterpriseBean». Indique que le sous-système représente un composant EJB de type Session. «EJBEntityBean» Spécialise «EJBEnterpriseBean». Indique que le sous-système représente un composant EJB de type Entity. EJB 2.0 «EJBMessageDrivenBean» Spécialise «EJBEnterpriseBean». Indique que le sous-système représente un composant EJB de type Message Driven. «EJBReference» Association Indique que la partie finale d une navigation dans une association représente un composant EJB référencé. «EJBAccess» Association Indique que l association définit une relation de rôle de sécurité entre un acteur et un «EJBEnterpriseBean». EJB 2.0 «EJBOnMessage» Operation Indique que l opération représente la méthode onmessage d un EJB Message Driven. Projet RNTL ACCORD Page 8

9 3.3 Tagged Values Nous avons repris autant que possible les tagged values définies dans [Gre01]. Nous indiquons dans les tableaux ci-dessous toute modification et tout apport au profil [Gre01] pour le support des EJB Vue externe EJB Vue interne EJB 2.0 EJB 2.0 Tagged Value s applique à Définition EJBSessionType Class «EJBSessionHomeInterface» Indique le type de Bean Session : Statefull ou Stateless. EJBLocalityType Class Indique si le Bean est Local ou distant «EJBSessionHomeInterface» (Remote). «EJBSessionObjectInterface» Tagged Value s applique à Définition EJBRoleNames Operation Liste de rôles de sécurité pouvant invoquer l opération. Liste de chaine de caractères (Strings) séparées par des virgules. EJBTransAttribute Operation Définit la politique utilisée pour la transaction : énumération de Not Supported, Supports, Required, RequiresNew, Mandatory, Naver. EJBEnvEntries EJBNameInJAR EJBReferences EJBResources EJBSecurityRoles EJBTransType EJBPersistenceType EJBReentrant EJBLocalityType «EJBEnterpriseBean» «EJBEnterpriseBean» «EJBEnterpriseBean» «EJBEnterpriseBean» «EJBEnterpriseBean» «EJBSessionBean» «EJBMessageDrivenBean» «EJBEntityBean» «EJBEntityBean» «EJBEntityBean» «EJBSessionBean» Interactions avec l environnement : liste de triplets <nom, type, valeur>, séparés par des virgules. Nom du composant EJB dans l «EJB- JAR». Autres composants EJB référencés par le composant courant : liste de quadruplets <nom, type, home, remote>, séparés par des virgules. Ressources utilisés par le composant EJB : liste de triplets <nom, type, auth(entification?)>, séparés par des virgules. Noms de rôles qui peuvent invoquer toutes les opérations du composant : liste de couples <nom, lien(link)>, séparés par des virgules. Indique qui va gérer la transaction : Bean ou Container. Indique qui va gérer la persistance : Bean ou Container. Valeur booléenne indiquant si le Bean est ré-entrant ou non. Indique si le Bean est Local ou distant (Remote). Projet RNTL ACCORD Page 9

10 3.4 Contraintes structurelles Les contraintes structurelles du profil [Gre01] ont été conservées. Nous rajoutons les contraintes suivantes, portant sur la cohérence entre le modèle externe et le modèle interne, pour les nouveaux stéréotypes et tagged values : Pour le bean concerné, EJBLocalityType doit avoir la même valeur entre le modèle externe et le modèle interne ; Le stéréotype «EJBOnMessage» ne peut apparaître que dans un modèle représentant un bean Message- Driven. Soit le sous-système auquel la classe de l opération appartient est stéréotypé «EJBMessageDrivenBean» ; Dans un sous-système stéréotypé «EJBMessageDrivenBean», la classe stéréotypée «EJBImplementation» doit avoir les propriétés suivantes : elle est une abstraction stéréotypée «EJBRealizeDestination» de la classe stéréotypée «EJBMessageDestination» ; ne comporte qu une opération stéréotypée «EJBOnMessage». 3.5 Méta-modèle virtuel Vue externe Voir figure 3.1 page suivante Vue interne Voir figure 3.2 page 12. Projet RNTL ACCORD Page 10

11 Class type (from Standard Elements) EJBMessageDestination EJBHomeInterface <<TaggedValue>> EJBLocalityType : ( Local, Remote ) EJBObjectInterface <<TaggedValue>> EJBLocalityType : ( Local, Remote ) EJBSessionHomeInterface EJBEntityHomeInterface <<TaggedValue>> EJBSessionType : ( Stateful, Stateless ) Operation Dependency Usage EJBFinderMethod EJBCreateMethod EJBObjectMethod EJBPrimaryKey FIG. 3.1 Méta modèle virtuel : vue externe Projet RNTL ACCORD Page 11

12 (from Model Management) EJBEnterpriseBean <<TaggedValue>> EJBEnvEntries [0..*] : < name : String, type : String, value : String > <<TaggedValue>> EJBNameInJAR : String <<TaggedValue>> EJBReferences [0..*] : < name : String, type : String, home : String, remote : String > <<TaggedValue>> EJBResources [0..*] : < name : String, type : String, auth : String > <<TaggedValue>> EJBSecurityRoles [0..*] : < name : String, link : String > EJBSessionBean <<TaggedValue>> EJBTransType : ( Bean, Container ) <<TaggedValue>> EJBLocalityType : ( Local, Remote ) EJBEntityBean <<TaggedValue>> EJBPersistenceType : ( Bean, Container ) <<TaggedValue>> EJBReentrant : Boolean <<TaggedValue>> EJBLocalityType : ( Local, Remote ) Class EJBMessageDrivenBean <<TaggedValue>> EJBTransType : ( Bean, Container ) Attribute implementationclass (from Standard Elements) Dependency EJBCmpField EJBImplementation Abstraction Usage EJBPrimaryKeyField EJBRealizeDestination EJBRealizeObject EJBRealizeHome EJBReference Operation Association <<TaggedValue>> EJBRoleNames [1..*] : String EJBTransAttribute : ( NotSupported, Supports, Required ) RequiresNew, Mandatory, Never ) EJBonMessage EJBAccess FIG. 3.2 Méta modèle virtuel : vue interne Projet RNTL ACCORD Page 12

13 Bibliographie [ACC02] ACCORD. Conventions communes aux profils UML. Technical report, Projet RNTL ACCORD, Livrable 2.1, [Gre01] Jack Greenfield. UML profile for EJB. Technical report, Rational Software Corpotation, Mai [SUN01] SUN. Enterprise JavaBeans Specification, Version 2.0. Sun Microsystems, Aout Projet RNTL ACCORD Page 13