Un stateful bean ("stateful session bean") est une classe Java que le container EJB instancie et rend accessible ses méthodes publiques.
Le stateful bean est accessible en utilisant l'injection automatique ou JNDI.

Les valeurs des variables d'instance du stateful bean sont conservées entre différents appels du stateful bean pour une session.

Pour définir une classe comme étant un stateful bean il faut, typiquement, annoter la classe avec l'annotation @Stateful.

Code source (JBoss) de l'annotation @Stateful:
package javax.ejb; /** * A stateful session bean must be annotated with the Stateful annotation or denoted in the deployment descriptor as a stateful session bean. * If other annotations are applied to the bean class or its members, the Stateful annotation must be used. * The bean class does not implement the javax.ejb.SessionBean interface. */ @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) public @interface Stateful { /** * The ejb-name of this bean. */ String name() default ""; /** * A product specific name (in JBoss the global JNDI name) that this session bean should be mapped to. * Application servers are not required to support any particular form or type of mapped name, nor the ability to use mapped names. * The mapped name is product-dependent and often installation-dependent. * No use of a mapped name is portable. */ String mappedName() default ""; String description() default ""; }
L'annotation @Stateful accepte 3 paramètres :

• String name()
  Le nom EJB du stateful bean.
  Ce nom sera utilisé pour référencer le stateful bean (avec DI ou JNDI).
  Par défaut, si aucune valeur n'est spécifiée pour ce paramètre, il sera initialisé par le nom de la classe du stateful bean (sans le nom du package).
  Typiquement, on s'en sert pour donner un nom plus explicite au stateful bean ou pour distinguer le stateful bean d'une autre Stateful qui a le même nom de la classe.
  
  
• String mappedName()
  Ce paramètre permet de mapper le stateful bean à un nom global définit dans le container EJB (assez souvent un nom JNDI).
  
  
• String description()
  Nom descriptif du stateful bean.
  
  

Exemple :
package com.mtitek.session.beans.stateful; import javax.ejb.Stateful; @Stateful public class MyFirstStatefulBean { private Integer requestNumber = 0; public Integer getRequestNumber() { requestNumber++; return requestNumber; } public Integer initRequestNumber() { requestNumber = 0; return requestNumber; } }

@Local // (javax.ejb.Local) @Remote // (javax.ejb.Remote) @LocalBean // (javax.ejb.LocalBean)

Annotations qui gèrent le cycle de vie du stateful bean :
@PostConstruct // (javax.annotation.PostConstruct) @PreDestroy // (javax.annotation.PreDestroy) @PrePassivate // (javax.ejb.PrePassivate) @PostActivate // (javax.ejb.PostActivate)