nablarch.test.core.http

Class HttpRequestTestSupport

java.lang.Object

nablarch.test.event.TestEventDispatcher

nablarch.test.core.http.HttpRequestTestSupport

Direct Known Subclasses:

AbstractHttpRequestTestTemplate

@Published
public class HttpRequestTestSupport
extends TestEventDispatcher

HTTPリクエストテスト用の基底クラス。

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	HttpRequestTestSupport.HtmlResourceExtensionFilter コピー対象となるHTMLリソースの拡張子。

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.Class<?>	testClass テストクラス

Fields inherited from class nablarch.test.event.TestEventDispatcher

testName

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpRequestTestSupport() コンストラクタ 本メソッドはサブクラスから使用されることを想定している。
	HttpRequestTestSupport(java.lang.Class<?> testClass) コンストラクタ。

Method Summary

Modifier and Type	Method and Description
void	assertApplicationMessageId(java.lang.String[] expected, ExecutionContext actual) メッセージIDのアサートを行う。
void	assertApplicationMessageId(java.lang.String expectedCommaSeparated, ExecutionContext actual) メッセージIDのアサートを行う。
void	assertApplicationMessageId(java.lang.String msg, java.lang.String[] expected, ExecutionContext actual) メッセージIDのアサートを行う。
void	assertApplicationMessageId(java.lang.String msg, java.lang.String expectedCommaSeparated, ExecutionContext actual) メッセージIDのアサートを行う。
void	assertEntity(java.lang.String sheetName, java.lang.String id, java.lang.Object actual) EntityTestSupport.assertGetterMethod(String, String, Object)への移譲メソッド。
void	assertForward(java.lang.String msg, java.lang.String expectedUri) フォワード先URIが想定通りであることを表明する。
void	assertObjectArrayPropertyEquals(java.lang.String message, java.lang.String sheetName, java.lang.String id, java.lang.Object[] actual) Object配列に設定されたプロパティをアサートする。 チェック条件の詳細は Assertion.assertProperties(java.util.Map, Object) を参照。
void	assertObjectListPropertyEquals(java.lang.String message, java.lang.String sheetName, java.lang.String id, java.util.List<?> actual) Object に設定されたプロパティをアサートする。 チェック条件の詳細は Assertion.assertProperties(java.util.Map, Object) を参照。
void	assertObjectPropertyEquals(java.lang.String message, java.lang.String sheetName, java.lang.String id, java.lang.Object actual) Object に設定されたプロパティをアサートする。 チェック条件の詳細は Assertion.assertProperties(java.util.Map, Object) を参照。
void	assertSqlResultSetEquals(java.lang.String message, java.lang.String sheetName, java.lang.String id, SqlResultSet actual) DbAccessTestSupport.assertSqlResultSetEquals(String, String, String, nablarch.core.db.statement.SqlResultSet) への委譲メソッド。
void	assertSqlRowEquals(java.lang.String message, java.lang.String sheetName, java.lang.String id, SqlRow actual) DbAccessTestSupport.assertSqlRowEquals(String, String, String, nablarch.core.db.statement.SqlRow) への委譲メソッド。
protected void	assertStatusCode(java.lang.String message, int expected, HttpResponse response) ステータスコードが想定通りであることを表明する。 内蔵サーバから戻り値で返却されたHTTPレスポンスがリダイレクトである場合、 ステータスコードが303または302であることを表明する。 このとき、内蔵サーバから返却されるHTTPレスポンスと比較しないのは、後方互換性を保つためである。 （内蔵サーバは、リダイレクト時のステータスコードに'302 FOUND'を使用する） 上記以外の場合は、HttpRequestTestSupportHandler.getStatusCode() のステータスコードを比較対象とする。
void	assertTableEquals(java.lang.String sheetName) DbAccessTestSupport.assertTableEquals(String)への委譲メソッド。
void	assertTableEquals(java.lang.String sheetName, java.lang.String groupId) DbAccessTestSupport.assertTableEquals(String, String)への委譲メソッド。
void	assertTableEquals(java.lang.String message, java.lang.String sheetName, java.lang.String groupId) DbAccessTestSupport.assertTableEquals(String, String, String) への委譲メソッド。
protected void	copyHtmlResourceToDumpDir(HttpTestConfiguration config, java.io.File destDir, ResourceLocator warBaseLocator) HTMLリソースをダンプファイルの出力ディレクトリへコピーする。
ExecutionContext	createExecutionContext(java.lang.String userId) ExecutionContextを生成する。
HttpRequest	createHttpRequest(java.lang.String requestUri, java.util.Map<java.lang.String,java.lang.String[]> params) リクエストパラメータを作成する。
HttpRequest	createHttpRequestWithConversion(java.lang.String requestUri, java.util.Map<java.lang.String,java.lang.String> commaSeparated, java.util.Map<java.lang.String,java.lang.String> cookie) リクエストパラメータを作成する。
protected HttpServer	createHttpServer() HttpServerのインスタンスを生成する。
protected HttpServer	createHttpServer(HttpTestConfiguration config) HttpServerを生成する。
protected void	deleteHtmlResourceFile(java.io.File srcDir, java.io.File destDir) ダンプディレクトリのHTMLリソースファイルを削除する。
HttpResponse	execute(java.lang.Class<?> testClass, java.lang.String caseName, HttpRequest req, ExecutionContext ctx) 自動テスト用HTTPサーバを使用して、リクエスト単体テストを実現する。
protected HttpResponse	execute(java.lang.String caseName, HttpRequest req, ExecutionContext ctx) 自動テスト用HTTPサーバを使用して、リクエスト単体テストを実現する。
protected java.lang.String	getAbsoluteCssUriPrefix(java.lang.String uri, java.lang.String replaceAbsolutePath) URI型の絶対パス参照文字列から、URIのプレフィックスを取得する。
protected java.io.File	getDumpFile(ExecutionContext ctx) HTTPレスポンスボディが出力されたファイルを取得する。
protected java.io.FileFilter	getFileFilter(HttpTestConfiguration config) FileFilterを取得する。
java.util.List<java.util.Map<java.lang.String,java.lang.String>>	getListMap(java.lang.String sheetName, java.lang.String id) DbAccessTestSupport.getListMap(String, String)への委譲メソッド。
java.util.List<java.util.Map<java.lang.String,java.lang.String[]>>	getListParamMap(java.lang.String sheetName, java.lang.String id) DbAccessTestSupport.getListParamMap(String, String)への委譲メソッド。
java.util.Map<java.lang.String,java.lang.String[]>	getParamMap(java.lang.String sheetName, java.lang.String id) DbAccessTestSupport.getParamMap(String, String)への委譲メソッド。
static HttpRequestTestSupportHandler	getTestSupportHandler() サポートハンドラを取得する。
protected void	initializeIfNotYet(HttpTestConfiguration config, java.io.File dumpDir, java.lang.String className) 初回時のみ初期化を実行する。
boolean	is3XXStatusCode(int statusCode) 300系の HTTP ステータスコードかどうか判定する
protected void	prepareHandlerQueue(java.util.List<Handler> handlerQueue) ハンドラキューの準備を行う。
static void	resetHttpServer() キャッシュした HttpServer をリセットする。
protected java.lang.String	rewritePath(java.lang.String text, java.lang.String replaceAbsolutePath) 静的リソース内のパスを置き換える。
protected void	rewriteResourceFile(HttpTestConfiguration config, java.io.File dumpDir, ResourceLocator warBaseLocator) HTMLリソースディレクトリ内のCSSファイルを置換する。 出力したCSSファイルのタイムスタンプには、出力元CSSファイルのタイムスタンプを設定する。 次回、出力時にはタイムスタンプに変更がない限り、出力は行わない。
protected void	setDumpFile(ExecutionContext ctx, java.io.File file) HTTPレスポンスボディが出力されたファイルを設定する。
protected static void	setHttpHeader(HttpRequest req, HttpTestConfiguration config) HTTPHeaderを設定する。 すでにHttpRequestに設定されている項目は、設定しない。
void	setToken(HttpRequest request, ExecutionContext context, boolean valid) トークンをリクエストパラメータとセッションスコープに設定する。 引数validが真の場合、有効なトークンを設定する。偽の場合はトークンを無効にする。
void	setUpDb(java.lang.String sheetName) DbAccessTestSupport.setUpDb(String)への委譲メソッド。
void	setUpDb(java.lang.String sheetName, java.lang.String groupId) DbAccessTestSupport.setUpDb(String, String)への委譲メソッド。
void	setValidToken(HttpRequest request, ExecutionContext context) 有効なトークンをリクエストパラメータとセッションスコープに設定する。 二重サブミットを防止しているアクションのメソッドをテストする場合は、このメソッドを呼び出しトークンを設定する。

