public static final class Interceptor.Factory
extends java.lang.Object
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
に実行順の定義を行うこと。修飾子とタイプ | メソッドと説明 |
---|---|
static Interceptor |
getInterceptorOf(java.lang.annotation.Annotation annotation)
与えられたアノテーションに付与されている
Interceptor メタアノテーションを返す。 |
static <D,R> Handler<D,R> |
wrap(Handler<D,R> handler)
Interceptor アノテーションによるリクエストハンドラの
ラッパーを作成する。 |
static <D,R> Handler<D,R> |
wrap(Handler<D,R> handler,
java.lang.annotation.Annotation[] annotations)
与えられた
Interceptor アノテーションによって
リクエストハンドラをラップする。 |
public static <D,R> Handler<D,R> wrap(Handler<D,R> handler)
Interceptor
アノテーションによるリクエストハンドラの
ラッパーを作成する。
与えられたリクエストハンドラのHandler.handle(Object, ExecutionContext)
メソッド上に付与された
Interceptor
アノテーションを取得し、
その内容に準じた処理をリクエストハンドラに追加したラッパーで作成する。D
- ハンドラの入力データ型R
- ハンドラの処理結果データ型handler
- ラップされるハンドラInterceptor
の処理を追加したリクエストハンドラpublic static <D,R> Handler<D,R> wrap(Handler<D,R> handler, java.lang.annotation.Annotation[] annotations)
Interceptor
アノテーションによって
リクエストハンドラをラップする。
ただし、リクエストハンドラのHandler.handle(Object, ExecutionContext)
メソッドに付与されたアノテーションについては評価しない。D
- ハンドラの入力データ型R
- ハンドラの処理結果データ型handler
- ハンドラannotations
- Interceptor
アノテーションInterceptor
でラップされたリクエストハンドラpublic static Interceptor getInterceptorOf(java.lang.annotation.Annotation annotation)
Interceptor
メタアノテーションを返す。annotation
- メタアノテーションInterceptor
アノテーション。
Interceptor
が付与されていない場合はnull。