des enterprise beans - Département Informatique

Cré ation de l’ interface locale
La classe de base EJBHome
Toutes les interfaces locales étendent l’interface javax.ejb.EJBHome. Voici la
définition complète de EJBHome :
package javax.ejb
public interface EJBHome extends java.rmi.Remote {
void remove(Handle handle) throws java.rmi.RemoteException,
RemoveException;
void remove(Object primaryKey) throws java.rmi.RemoteException,
RemoveException;
EJBMetaData getEJBMetaData() throws RemoteException;
HomeHandle getHomeHandle() throws RemoteException;
}
EJBHome possède deux méthodes remove() pour supprimer les instances des
enterprise beans. La première méthode remove() identifie l’instance par un
handle ; la deuxième par une clé primaire.
Un handle, identificateur d’objet bean sérialisable, a la même durée de vie
que l’objet enterprise bean qu’il référence. Pour un bean session, le handle
n’existe que le temps de la session. Pour un bean entité, le handle peut
persister et un client peut utiliser un handle sérialisé pour rétablir une
référence à l’objet entité qu’il identifie.
Un client se servira de la deuxième méthode remove() pour supprimer
l’instance d’un bean entité en utilisant sa clé primaire.
getEJBMetaData() renvoie l’interface EJBMetaData de l’objet enterprise bean.
Cette interface permet au client d’obtenir les informations de
métadonnées relatives au bean. Son objectif est d’être utilisée par les outils
de développement qui construisent des applications utilisant des
enterprise beans déployés.
Notez que l’interface EJBHome n’a pas de méthode pour créer ou localiser les
instances d’un enterprise bean. A la place, vous devez ajouter ces
méthodes aux interfaces locales que vous développez pour vos beans.
Comme les beans session et les beans entité ont des cycles de vie
différents, les méthodes définies dans leurs interfaces locales diffèrent.
Création d’une interface locale pour un bean session
Un bean session a presque toujours un seul client (sauf occasionnellement
les beans session stateless). Quand un client crée un bean session, cette
instance du bean session n’existe que pour l’utilisation de ce client.
Pour créer une interface locale pour un bean session,
• Déclarez une interface locale qui étend javax.ejb.EJBHome.
• Ajoutez la signature d’une méthode create() pour chaque méthode
ejbCreate() du bean, avec un nombre et des types d’arguments
correspondant exactement.
11-2 Guide du dé veloppeur Enterprise JavaBeans