Methods inherited from class nablarch.test.event.TestEventDispatcher

dispatchEventOfAfterTestClass, dispatchEventOfAfterTestMethod, dispatchEventOfBeforeTestClassAndBeforeSuit, dispatchEventOfBeforeTestMethod, getMethodName

Methods inherited from class java.lang.Object

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

Field Detail

testClass

protected final java.lang.Class<?> testClass

テストクラス

Constructor Detail

HttpRequestTestSupport

public HttpRequestTestSupport(java.lang.Class<?> testClass)

コンストラクタ。

Parameters:

testClass - テストクラス

HttpRequestTestSupport

protected HttpRequestTestSupport()

コンストラクタ
本メソッドはサブクラスから使用されることを想定している。

Method Detail

execute

protected HttpResponse execute(java.lang.String caseName,
                               HttpRequest req,
                               ExecutionContext ctx)

自動テスト用HTTPサーバを使用して、リクエスト単体テストを実現する。

Parameters:

req - テスト対象のアクションを呼び出すためのHttpRequest

caseName - テストケース名

ctx - ExecutionContext

Returns:

HttpResponse

initializeIfNotYet

protected void initializeIfNotYet(HttpTestConfiguration config,
                                  java.io.File dumpDir,
                                  java.lang.String className)

初回時のみ初期化を実行する。

