Vous pouvez utiliser l'Assistant pour créer un composant EJB. Cet Assistant vous guide tout au long des différentes étapes de création du composant et est disponible uniquement si le langage du modèle est Java.
L'Assistant peut être lancé à partir d'un diagramme de classes. Vous pouvez soit créer un EJB sans sélectionner de classe, soit commencer par sélectionner une classe, puis lancer l'Assistant à partir du menu contextuel du symbole de classe.
Vous avez également la possibilité de créer plusieurs EJB du même type en sélectionnant plusieurs classe simultanément. L'Assistant crée alors automatiquement un EJB par classe. Les classes que vous avez sélectionnées dans le diagramme de classes deviennent des classes Bean. Elle sont renommées pour être en conformité avec les conventions de dénomination standard et liées à leur composant.
Si vous avez sélectionné des classes ou des interfaces avant de démarrer l'Assistant, ces classes sont automatiquement liées au nouveau composant EJB.
Lorsqu'une interface ou une classe est déjà dotée d'un stéréotype, par exemple <<EJBEntity>>, elle est principalement utilisée pour être l'interface ou la classe de l'EJB.
Pour plus d'informations sur la classe ou l'interface d'EJB stéréotypée, voir la section Définition d'interfaces et de classes pour les EJB.
L'Assistant de création d'un EJB permet de définir les paramètres suivants :
|
Zone de l'Assistant |
Description |
|---|---|
|
Nom |
Nom du composant EJB |
|
Code |
Code du composant EJB |
|
Type de composant |
Entity Bean CMP, Entity Bean BMP, Message Driven Bean, Session Bean Stateful ou Session Bean Stateless. Pour plus d'informations sur les différents types d'EJB, reportez-vous à la section Utilisation des types d'EJB |
|
Classe Bean |
Nom de la classe qui met en oeuvre les méthodes de gestion du bean |
|
Interface Remote |
Etend l'interface javax.ejb.EJBObject et fournit une vue client distante |
|
Interface Remote Home |
Définit les méthodes et opérations utilisées dans une vue client distante. Etend l'interface javax.ejb.EJBHome |
|
Interface Local |
Etend l'interface javax.ejb.EJBLocalObject. Permet aux beans d'être étroitement liés à leurs clients et d'être directement accessibles |
|
Interface Local Home |
Définit les méthodes et opérations utilisées localement dans une vue client locale. Etend l'interface javax.ejb.EJBLocal-Home |
|
Classe de clé primaire |
Nom de la classe qui fournit un pointeur vers la base de données. Applicable uniquement aux beans d'entité |
|
Transaction |
Définit le support de transaction utilisé pour le composant. La transaction est importante pour la distribution via un réseau depuis un serveur. La valeur de support de transaction s'affiche dans le descripteur de déploiement. Cette information est fournie par le descripteur de déploiement au serveur lorsque vous générez le composant |
|
Créer un symbole dans |
Crée un symbole de composant dans le diagramme de composants spécifié dans la liste. S'il existe déjà un diagramme de composants, vous pouvez le sélectionner dans la liste. Vous pouvez également afficher la feuille de propriétés du diagramme sélectionné en cliquant sur l'outil Propriétés |
|
Créer un diagramme de classes pour les classificateurs du composant |
Crée un diagramme de classes avec un symbole pour chaque classe et interface associée au composant. Si vous avez sélectionné des classes et interfaces avant de démarrer l'Assistant, elles sont utilisées pour créer le composant. Cette option permet d'afficher ces classes et interfaces dans un diagramme |
La zone de groupe Transaction contient les valeurs suivantes, conformes à la spécification Enterprise JavaBeans 2.0 :
|
Valeur |
Description |
|---|---|
|
Non supportée |
Le composant ne prend pas en charge les transactions, elles ne lui sont pas nécessaires. S'il en existe une, il l'ignore |
|
Supportée |
Le composant attend une transaction, il l'utilise |
|
Requise |
S'il n'existe aucune transaction, elle est créée |
|
Nouvelle requise |
Le composant doit disposer d'une nouvelle transaction à sa création, le serveur doit lui fournir cette nouvelle transaction |
|
Obligatoire |
En l'absence de transaction, une exception est renvoyée |
|
Jamais |
Une transaction n'est pas nécessaire |
Le descripteur de déploiement d'EJB prend en charge le type de transaction pour chaque méthode : vous pouvez donc spécifier un type de transaction pour chaque méthode d'interface Remote ou Local d'EJB.
Vous pouvez définir le type de transaction pour chaque méthode à l'aide d'un attribut étendu dans le dossier Profile/Operation/Extended Attributes/EJB du langage objet Java. Si le type de transaction de l'opération n'est pas spécifié (vide), le type de transaction par défaut défini dans le composant est utilisé.
Une fois que vous avez fini d'utiliser l'Assistant, les actions suivantes sont exécutées :
Un composant EJB est créé
Les classes et interfaces sont associées au composant, et les éventuelles classes ou interfaces manquantes associées au composant sont créées
Les diagrammes associés au composant sont mis à jour ou créés
En fonction du type d'EJB choisi, la classe de clé primaire d'EJB, ses interfaces et dépendances sont automatiquement créées et visibles dans l'Explorateur d'objets. En outre, toutes les dépendances entre les interfaces Remote, les interfaces Local et la classe Bean du composant sont créées
L'EJB créé est nommé d'après la classe d'origine si vous avez sélectionné une classe avant de démarrer l'Assistant. Les classes et interfaces ont également un préfixe faisant référence au nom de la classe d'origine afin de préserver la cohérence