Création d'un EJB à l'aide de l'Assistant

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 les classes ou interfaces d'EJB stéréotypées, 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, qui correspondent à la spécification Enterprise JavaBeans 2.0 de Sun's Microsystems, Inc.

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é.

  1. Sélectionnez Outils > Créer un Enterprise JavaBean à partir d'un diagramme de classes.

    La boîte de dialogue Assistant EJB s'affiche.



    Remarque : Si vous avez sélectionné plusieurs classes avant de démarrer l'Assistant, certaines étapes ne s'affichent pas car les noms sont créés par défaut à partir du nom des classes sélectionnées.
  2. Saisissez un nom et un code pour le composant, puis cliquez sur Suivant.
  3. Sélectionnez le type de composant, puis cliquez sur Suivant.
  4. Sélectionnez le nom de classe Bean, puis cliquez sur Suivant.
  5. Sélectionnez les noms d'interface Remote et Remote Home, puis cliquez sur Suivant.
  6. Sélectionnez les noms d'interface Local et Local Home, puis cliquez sur Suivant.
  7. Sélectionnez le nom de classe de clé primaire, puis cliquez sur Suivant.
  8. Sélectionnez le type de support de transaction, puis cliquez sur Suivant.
  9. A la fin de l'Assistant, vous devez définir la création des symboles et diagrammes.

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