Parameters:

config - HttpTestConfiguration

dumpDir - HTMLダンプ先のディレクトリ

className - テストクラス

execute

public HttpResponse execute(java.lang.Class<?> testClass,
                            java.lang.String caseName,
                            HttpRequest req,
                            ExecutionContext ctx)

自動テスト用HTTPサーバを使用して、リクエスト単体テストを実現する。

Parameters:

testClass - テストクラス

req - テスト対象のアクションを呼び出すためのHttpRequest

caseName - テストケース名

ctx - ExecutionContext

Returns:

HttpResponse

createHttpServer

protected HttpServer createHttpServer(HttpTestConfiguration config)

HttpServerを生成する。

Parameters:

config - HttpTestConfiguration

Returns:

HTTPサーバ

getTestSupportHandler

public static HttpRequestTestSupportHandler getTestSupportHandler()

サポートハンドラを取得する。

Returns:

サポートハンドラ

prepareHandlerQueue

protected void prepareHandlerQueue(java.util.List<Handler> handlerQueue)

ハンドラキューの準備を行う。

Parameters:

handlerQueue - ハンドラキュー

createHttpServer

protected HttpServer createHttpServer()

HttpServerのインスタンスを生成する。

Returns:

HttpServerのインスタンス

copyHtmlResourceToDumpDir

protected void copyHtmlResourceToDumpDir(HttpTestConfiguration config,
                                         java.io.File destDir,
                                         ResourceLocator warBaseLocator)

HTMLリソースをダンプファイルの出力ディレクトリへコピーする。

Parameters:

config - HttpTestConfiguration

destDir - 出力ディレクトリ

warBaseLocator - warベースディレクトリのリソースロケータ

deleteHtmlResourceFile

protected void deleteHtmlResourceFile(java.io.File srcDir,
                                      java.io.File destDir)

ダンプディレクトリのHTMLリソースファイルを削除する。

Parameters:

srcDir - HTMLリソースフォルダ

destDir - HTMLリソースのコピーフォルダ

rewriteResourceFile

protected void rewriteResourceFile(HttpTestConfiguration config,
                                   java.io.File dumpDir,
                                   ResourceLocator warBaseLocator)

HTMLリソースディレクトリ内のCSSファイルを置換する。 出力したCSSファイルのタイムスタンプには、出力元CSSファイルのタイムスタンプを設定する。 次回、出力時にはタイムスタンプに変更がない限り、出力は行わない。

