アノテーションインターフェース ContextServiceDefinition

qualifiers() によって指定され、name() 属性で指定された JNDI 名でコンテナーによって JNDI に登録された必要な Qualifier アノテーションを含む、ContextService インジェクションポイントに注入される ContextService を定義します。

アプリケーションコンポーネントは、Resource アノテーションの lookup 属性でこの JNDI 名を参照できます。

@ContextServiceDefinition(
     name = "java:app/concurrent/MyContext",
     qualifiers = MyQualifier.class,
     propagated = APPLICATION,
     unchanged = TRANSACTION,
     cleared = ALL_REMAINING)
 public class MyServlet extends HttpServlet {
     @Inject
     @MyQualifier
     ConetxtService appContextSvc1;

     @Resource(lookup = "java:app/concurrent/MyContext",
               name = "java:app/concurrent/env/MyContextRef")
     ContextService appContextSvc2;
     ...

 @Qualifier
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER, ElementType.TYPE })
 public @interface MyQualifier {}
 

デプロイ記述子のリソース環境参照は、同様に lookup-name を指定できます。

 <resource-env-ref>
    <resource-env-ref-name>java:app/env/concurrent/MyContextRef</resource-env-ref-name>
    <resource-env-ref-type>jakarta.enterprise.concurrent.ContextService</resource-env-ref-type>
    <lookup-name>java:app/concurrent/MyContext</lookup-name>
 </resource-env-ref>
 

cleared()、propagated()、unchanged() 属性を使用すると、アプリケーションは、ContextService によってコンテキスト化されたタスクおよびアクションにスレッドコンテキストを適用する方法を構成できます。このクラスには、Jakarta EE Concurrency 仕様で定義されているコンテキスト型用の定数が用意されています。これらの定数に加えて、Jakarta EE 製品プロバイダーは、追加のベンダー固有のコンテキスト型を受け入れることを選択できます。ベンダー固有の型を使用すると、アプリケーションが移植できなくなります。

複数のリストで同じコンテキスト型が重複するとエラーになり、ContextService インスタンスを作成できなくなります。ALL_REMAINING がどのリストにも存在しない場合、cleared() コンテキスト型に暗黙的に追加されます。

<context-service> デプロイ記述子要素を使用して ContextService を定義することもできます。元:

 <context-service>
    <name>java:app/concurrent/MyContext</name>
    <cleared>Security</cleared>
    <cleared>Transaction</cleared>
    <propagated>Application</propagated>
    <unchanged>Remaining</unchanged>
 </context-service>
 

context-service と ContextServiceDefinition の名前が同じ場合、それらの属性は結合されて単一の ContextService 定義が定義され、context-service デプロイ記述子エントリで指定された各属性が、アノテーションの対応する属性よりも優先されます。修飾子要素が指定されている場合、修飾子要素のセットがアノテーションの修飾子属性に置き換えられます。