nablarch.fw.web.interceptor

Annotation Type OnError

@Documented
 @Target(value=METHOD)
 @Retention(value=RUNTIME)
 @Interceptor(value=OnError.Impl.class)
 @Published
public @interface OnError

リクエストハンドラが例外を送出した場合のレスポンスを指定するInterceptor。

 次の例では、"ApplicationException"が送出された場合の遷移先を
 入力画面(registerForm.jsp)に設定している。
 
  @OnError (
      type = ApplicationException.class
    , path ="servlet://registerForm.jsp"
  )
  public HttpResponse handle(HttpRequest req, ExecutionContext ctx) {
      registerUser(req.getParamMap());
      return new HttpResponse(200, "servlet://registrationCompleted.jsp");
  }
  
  この処理は、以下のコードによる処理と本質的に同等である。
  
  public HttpResponse handle(HttpRequest req, ExecutionContext ctx) {
      try {
          registerUser(req.getParamMap());
          return new HttpResponse(200, "servlet://registrationCompleted.jsp");
      } catch(ApplicationException ae) {
          throw new HttpErrorResponse(400, "servlet://registerForm.jsp", ae);
      }
  }
 

See Also:

OnError.Impl

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
java.lang.String	path リクエストハンドラから、type() に合致する実行時例外が送出された場合に送信する画面のリソースパスを返す。 (必須属性)
java.lang.Class<? extends java.lang.RuntimeException>	type このインターセプタがハンドリングする実行時例外。 (必須属性)

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
int	statusCode リクエストハンドラから、type() に合致する実行時例外が送出された場合のレスポンスステータスを返す。

Element Detail

type

public abstract java.lang.Class<? extends java.lang.RuntimeException> type

このインターセプタがハンドリングする実行時例外。 (必須属性)

path

public abstract java.lang.String path

リクエストハンドラから、type() に合致する実行時例外が送出された場合に送信する画面のリソースパスを返す。 (必須属性)

statusCode

public abstract int statusCode

リクエストハンドラから、type() に合致する実行時例外が送出された場合のレスポンスステータスを返す。

 デフォルトではステータスコード400(Bad Request)となる。
 

Default:

400