nablarch.fw

Class Interceptor.Impl<TData,TResult,T extends java.lang.annotation.Annotation>

java.lang.Object

nablarch.fw.Interceptor.Impl<TData,TResult,T>

All Implemented Interfaces:

Handler<TData,TResult>, HandlerWrapper<TData,TResult>

Direct Known Subclasses:

CheckRole.Impl, ErrorOnSessionWriteConflict.Impl, InjectForm.Impl, OnDoubleSubmission.Impl, OnError.Impl, OnErrors.Impl, Transactional.TransactionalImpl, UseToken.Impl

Enclosing class:

Interceptor

public abstract static class Interceptor.Impl<TData,TResult,T extends java.lang.annotation.Annotation>
extends java.lang.Object
implements HandlerWrapper<TData,TResult>

Interceptorの処理内容を実装するクラスの抽象基底クラスとなるリクエストハンドラ。

各インターセプションが付与されたときに行われるインターセプト処理の内容は、 このクラスを継承して作成する。

各Interceptorの値に指定されるクラスは、このクラスのサブクラスであり、 インターセプトが行われると、そのサブクラスが実装するHandler.handle(Object, ExecutionContext)に処理が委譲される。 この際、ラップされる前のリクエストハンドラをgetOriginalHandler()で取得できるので、 各インターセプタ固有の処理を以下の例のように実装することができる。

 public HttpResponse handle(HttpRequest req, ExecutionContext ctx) {
     try {
         doBeforeAdvice(); // インターセプタによる前処理
         return getOriginalHandler().handle(req, ctx); // 本処理

     } catch(RuntimeException e) {
         doErrorHandling();  // インターセプタによる例外ハンドリング
         throw e;

     } finally {
         doAfterAdvice();  // インターセプタによる終端処理
     }
 }
 

Constructor Summary

Constructors

Constructor and Description
Impl()

Method Summary

Modifier and Type	Method and Description
java.util.List<java.lang.Object>	getDelegates(TData data, ExecutionContext context) このラッパーが処理を移譲するオブジェクトのリストを返す。 対象となるオブジェクトが存在しない場合は空の配列を返す。
T	getInterceptor() 処理対象のInterceptorを取得する。
Handler<TData,TResult>	getOriginalHandler() インターセプト対象のリクエストハンドラを取得する。
void	setInterceptor(java.lang.annotation.Annotation annotation) 処理対象のInterceptorを設定する。
void	setOriginalHandler(Handler<TData,TResult> originalHandler) インターセプト対象のリクエストハンドラを設定する。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface nablarch.fw.Handler

handle

Constructor Detail

Impl

@Published(tag="architect")
public Impl()

Method Detail

setInterceptor

public void setInterceptor(java.lang.annotation.Annotation annotation)

処理対象のInterceptorを設定する。

Parameters:

annotation - このクラスが実装するInterceptor

getInterceptor

@Published(tag="architect")
public T getInterceptor()

処理対象のInterceptorを取得する。

Returns:

処理対象のInterceptorを取得する。

getOriginalHandler

@Published(tag="architect")
public Handler<TData,TResult> getOriginalHandler()

インターセプト対象のリクエストハンドラを取得する。

Returns:

インターセプト対象のリクエストハンドラ

setOriginalHandler

public void setOriginalHandler(Handler<TData,TResult> originalHandler)

インターセプト対象のリクエストハンドラを設定する。

Parameters:

originalHandler - インターセプト対象のリクエストハンドラ

getDelegates

public java.util.List<java.lang.Object> getDelegates(TData data,
                                                     ExecutionContext context)

このラッパーが処理を移譲するオブジェクトのリストを返す。 対象となるオブジェクトが存在しない場合は空の配列を返す。

Specified by:

getDelegates in interface HandlerWrapper<TData,TResult>

Parameters:

data - ハンドラに対する入力データ

context - 実行コンテキスト

Returns:

内包するオブジェクト。