Parameters:

config - HttpTestConfiguration

dumpDir - 出力先ディレクトリ

warBaseLocator - warベースのリソースロケータ

rewritePath

protected java.lang.String rewritePath(java.lang.String text,
                                       java.lang.String replaceAbsolutePath)

静的リソース内のパスを置き換える。

Parameters:

text - 文字列

replaceAbsolutePath - ファイルの絶対パスからwarのルートパスを取り除いたパス。

Returns:

置換後の文字列

getAbsoluteCssUriPrefix

protected java.lang.String getAbsoluteCssUriPrefix(java.lang.String uri,
                                                   java.lang.String replaceAbsolutePath)

URI型の絶対パス参照文字列から、URIのプレフィックスを取得する。

Parameters:

uri - URI型の絶対パス参照文字列

replaceAbsolutePath - HTMLリソースの絶対パスからwarのルートパスを取り除いたパス。

Returns:

URIのプレフックス

getFileFilter

protected java.io.FileFilter getFileFilter(HttpTestConfiguration config)

FileFilterを取得する。

Parameters:

config - HttpTestConfiguration

Returns:

FileFilter

setHttpHeader

protected static void setHttpHeader(HttpRequest req,
                                    HttpTestConfiguration config)

HTTPHeaderを設定する。
すでにHttpRequestに設定されている項目は、設定しない。

Parameters:

req - HTTPHeaderを設定するHttpRequest

config - HttpTestConfiguration

assertForward

public void assertForward(java.lang.String msg,
                          java.lang.String expectedUri)

フォワード先URIが想定通りであることを表明する。

Parameters:

msg - アサート失敗時のメッセージ

expectedUri - 期待するフォワード先URI

assertStatusCode

protected void assertStatusCode(java.lang.String message,
                                int expected,
                                HttpResponse response)

ステータスコードが想定通りであることを表明する。
内蔵サーバから戻り値で返却されたHTTPレスポンスがリダイレクトである場合、 ステータスコードが303または302であることを表明する。 このとき、内蔵サーバから返却されるHTTPレスポンスと比較しないのは、後方互換性を保つためである。 （内蔵サーバは、リダイレクト時のステータスコードに'302 FOUND'を使用する） 上記以外の場合は、HttpRequestTestSupportHandler.getStatusCode() のステータスコードを比較対象とする。

Parameters:

message - アサート失敗時のメッセージ

expected - 期待するステータスコード値

response - HTTPレスポンス

See Also:

HttpRequestTestSupportHandler

is3XXStatusCode

public boolean is3XXStatusCode(int statusCode)

300系の HTTP ステータスコードかどうか判定する

Parameters:

statusCode - 判定対象のHTTPステータスコード

Returns:

300系の HTTP ステータスコードであれば true

assertApplicationMessageId

public void assertApplicationMessageId(java.lang.String expectedCommaSeparated,
                                       ExecutionContext actual)

メッセージIDのアサートを行う。

Parameters:

expectedCommaSeparated - 期待するメッセージID（カンマ区切り）

actual - 実行結果(メッセージIDをリクエストスコープにもつExecutionContext)

assertApplicationMessageId

public void assertApplicationMessageId(java.lang.String msg,
                                       java.lang.String expectedCommaSeparated,
                                       ExecutionContext actual)

メッセージIDのアサートを行う。

Parameters:

msg - 任意のメッセージ

expectedCommaSeparated - 期待するメッセージID（カンマ区切り）

actual - 実行結果(メッセージIDをリクエストスコープにもつExecutionContext)

assertApplicationMessageId

public void assertApplicationMessageId(java.lang.String[] expected,
                                       ExecutionContext actual)

メッセージIDのアサートを行う。

Parameters:

expected - 期待するメッセージIDの配列

actual - 実行結果(メッセージIDをリクエストスコープにもつExecutionContext)

assertApplicationMessageId

public void assertApplicationMessageId(java.lang.String msg,
                                       java.lang.String[] expected,
                                       ExecutionContext actual)

メッセージIDのアサートを行う。

Parameters:

msg - 任意のメッセージ

