Package nablarch.fw
Class Interceptor.Factory
java.lang.Object
nablarch.fw.Interceptor.Factory
- Enclosing class:
- Interceptor
Interceptor
アノテーションによるHandler.handle(Object, ExecutionContext)
へのインターセプトを実現するスタティックメソッドを保持するクラス。
次のコードにより、handler.handle() メソッド上に付与されている
Interceptor
アノテーションを収集し、各インターセプタに対応した
リクエストハンドラでラップされたハンドラ(wrapped)が生成される。
Handler wrapped = Interceptor.Factory.wrap(handler);wrapped.handle() を実行すると、各インターセプタのhandle()メソッドが順次実行され、 最後に元のリクエストハンドラのhandle()メソッドが呼ばれる。 インターセプタの実行順は、
SystemRepository
にキー値:interceptorsOrderで定義する。
以下のように定義した場合、インターセプタはInterceptor2、Interceptor1の順で実行される。
<list name="interceptorsOrder">
<value>test.Interceptor2</value>
<value>test.Interceptor1</value>
</list>
SystemRepository
に実行順が定義されている場合に、実行順に定義されていないインターセプタを
使用すると、実行時例外(IllegalArgumentException
)を送出し処理を終了する。
SystemRepository
に実行順が定義されていない場合は、
Method.getDeclaredAnnotations()
で返されるリストの逆順で実行される。
※Method.getDeclaredAnnotations()
で返される順序は、規定されていないため実行環境(jvmのバージョンなど)により結果が変わる可能性がある。
このため、実行順を保証する必要がある場合は、必ずSystemRepository
に実行順の定義を行うこと。-
Method Summary
Modifier and TypeMethodDescriptionstatic Interceptor
getInterceptorOf
(Annotation annotation) 与えられたアノテーションに付与されているInterceptor
メタアノテーションを返す。static <D,
R> Handler<D, R> Interceptor
アノテーションによるリクエストハンドラの ラッパーを作成する。static <D,
R> Handler<D, R> wrap
(Handler<D, R> handler, Annotation[] annotations) 与えられたInterceptor
アノテーションによって リクエストハンドラをラップする。
-
Method Details
-
wrap
Interceptor
アノテーションによるリクエストハンドラの ラッパーを作成する。 与えられたリクエストハンドラのHandler.handle(Object, ExecutionContext)
メソッド上に付与されたInterceptor
アノテーションを取得し、 その内容に準じた処理をリクエストハンドラに追加したラッパーで作成する。- Type Parameters:
D
- ハンドラの入力データ型R
- ハンドラの処理結果データ型- Parameters:
handler
- ラップされるハンドラ- Returns:
Interceptor
の処理を追加したリクエストハンドラ
-
wrap
与えられたInterceptor
アノテーションによって リクエストハンドラをラップする。 ただし、リクエストハンドラのHandler.handle(Object, ExecutionContext)
メソッドに付与されたアノテーションについては評価しない。- Type Parameters:
D
- ハンドラの入力データ型R
- ハンドラの処理結果データ型- Parameters:
handler
- ハンドラannotations
-Interceptor
アノテーション- Returns:
Interceptor
でラップされたリクエストハンドラ
-
getInterceptorOf
与えられたアノテーションに付与されているInterceptor
メタアノテーションを返す。- Parameters:
annotation
- メタアノテーション- Returns:
- 付与されている
Interceptor
アノテーション。Interceptor
が付与されていない場合はnull。
-