nablarch.fw.web.handler

Class HttpRequestJavaPackageMapping

java.lang.Object

nablarch.fw.web.handler.HttpRequestJavaPackageMapping

All Implemented Interfaces:

Handler<HttpRequest,HttpResponse>, HttpRequestHandler

public class HttpRequestJavaPackageMapping
extends java.lang.Object
implements HttpRequestHandler

このハンドラは、画面オンライン処理におけるリクエストパス中の部分文字列(ベースURI)を Javaパッケージ階層にマッピングすることで、動的に委譲先ハンドラを決定するディスパッチ処理を行う。 本ハンドラの実装は基本的に RequestPathJavaPackageMapping のラッパーであり その機能は以下の2点を除けば全く同じものである。

 1. ディスパッチ対象のクラスが確定した時点で、HTTPアクセスログにその内容を出力する。
 2. ベースパスを設定する際にURLの書式バリデーションを行うアクセサ setBaseUri(String)を追加。
 

機能の詳細については、 RequestPathJavaPackageMapping を参照すること。

See Also:

RequestPathJavaPackageMapping

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HttpRequestJavaPackageMapping.Mapping ディスパッチャの実体。 note: 共通ハンドラを直接継承すると、HttpRequestHandlerを実装することが できないので、内部クラスに委譲する形にしている。

Constructor Summary

Constructors

Constructor and Description
HttpRequestJavaPackageMapping() コンストラクタ
HttpRequestJavaPackageMapping(java.lang.String baseUri, java.lang.String basePackage) コンストラクタ

Method Summary

Modifier and Type	Method and Description
HttpResponse	handle(HttpRequest request, ExecutionContext context) HTTPリクエストに対する処理を実行する。
HttpRequestJavaPackageMapping	setBasePackage(java.lang.String basePackage) ベースパッケージを設定する。
HttpRequestJavaPackageMapping	setBasePath(java.lang.String basePath) ベースパスを設定する。
HttpRequestJavaPackageMapping	setBaseUri(java.lang.String baseUri) ベースURIを設定する。(setBasePath(String)のシノニム)
HttpRequestJavaPackageMapping	setOptionalPackageMappingEntries(java.util.List<JavaPackageMappingEntry> optionalPackageMappingEntries) RequestHandlerEntryでURIに合致したマッピング先Javaパッケージを上書きする場合に使用する、JavaPackageMappingEntryのリストを設定する。

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpRequestJavaPackageMapping

public HttpRequestJavaPackageMapping()

コンストラクタ

HttpRequestJavaPackageMapping

public HttpRequestJavaPackageMapping(java.lang.String baseUri,
                                     java.lang.String basePackage)

コンストラクタ

Parameters:

baseUri - マップ元リクエストURI

basePackage - マップ先Javaパッケージ

Method Detail

handle

public HttpResponse handle(HttpRequest request,
                           ExecutionContext context)

HTTPリクエストに対する処理を実行する。 URI中の部分文字列をJavaパッケージへマッピングすることで動的に 委譲先のハンドラを決定し、処理を委譲する。 また、委譲先のクラスがハンドラインターフェースを実装していない場合でも、 HttpMethodBinding により処理を委譲する。

Specified by:

handle in interface Handler<HttpRequest,HttpResponse>

Specified by:

handle in interface HttpRequestHandler

Parameters:

request - HTTPリクエストオブジェクト

context - サーバサイド実行コンテキストオブジェクト

Returns:

HTTPレスポンスオブジェクト

setBasePath

public HttpRequestJavaPackageMapping setBasePath(java.lang.String basePath)

ベースパスを設定する。

Parameters:

basePath - ベースパス

Returns:

このオブジェクト自体

setBaseUri

public HttpRequestJavaPackageMapping setBaseUri(java.lang.String baseUri)

ベースURIを設定する。(setBasePath(String)のシノニム)

Parameters:

baseUri - ベースURI

Returns:

このオブジェクト自体

setBasePackage

public HttpRequestJavaPackageMapping setBasePackage(java.lang.String basePackage)

ベースパッケージを設定する。

Parameters:

basePackage - ベースパッケージ

Returns:

このオブジェクト自体

setOptionalPackageMappingEntries

public HttpRequestJavaPackageMapping setOptionalPackageMappingEntries(java.util.List<JavaPackageMappingEntry> optionalPackageMappingEntries)

RequestHandlerEntryでURIに合致したマッピング先Javaパッケージを上書きする場合に使用する、JavaPackageMappingEntryのリストを設定する。

Parameters:

optionalPackageMappingEntries - RequestHandlerEntryでURIに合致したマッピング先Javaパッケージを上書きする場合に使用する、JavaPackageMappingEntryのリスト

Returns:

このオブジェクト自体