des enterprise beans - Département Informatique

Cré ation de l’ interface locale
• Doit inclure dans les exceptions de la clause throws toutes les
exceptions déclenchées par les méthodes ejbCreate() et ejbPostCreate()
correspondantes de la classe du bean entité. En d’autres termes,
l’ensemble des exceptions de la méthode create() doit être un
sur-ensemble de la réunion des exceptions des deux méthodes
ejbCreate() et ejbPostCreate(). Le type de renvoi de la méthode
ejbCreate() est la classe clé primaire.
• Utiliser ses paramètres, s’il y en a, pour initialiser le nouvel objet bean
entité.
Méthodes find des beans entité
Comme les beans entité ont généralement une longue durée de vie et
peuvent être utilisés par plusieurs clients, une instance du bean entité
existe probablement déjà lorsqu’une application client en a besoin. Dans
ce cas, le client n’a pas besoin de créer une instance du bean entité, mais il
a besoin de localiser celle qui existe. C’est pourquoi l’interface locale d’un
bean entité définit une ou plusieurs méthodes find.
Les beans session n’ont pas besoin de méthode find puisqu’ils servent un
seul client, l’application qui a créé le bean. Le client n’a pas besoin de
trouver l’instance du bean session — il sait déjà où elle se trouve.
L’interface locale d’un bean entité doit définir la méthode find par défaut,
findByPrimaryKey(). Elle permet à un client de localiser un objet entité
utilisant une clé primaire :
findByPrimaryKey( key)
throws java.rmi.RemoteException, FinderException;
findByPrimaryKey() a un seul argument, la clé primaire. Son type de renvoi
est l’interface distante du bean entité. Dans le descripteur de déploiement
du bean, vous indiquez au conteneur le type de la clé primaire.
findByPrimaryKey() renvoie toujours un seul objet entité.
Vous pouvez définir d’autres méthodes find dans l’interface locale.
Chaque méthode find doit avoir une implémentation correspondante
dans la classe d’un bean entité dont la persistance est gérée par le bean.
Pour la persistance gérée par le conteneur, c’est le conteneur qui
implémente les méthodes find. Chaque méthode find doit respecter les
conventions suivantes :
• Le type de renvoi doit être le type de l’interface distante, ou, pour les
méthodes find qui renvoient plus d’un objet entité, un type de
collection dont le type de contenu est le type de l’interface distante. Les
types corrects de collection Java sont java.util.Enumeration et
java.util.Collection.
• Le nom de la méthode find doit toujours commencer par le préfixe
find. Le nom de la méthode find correspondante dans la classe du bean
entité doit commencer par le préfixe ejbFind.
Cré ation des interfaces locales et distantes 11-5