Avant de commencer, vous devez d'abord terminer l'exercice 1.2 : Préparation de l'espace de travail.
L'exercice 1.3 vous aide à créer des beans entity à partir d'un diagramme de classes UML. Dans cet exercice, vous procéderez aux tâches suivantes :
Dans ce scénario, vous allez créer deux beans entity : Author et Book. Le bean Author représente une table de base de données, également nommée AUTHOR. Le bean contient des champs représentant l'auteur : ID, nom, âge et sexe. Ces champs correspondent directement à des colonnes de la table AUTHOR.
Le bean Book représente un ouvrage. Ses champs incluent un ID et un titre. Les données correspondant au bean Book sont stockées dans la table BOOK.
Pour créer le bean Author, suivez les étapes suivantes :
Bean entity CMP
2.x
apparaît au milieu de la liste.
Bean entity CMP 2.x
pour afficher davantage de choix. L'autre choix affiché est Bean entity CMP 1.x
.
Bean entity CMP 2.x
.
Les beans EJB étant complexes, cette action lance l'assistant de création d'un bean enterprise, qui vous permet de définir le bean.
Sur la première page de l'assistant, suivez les étapes suivantes :
UML EJB tutorial
.Author
ejbModule
.sample
2.x
.Sur la seconde page de l'assistant, suivez les étapes suivantes :
sample.AuthorBean
.sample.AuthorLocalHome
.sample.AuthorLocal
.java.lang.Integer
.id
figure dans la liste des attributs CMP.nom
avec le type java.lang.String
.
Laissez les cases à cocher Tableau et Zone de clé décochées et la case à cocher Promouvoir les méthodes getter et setter dans l'interface locale sélectionnée.
Lorsque les méthodes getter et setter sont promues dans l'interface locale, elles sont proposées aux applications client. âge
avec le type java.lang.Integer
.
Laissez les cases à cocher Tableau et Zone de clé décochées et la case à cocher Promouvoir les méthodes getter et setter dans l'interface locale sélectionnée.Votre premier bean entity est créé et visualisé dans le diagramme de classes. Les fichiers suivants s'affichent dans la vue Explorateur de projets :
Ouvrez le descripteur de déploiement de beans EJB. Vous constatez que sur la page Généralités, sous le titre Enterprise JavaBeans, le bean Author est répertorié. Cliquez sur l'entrée du bean Author. La page Bean de l'éditeur de descripteur de déploiement s'ouvre : elle affiche les trois champs CMP et les quatre fichiers de classe et d'interface, y compris la classe utilisée par la clé principale, java.lang.Integer.
Sur la page Bean, sous le titre Liaisons WebSphere, le nom JNDI ejb/sample/AuthorLocalHome
apparaît. Ce nom est utilisé lorsqu'une application client recherche le bean.
Dans la vue Explorateur de projets, sous le projet EJB, le répertoire ejbModule
> META-INF contient le nouveau fichier ibm-ejb-jar-bnd.xmi
.
Ce fichier fournit des informations de liaison spécifiques à IBM. Ces
informations sont accessibles via l'éditeur de descripteur de déploiement mais, les valeurs sont stockées dans un fichier distinct ; vous pouvez ainsi supprimer aisément les extensions IBM si vous souhaitez déployer votre application sur le serveur EJB d'un autre fournisseur. Plus tard dans le processus de développement EJB, le fichier
ibm-ejb-jar-ext.xmi
apparaît. Il contient les informations d'extension spécifiques à IBM.
Toujours dans la vue Explorateur de projets, développez le répertoire du descripteur de déploiement sous le projet EJB, développez Entity Beans > Author et explorez les liens vers les divers composants comprenant le bean Author.
Ensuite, vous créez le bean Book. Pour ce faire, suivez les étapes suivantes :
Book
id
, de type java.lang.Integer
(l'attribut id
est créé automatiquement)titre
, avec le type java.lang.String
Votre second bean entity est créé et visualisé dans le diagramme de classes ; les fichiers suivants s'affichent dans la vue Explorateur de projets :
Book apparaît dorénavant dans la liste des Enterprise JavaBeans de la page Généralités du descripteur de déploiement de beans EJB. Les détails du bean Book sont similaires à ceux du bean Author. Dans la vue Explorateur de projets, développez le répertoire du descripteur de déploiement sous le projet EJB. Développez Entity Beans > Book et explorez les liens vers les composants du bean.
Maintenant, vous allez définir une relation CMP entre les deux beans CMP du diagramme de classes.
Un bean Author peut être associé à un ou plusieurs beans Book ou à aucun.
De même, un bean Book peut être associé à un ou plusieurs beans Book. Cette relation est exprimée sous forme de relation multiple bidirectionnelle au moyen de la notation 0..*:0..*
.
Vous avez la possibilité de réorganiser les éléments dans le diagramme de classes de manière à afficher les détails.
Les vues Structure et Propriétés fournissent des informations utiles sur le diagramme de classes global et sur les propriétés de composants EJB spécifiques.
La vue Structure s'affiche par défaut dans la partie inférieure gauche du plan de travail. Elle vous permet de parcourir un diagramme. Pour ce faire, suivez les étapes suivantes :
La vue Propriétés s'affiche par défaut dans la partie inférieure droite du plan de travail. Elle comprend deux onglets, Apparence et Avancées. Vous pouvez modifier les couleurs, les polices et autres propriétés visuelles dans la page Apparence. La page Avancées affiche les propriétés détaillées de l'élément mis en évidence dans le diagramme de classes. Certaines des valeurs de la vue Propriétés sont en lecture seule tandis que d'autres peuvent être modifiées.
Maintenant, vous allez modifier certains attributs CMP du bean Author.
sexe
et de type java.lang.Character
.sexe
apparaît dans le compartiment Attribut du bean sur le diagramme de classes.
nom
du bean Author.AuthorKey
. L'attribut de nom apparaît dorénavant sur le diagramme de classes avec le symbole de zone de clé principale. La nouvelle classe de clé apparaît dans le répertoire UML EJB tutorialClient > ejbModule > sampleEnsuite, consultez les détails du diagramme de classes. Pour agrandir le diagramme de classes, cliquez deux fois sur sa barre de titre. L'éditeur du diagramme de classes occupe maintenant pratiquement toute la fenêtre du plan de travail (la palette reste développée dans la partie droite).
Lorsque vous ouvrez l'éditeur Java de beans d'EJB, la vue Structure apparaît dans le coin inférieur gauche du plan de travail. Vous pouvez apporter des modifications au bean à partir de cette vue. Cliquez à l'aide du bouton droit de la souris sur l'une des méthodes de la vue Structure, puis sélectionnez Bean enterprise. Sélectionnez Promouvoir ou Rétrograder pour promouvoir ou rétrograder la méthode sélectionnée dans ou depuis l'un des types d'interface répertoriés.
Essayez d'ajouter une méthode à la classe au moyen de l'éditeur Java de beans d'EJB. La nouvelle méthode apparaît dans la vue Structure. Si vous promouvez la nouvelle méthode dans une interface, la méthode apparaît sur le diagramme de classes.
Décoration | Signification |
---|---|
![]() |
Bean entity CMP 2.x |
![]() |
Zone de clé principale |
![]() |
Champ CMP (non principal) |
![]() |
Interface locale |
![]() |
Interface home locale |
![]() |
Interface éloignée |
![]() |
Méthode locale |
![]() |
Méthode home locale |
![]() |
Méthode éloignée |
Une liste complète des décorations figure dans le guide InfoCenter sous la rubrique Référence de visualisation UML.
Lorsque vous apportez des modifications à votre diagramme de classes, des modifications correspondantes sont automatiquement intégrées au code sous-jacent. A l'inverse, si vous modifiez directement le code, le diagramme de classes est modifié automatiquement de façon à refléter ce changement. N'importe quel type de modification effectuée dans le plan de travail entraîne une revalidation automatique et immédiate du code. Pour les applications EJB, la validation inclut l'identification des erreurs de compilation dans les classes Java, des problèmes liés au chemin de classes et des violations des spécifications EJB.
Dans la partie inférieure du plan de travail, plusieurs vues sont empilées, dont la vue Incidents. Cette vue affiche toutes les erreurs, les avertissements et les messages d'information de tous les projets et fichiers du plan de travail. Cliquez deux fois sur l'un des incidents répertoriés pour ouvrir le fichier approprié à l'endroit où s'est produite l'erreur.
Dans la vue Incidents, le nombre d'incidents répertoriés est limité par défaut à 100. Vous pouvez modifier cette limite, ou filtrer la vue pour afficher uniquement les éléments de votre choix. Les options de filtrage englobent le degré de gravité de l'incident, les projets, les ressources et le type d'incident.
Pour modifier ces paramètres par défaut, cliquez sur la flèche
(), puis sélectionnez Filtres.
Vous pouvez modifier certains comportements par défaut et afficher les caractéristiques des diagrammes de classes. Dans le menu Fenêtre, sélectionnez Préférences. Développez Modélisation pour afficher les éléments qui peuvent être modifiés.
La section principale contient des paramètres globaux, tels que l'affichage ou non des barres de menus lorsque vous maintenez le pointeur de la souris sur une classe du diagramme. La section Apparence englobe plusieurs pages qui vous permettent de modifier des éléments tels que les polices, les couleurs, les connecteurs et les formes. La section EJB fournit des paramètres liés à l'ouverture des diagrammes de classes. D'autres sections comportent des options relatives aux champs Java, aux méthodes, règles et grilles et à la validation.
Parcourez les différentes sections pour vous familiariser avec les différentes options. Une fois les modifications apportées, cliquez sur OK pour les sauvegarder et quitter la page des préférences.
Vous êtes maintenant prêt à commencer l'exercice 1.4 : Mappage de beans entity avec des bases de données relationnelles.