Code source (JBoss) de l'annotation @ConcurrencyManagement :
package javax.ejb; /** * Declares a Singleton bean's concurrency management type. */ @Target(TYPE) @Retention(RUNTIME) public @interface ConcurrencyManagement { ConcurrencyManagementType value() default CONTAINER; }

Code source (JBoss) de l'annotation @Lock :
package javax.ejb; /** * Declares a concurrency lock for a singleton method. */ @Target({ METHOD, TYPE }) @Retention(RUNTIME) public @interface Lock { LockType value() default WRITE; }
Notes :
- Si l'annotation est appliquée au niveau de la classe alors toutes les méthodes de la classe vont avoir le type du lock choisi pour la classe.
- Si l'annotation est appliquée au niveau de la méthode alors celle ci va avoir son propre type de lock.

Code source (JBoss) de l'annotation @AccessTimeout :
package javax.ejb; import static java.lang.annotation.ElementType.METHOD; import static java.lang.annotation.ElementType.TYPE; import static java.lang.annotation.RetentionPolicy.RUNTIME; import java.lang.annotation.Retention; import java.lang.annotation.Target; import java.util.concurrent.TimeUnit; /** * Specifies the amount of time in a given time unit that a concurrent access * attempt on a Singleton session bean should block before timing out. */ @Target({ METHOD, TYPE }) @Retention(RUNTIME) public @interface AccessTimeout { // The maximum time to wait for access. long value(); TimeUnit unit() default TimeUnit.MILLISECONDS; }
Cette annotation permet de specifier un temp maximal qu'un lock peut être conservé sur une méthode.
Si le lock n'est pas libéré avant ce temps, une exception sera levé et le lock sur la méthode sera déverrouillé.

Si l'annotation est appliquée au niveau de la classe alors toutes les méthodes de la classe vont hériter les configurations du timeout définies pour la classe.
Si l'annotation est appliquée au niveau de la méthode alors celle ci va avoir son propre configuration du timeout.

L'attribut value de l'annotation @AccessTimeout définit le temps du timeout.
La valeur "0" indique au container que les accès concurrents à la méthode sont interdits.
La valeur "-1" indique un timeout infini.
Une valeur inférieur à "-1" est invalide.

L'attribut unit de l'annotation @AccessTimeout définit l'unité du temps du timeout.

Code source (JBoss) de l'enum ConcurrencyManagementType :
package javax.ejb; /** * Concurrency management type for a singleton or stateful session bean. * Bean-managed concurrency only applies to singletons. */ public enum ConcurrencyManagementType { BEAN, CONTAINER }
- ConcurrencyManagementType.CONTAINER // le container EJB est responsable de la gestion des accès concurrents à un singleton bean. - ConcurrencyManagementType.BEAN // la gestion des accès concurrents à un singleton bean est déléguée complètement au code de la classe bean.

Code source (JBoss) de l'enum LockType :
package javax.ejb; /** * Concurrency lock type. * - READ : For read-only operations. Allows simultaneous access to methods designated as READ, as long as no WRITE lock is held. * - WRITE : For write operations. The WRITE lock is exclusive. */ public enum LockType { READ, WRITE }
- LockType.READ // le container EJB permet des accès simultanés à la méthode, tant qu'un lock de type WRITE n'a pas été acquis sur l'instance. - LockType.WRITE // Le container EJB donne un accès exclusive à la méthode, uniquement si aucun lock de type READ ou WRITE n'a pas été acquis sur l'instance.
Notes :
- Une fois le lock de type WRITE est obtenu, aucun accès à aucune des méthodes du singleton bean ne sera permis, et cela jusqu'à ce que le lock soit libéré (soit parce que l'exécution de la méthode est complétée ou un timeout est levé).