Les haricots d'entit� traitent des donn�es. Ils repr�sentent typiquement des noms, tels qu'un compte, un client, ou un paiement de voyageur fr�quent. Les vieux objets plats de Java h�ritent l'existence quand ils sont cr��s dans un programme. Quand le programme se termine, l'objet est perdu. Mais un haricot d'entit� reste autour jusqu'� ce qu'il soit supprim�. Un programme peut cr�er un haricot d'entit� et alors le programme peut �tre arr�t� et remis en marche--mais l'haricot d'entit� continuera � exister. Apr�s avoir �t� remis en marche, le programme peut encore trouver l'haricot d'entit� que cela fonctionnait avec et continuer de l'employer.

De vieux objets plats de Java sont employ�s seulement par un programme. Un haricot d'entit�, d'une part, peut �tre employ� par n'importe quel programme sur le r�seau. Les programmes de client doivent juste trouver l'haricot d'entit� par l'interm�diaire de JNDI afin de l'employer. Les haricots d'entit� doivent avoir une clef primaire unique qui est employ�e pour trouver l'haricot sp�cifique d'entit� qu'ils veulent manoeuvrer. Par exemple, un haricot d'entit� des � employ�s � peut employer le nombre de la s�curit� sociale des employ�s en tant que sa clef primaire. Les m�thodes d'haricot d'entit� fonctionnent sur une machine de � serveur �. Quand un programme de client appelle la m�thode d'un haricot d'entit�, le fil du programme de client cesse de s'ex�cuter et la commande passe au-dessus de au serveur. Quand la m�thode retourne du serveur, le fil local reprend l'ex�cution.

La limite r�cipient-a contr�l� des moyens de persistance que le r�cipient d'EJB manipule tout l'acc�s aux bases de donn�es exig� par l'haricot d'entit�. Le code de l'haricot ne contient aucun appel de l'acc�s aux bases de donn�es (SQL). En cons�quence, le code de l'haricot n'est pas attach� � un m�canisme persistant sp�cifique de stockage (base de donn�es). En raison de cette flexibilit�, m�me si vous red�ployez le m�me haricot d'entit� sur les diff�rents serveurs de J2EE qui emploient diff�rentes bases de donn�es, vous n'aurez pas besoin de modifier ou recompile le code de l'haricot. En bref, vos haricots d'entit� sont plus portatifs.

Afin de produire des donn�es acc�der aux appels, le r�cipient a besoin d'informations que vous fournissez dans le sch�ma abstrait de l'haricot d'entit�.

Une partie de descripteur du d�ploiement d'un haricot d'entit�, le sch�ma abstrait d�finit les champs persistants et les rapports de l'haricot. L'abr�g� sur limite distingue ce sch�ma du sch�ma physique du magasin fondamental de donn�es. Dans une base de donn�es relationnelle, par exemple, le sch�ma physique se compose des structures telles que des tables et des colonnes. Vous indiquez le nom d'un sch�ma abstrait dans le descripteur de d�ploiement. Ce nom est mis en r�f�rence par des questions �crites dans le langage d'interrogation de JavaBeans d'entreprise (� EJB QL �). Pour un haricot d'entit� avec la persistance r�cipient-contr�l�e, vous devez d�finir une question d'EJB QL pour chaque m�thode de trouveur (except� le findByPrimaryKey). La question d'EJB QL d�termine la question qui est ex�cut�e par le r�cipient d'EJB quand la m�thode de trouveur est appel�e. Vous le trouverez probablement utile d'esquisser le sch�ma abstrait avant d'�crire n'importe quel code. La figure repr�sente un sch�ma abstrait simple qui d�crit les rapports entre trois haricots d'entit�. Ces rapports sont discut�s plus loin dans les sections qui suivent.

Les champs persistants d'un haricot d'entit� sont stock�s dans le magasin fondamental de donn�es. Collectivement, ces champs constituent l'�tat de l'haricot. Au temps d'ex�cution, le r�cipient d'EJB synchronise automatiquement cet �tat avec la base de donn�es. Pendant le d�ploiement, le r�cipient trace typiquement l'haricot d'entit� � une table de base de donn�es et trace les champs persistants aux colonnes de la table.

Un haricot d'entit� de CustomerEJB, par exemple, pourrait avoir les champs persistants tels que le firstName, le lastName, le t�l�phone, et l'email address. Dans la persistance r�cipient-contr�l�e, ces champs sont virtuels. Vous les d�clarez dans le sch�ma abstrait, mais vous ne les codez pas pendant que les variables d'exemple dans l'haricot d'entit� classent. Au lieu de cela, les champs persistants sont identifi�s dans le code par des m�thodes d'acc�s (des acqu�reurs et des poseurs).

Un champ de rapport est comme une clef �trang�re dans une table de base de donn�es--il identifie un haricot relatif. Comme un champ persistant, un champ de rapport est virtuel et est d�fini dans la classe d'haricot d'entreprise avec des m�thodes d'acc�s. Mais � la diff�rence d'un champ persistant, un champ de rapport ne repr�sente pas l'�tat de l'haricot.