nablarch.fw.web

クラス HttpMethodBinding

java.lang.Object

nablarch.fw.handler.MethodBinding<HttpRequest,HttpResponse>

nablarch.fw.web.HttpMethodBinding

すべての実装されたインタフェース:

Handler<HttpRequest,HttpResponse>, HandlerWrapper<HttpRequest,HttpResponse>, HttpRequestHandler

public class HttpMethodBinding
extends MethodBinding<HttpRequest,HttpResponse>
implements HttpRequestHandler

HTTPメソッドベースディスパッチャ。

 HTTPリクエストのメソッド名とリクエストURIの値をもとに、
 動的に委譲先となるメソッド決定する。
  例:
    [HTTPリクエストライン]               [委譲先メソッド名]
    GET  /foo/baa/dynamic_page.jsp  ->  getDynamicPageJsp()
    POST /foo/baa/message           ->  postMessage()
  ディスパッチ処理の詳細仕様は、handle(HttpRequest, ExecutionContext) を参照。
 

ネストされたクラスのサマリー

ネストされたクラス

修飾子とタイプ	クラスと説明
static class	HttpMethodBinding.Binder HttpMethodBindingのファクトリクラス

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
HttpMethodBinding(java.lang.Object delegate) 指定されたオブジェクトに処理を委譲するディスパッチャを作成する。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
protected java.lang.reflect.Method	getMethodBoundTo(HttpRequest req, ExecutionContext ctx) 入力データおよび実行コンテキストの内容に応じて、委譲対象のメソッドを決定する。
HttpResponse	handle(HttpRequest req, ExecutionContext ctx) getMethodBoundTo() で取得したメソッドに対して後続処理を委譲し、 その結果を返す。

クラスから継承されたメソッド nablarch.fw.handler.MethodBinding

getDelegates, getHandleMethod, qualifiesAsHandler

クラスから継承されたメソッド java.lang.Object

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

コンストラクタの詳細

HttpMethodBinding

public HttpMethodBinding(java.lang.Object delegate)

指定されたオブジェクトに処理を委譲するディスパッチャを作成する。

パラメータ:

delegate - ディスパッチの対象となるオブジェクト

メソッドの詳細

getMethodBoundTo

protected java.lang.reflect.Method getMethodBoundTo(HttpRequest req,
                                                    ExecutionContext ctx)

入力データおよび実行コンテキストの内容に応じて、委譲対象のメソッドを決定する。

 本クラスの実装では、コンストラクタで渡されたオブジェクトに対して、
 HTTPリクエストのメソッド名とリクエストURIの値から
 実行対象のメソッドを動的に決定して処理を委譲する。
 委譲対象となるメソッドは、以下2つの条件に合致するものが選ばれる。
   1. メソッドの戻り値の型がHttpResponseかつ、引数を2つもち、
      それぞれの型がHttpRequest、ExecutionContextであること。
   2. メソッドの名前が次の文字列に一致する。
      (リクエストのHTTPメソッド名 もしくは "do") + (リクエストURIのリソース名)
      ただし、一致判定は以下の条件のもとで行われる。
        - メソッド名の大文字小文字は区別しない。   
        - リクエストURIのリソース名に含まれる"."は無視される。
        - 委譲先クラスのメソッド名に含まれる"_"は無視される。
 例:
 =====================  ===========================================================
    HTTPリクエスト         委譲対象となるメソッドシグニチャの例
 =====================  ===========================================================
 GET /app/index.html    HttpResponse getIndexHtml(HttpRequest, ExecutionContext);
                        HttpResponse getIndexhtml(HttpRequest, ExecutionContext);
                        HttpResponse get_index_html(HttpRequest, ExecutionContext);
                        HttpResponse do_index_html(HttpRequest, ExecutionContext);
                        HttpResponse doIndexHtml(HttpRequest, ExecutionContext);
 ---------------------  -----------------------------------------------------------
 POST /app/message      HttpResponse postMessage(HttpRequest, ExecutionContext);
                        HttpResponse do_message (HttpRequest, ExecutionContext);
 =====================  ===========================================================
 上記条件に該当するメソッドが存在しなかった場合、
 下記のHTTPメッセージに相当するHttpResponseオブジェクトを返す。
    HTTP/1.1 404 Not Found
    Content-Type: text/plain
    Not Found: /foo/bar/dynamic_page.jsp
 

定義:

getMethodBoundTo クラス内 MethodBinding<HttpRequest,HttpResponse>

パラメータ:

req - HTTPリクエスト

ctx - 実行コンテキスト

戻り値:

委譲先メソッド

handle

public HttpResponse handle(HttpRequest req,
                           ExecutionContext ctx)

クラスからコピーされた説明: MethodBinding

getMethodBoundTo() で取得したメソッドに対して後続処理を委譲し、 その結果を返す。

定義:

handle インタフェース内 Handler<HttpRequest,HttpResponse>

定義:

handle インタフェース内 HttpRequestHandler

オーバーライド:

handle クラス内 MethodBinding<HttpRequest,HttpResponse>

パラメータ:

req - 入力オブジェクト

ctx - 実行コンテキスト

戻り値:

処理結果オブジェクト