@TargetSE({METHODSE,TYPESE})
@RetentionSE(RUNTIMESE)
public @interface AccessTimeout

同時アクセスの試行がタイムアウトするまでにブロックする必要がある特定の時間単位の時間を指定します。

このアノテーションは、ステートフルセッション Bean、またはコンテナー管理の同時実行性を使用するシングルトンセッション Bean に適用できます。

デフォルトでは、クライアントはステートフルセッションオブジェクトへの同時呼び出しを行うことができ、コンテナーはそのような同時リクエストを直列化する必要があります。AccessTimeout アノテーションは、Bean インスタンスがすでに別のリクエストを処理している場合に、ステートフルセッション Bean リクエストがブロックする時間を指定するために使用されます。値 0 の AccessTimeout アノテーションの使用は、ステートフルセッション Bean への同時クライアントリクエストが禁止されることをコンテナーに指定します。

AccessTimeout アノテーションは、ビジネスメソッドまたは Bean クラスで指定できます。クラスで指定されている場合、そのクラスのすべてのビジネスメソッドに適用されます。クラスとクラスのビジネスメソッドの両方で指定されている場合、メソッドレベルのアノテーションが特定のメソッドに優先されます。

シングルトンセッション Bean のアクセスタイムアウトは、同時実行ロックの対象となるメソッドにのみ適用されます。AccessTimeout アノテーションは、シングルトンセッション Bean クラスまたはクラスの適格なメソッドで指定できます。AccessTimeout がクラスとそのクラスのメソッドの両方で指定されている場合、メソッドレベルのアノテーションが指定されたメソッドに優先されます。

value 要素のセマンティクスは次のとおりです。

• 値 > 0 は、unit エレメントで指定された単位でのタイムアウト値を示します。
• 値 0 は、同時アクセスが許可されていないことを意味します。
• 値 -1 は、クライアントリクエストが進行するまで無期限にブロックされることを示します。

-1 未満の値は無効です。