des enterprise beans - Département Informatique

Cré ation de l’ interface locale
Création d’une interface locale pour un bean entité
Un bean entité est destiné à servir plusieurs clients. Quand un client crée
une instance de bean entité, n’importe quel autre client peut également
l’utiliser.
Pour créer une interface locale pour un bean entité,
• Déclarez une interface qui étend javax.ejb.EJBHome.
• Ajoutez la signature d’une méthode create() pour chaque méthode
ejbCreate() du bean, avec les signatures correspondant exactement.
• Ajoutez la signature d’une méthode find pour chaque méthode find du
bean, avec les signatures correspondant exactement.
Quand vous utilisez l’expert Enterprise JavaBean ou le Modeleur Bean
entité EJB de JBuilder, ce dernier crée une interface locale avec une
méthode create() en même temps qu’il crée la classe de l’enterprise bean.
Vous pouvez alors ajouter d’autres méthodes create() à l’interface locale si
vous ajoutez d’autres méthodes ejbCreate() à votre bean. Ou, si vous avez
déjà la classe d’un enterprise bean existant, utilisez l’expert Interfaces EJB
de JBuilder pour créer une interface locale et une interface distante avec
des signatures correspondant à celles de votre classe bean. Pour plus
d’informations, voir Chapitre 3, “Création des enterprise beans avec
JBuilder”.
Si vous choisissez de commencer le développement de votre EJB en créant
une interface distante, vous pouvez utiliser le Créateur de bean EJB pour
générer le squelette de la classe du bean et l’interface locale. Pour plus
d’informations sur le Créateur de bean EJB, voir “Génération de la classe
du bean à partir d’une interface distante”, page 3-12.
Méthodes create() des beans entité
Comme l’interface locale d’un bean session, l’interface locale d’un bean
entité fonctionne comme une factory de bean entité, car elle doit définir
une ou plusieurs méthodes create(). En accord avec la spécification EJB,
chaque méthode create() définie doit
• Déclencher l’exception java.rmi.RemoteException.
• Déclencher l’exception javax.ejb.CreateException.
• Renvoyer le type d’interface distante du bean entité.
• S’appeler create().
• Correspondre à une méthode ejbCreate() de la classe du bean session.
Le nombre et les types d’arguments de chaque méthode create() doit
concorder avec sa méthode ejbCreate() correspondante dans la classe
du bean session.
11-4 Guide du dé veloppeur Enterprise JavaBeans