des enterprise beans - Département Informatique

Cré ation de l’ interface locale
Quand vous utilisez l’expert Enterprise JavaBean 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 session
L’interface locale d’un bean session fonctionne comme une factory de
bean session, car elle doit définir une ou plusieurs méthodes create().
Quand le client appelle create(), une nouvelle instance du bean est créée.
En accord avec la spécification EJB, chaque méthode create() définie dans
l’interface locale doit
• Renvoyer le type d’interface distante du bean session.
• 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.
• Déclencher l’exception java.rmi.RemoteException.
• Déclencher l’exception javax.ejb.CreateException.
• Utiliser ses paramètres, s’il y en a, pour initialiser le nouvel objet bean
session.
Vous pouvez utiliser les experts EJB pour être sûr que ses règles seront
suivies.
L’exemple de code suivant montre deux méthodes create() possibles de
l’interface locale d’un bean session. Les parties en gras sont obligatoires :
public interface AtmHome extends javax.ejb.EJBHome {
Atm create()
throws java.rmi.RemoteException, javax.ejb.CreateException;
Atm create(Profile preferredProfile)
throws java.rmi.RemoteException, javax.ejb.CreateException;
}
Cré ation des interfaces locales et distantes 11-3