expected - 期待するメッセージIDの配列

actual - 実行結果(メッセージIDをリクエストスコープにもつExecutionContext)

setValidToken

public void setValidToken(HttpRequest request,
                          ExecutionContext context)

有効なトークンをリクエストパラメータとセッションスコープに設定する。
二重サブミットを防止しているアクションのメソッドをテストする場合は、このメソッドを呼び出しトークンを設定する。

Parameters:

request - テスト対象のアクションを呼び出すためのHttpRequest

context - ExecutionContext

setToken

public void setToken(HttpRequest request,
                     ExecutionContext context,
                     boolean valid)

トークンをリクエストパラメータとセッションスコープに設定する。
引数validが真の場合、有効なトークンを設定する。偽の場合はトークンを無効にする。

Parameters:

request - テスト対象のアクションを呼び出すためのHttpRequest

context - ExecutionContext

valid - 有効なトークンを設定するかどうか

createHttpRequest

public HttpRequest createHttpRequest(java.lang.String requestUri,
                                     java.util.Map<java.lang.String,java.lang.String[]> params)

リクエストパラメータを作成する。

Parameters:

requestUri - リクエストURI

params - パラメータが格納されたMap

Returns:

リクエストパラメータ

createHttpRequestWithConversion

public HttpRequest createHttpRequestWithConversion(java.lang.String requestUri,
                                                   java.util.Map<java.lang.String,java.lang.String> commaSeparated,
                                                   java.util.Map<java.lang.String,java.lang.String> cookie)

リクエストパラメータを作成する。

Parameters:

requestUri - リクエストURI

commaSeparated - パラメータが格納されたMap

cookie - Cookie情報が格納されたMap

Returns:

リクエストパラメータ

createExecutionContext

public ExecutionContext createExecutionContext(java.lang.String userId)

ExecutionContextを生成する。

Parameters:

userId - セッションスコープに格納するユーザID

Returns:

生成したExecutionContext

getDumpFile

protected java.io.File getDumpFile(ExecutionContext ctx)

HTTPレスポンスボディが出力されたファイルを取得する。

Parameters:

ctx - ExecutionContext

Returns:

ファイル。HTTPダンプ出力が無効な場合はnull

setDumpFile

protected void setDumpFile(ExecutionContext ctx,
                           java.io.File file)

HTTPレスポンスボディが出力されたファイルを設定する。

Parameters:

ctx - ExecutionContext

file - ファイル

setUpDb

public void setUpDb(java.lang.String sheetName)

DbAccessTestSupport.setUpDb(String)への委譲メソッド。

Parameters:

sheetName - シート名

See Also:

DbAccessTestSupport.setUpDb(String)

setUpDb

public void setUpDb(java.lang.String sheetName,
                    java.lang.String groupId)

DbAccessTestSupport.setUpDb(String, String)への委譲メソッド。

Parameters:

sheetName - シート名

groupId - グループID

See Also:

DbAccessTestSupport.setUpDb(String, String)

assertSqlResultSetEquals

public void assertSqlResultSetEquals(java.lang.String message,
                                     java.lang.String sheetName,
                                     java.lang.String id,
                                     SqlResultSet actual)

DbAccessTestSupport.assertSqlResultSetEquals(String, String, String, nablarch.core.db.statement.SqlResultSet) への委譲メソッド。

Parameters:

message - 比較失敗時のメッセージ

sheetName - 期待値を格納したシート名

id - シート内のデータを特定するためのID

actual - 実際の値

See Also:

DbAccessTestSupport.assertSqlResultSetEquals(String, String, String, nablarch.core.db.statement.SqlResultSet)

assertSqlRowEquals

public void assertSqlRowEquals(java.lang.String message,
                               java.lang.String sheetName,
                               java.lang.String id,
                               SqlRow actual)

DbAccessTestSupport.assertSqlRowEquals(String, String, String, nablarch.core.db.statement.SqlRow) への委譲メソッド。

Parameters:

message - 比較失敗時のメッセージ

sheetName - 期待値を格納したシート名

id - シート内のデータを特定するためのID

actual - 実際の値

getListMap

public java.util.List<java.util.Map<java.lang.String,java.lang.String>> getListMap(java.lang.String sheetName,
                                                                                   java.lang.String id)

