nablarch.fw.web.interceptor

注釈型 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);
      }
  }
 

関連項目:

OnError.Impl

必須要素のサマリー

必須要素

修飾子とタイプ	必須要素と説明
java.lang.String	path リクエストハンドラから、type() に合致する実行時例外が送出された場合に送信する画面のリソースパスを返す。
java.lang.Class<? extends java.lang.RuntimeException>	type このインターセプタがハンドリングする実行時例外。

任意要素のサマリー

任意要素

修飾子とタイプ	任意要素と説明
int	statusCode リクエストハンドラから、type() に合致する実行時例外が送出された場合のレスポンスステータスを返す。

要素の詳細

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)となる。
 

デフォルト:

400