DbAccessTestSupport.getListMap(String, String)への委譲メソッド。

Parameters:

sheetName - シート名

id - ID

Returns:

List-Map形式のデータ

See Also:

DbAccessTestSupport.getListMap(String, String)

getListParamMap

public java.util.List<java.util.Map<java.lang.String,java.lang.String[]>> getListParamMap(java.lang.String sheetName,
                                                                                          java.lang.String id)

DbAccessTestSupport.getListParamMap(String, String)への委譲メソッド。

Parameters:

sheetName - シート名

id - ID

Returns:

List-Map形式のデータ

See Also:

DbAccessTestSupport.getListParamMap(String, String)

getParamMap

public java.util.Map<java.lang.String,java.lang.String[]> getParamMap(java.lang.String sheetName,
                                                                      java.lang.String id)

DbAccessTestSupport.getParamMap(String, String)への委譲メソッド。

Parameters:

sheetName - シート名

id - ID

Returns:

Map形式のデータ

See Also:

DbAccessTestSupport.getParamMap(String, String)

assertTableEquals

public void assertTableEquals(java.lang.String sheetName)

DbAccessTestSupport.assertTableEquals(String)への委譲メソッド。

Parameters:

sheetName - 期待値を格納したシート名

See Also:

DbAccessTestSupport.assertTableEquals(String)

assertTableEquals

public void assertTableEquals(java.lang.String sheetName,
                              java.lang.String groupId)

DbAccessTestSupport.assertTableEquals(String, String)への委譲メソッド。

Parameters:

sheetName - 期待値を格納したシート名

groupId - グループID（オプション）

See Also:

DbAccessTestSupport.assertTableEquals(String, String)

assertTableEquals

public void assertTableEquals(java.lang.String message,
                              java.lang.String sheetName,
                              java.lang.String groupId)

DbAccessTestSupport.assertTableEquals(String, String, String) への委譲メソッド。

Parameters:

message - 比較失敗時のメッセージ

groupId - グループID（オプション）

sheetName - 期待値を格納したシート名

See Also:

DbAccessTestSupport.assertTableEquals(String, String, String)

assertEntity

public void assertEntity(java.lang.String sheetName,
                         java.lang.String id,
                         java.lang.Object actual)

EntityTestSupport.assertGetterMethod(String, String, Object)への移譲メソッド。

Parameters:

sheetName - シート名

id - ケース表のID(LIST_MAP=testの場合は、testを指定する。)

actual - 実行結果のオブジェクト(Java Beansオブジェクト)

assertObjectPropertyEquals

public void assertObjectPropertyEquals(java.lang.String message,
                                       java.lang.String sheetName,
                                       java.lang.String id,
                                       java.lang.Object actual)

Object に設定されたプロパティをアサートする。
チェック条件の詳細は Assertion.assertProperties(java.util.Map, Object) を参照。

Parameters:

message - メッセージ

sheetName - シート名

id - ケース表のID(LIST_MAP=testの場合は、testを指定する。)

actual - 実際の値

assertObjectArrayPropertyEquals

public void assertObjectArrayPropertyEquals(java.lang.String message,
                                            java.lang.String sheetName,
                                            java.lang.String id,
                                            java.lang.Object[] actual)

Object配列に設定されたプロパティをアサートする。
チェック条件の詳細は Assertion.assertProperties(java.util.Map, Object) を参照。

Parameters:

message - メッセージ

sheetName - シート名

id - ケース表のID(LIST_MAP=testの場合は、testを指定する。)

actual - 実際の値

assertObjectListPropertyEquals

public void assertObjectListPropertyEquals(java.lang.String message,
                                           java.lang.String sheetName,
                                           java.lang.String id,
                                           java.util.List<?> actual)

Object に設定されたプロパティをアサートする。
チェック条件の詳細は Assertion.assertProperties(java.util.Map, Object) を参照。

Parameters:

message - メッセージ

sheetName - シート名

id - ケース表のID(LIST_MAP=testの場合は、testを指定する。)

actual - 実際の値

resetHttpServer

public static void resetHttpServer()

キャッシュした HttpServer をリセットする。