3.1.20. リクエスト単体テストの実施方法(HTTP同期応答メッセージ送信処理)

リクエスト単体テスト実施方法は、リクエスト単体テストの実施方法(同期応答メッセージ送信処理)を参照すること。

ただし、「送信キュー」「受信キュー」を「通信先」と読み替えること。

本項では、リクエスト単体テストの実施方法(同期応答メッセージ送信処理)と異なる箇所の解説を行う。

3.1.20.1. テストデータの書き方

3.1.20.1.1. 電文を1回送信する場合の要求電文の期待値および、返却する応答電文（レスポンスメッセージ）の例

以下に、電文を1回送信する場合の返却する応答電文の記述例を示す。

../../../../../../_images/http_send_sync_response.png

補足

RESPONSE_BODY_MESSAGES(及び後の例で使用するEXPECTED_REQUEST_BODY_MESSAGES)は、複数フィールドに分割して記述することが可能である。

文字列が長く、1セルに全部記述すると可読性が落ちる場合に分割して記述する。

分割する際、「フィールド名」は任意の文字列を指定する。上記の例では XML1 、 XML2 、 XML3 としている。

以下に、電文を1回送信する場合の要求電文の期待値の記述例を示す。

../../../../../../_images/http_send_sync_expected.png

補足

JSON及びXMLデータ形式使用時は、1Excelシートに1テストケースのみ記述すること。

これはメッセージボディについて、Excelの各行の文字列長が同一であることを期待しているというNTFの制約によるものである。JSON及びXMLデータ形式は、要求電文の長さがリクエスト毎に異なるのが一般的なので、事実上1テストケースしか記述できない。

3.1.20.1.2. 電文を2回以上送信する場合の要求電文の期待値および、返却する応答電文（レスポンスメッセージ）の例

複数回電文送信を行う場合のテストは、テスティングフレームワークの以下の仕様に注意をして記述すること。

以下に複数回電文送信を行う際の、返却する応答電文の記述例を示す。

../../../../../../_images/http_send_sync_ok_pattern_response.png

以下に複数回電文送信を行う際の、要求電文の期待値の記述例を示す。

../../../../../../_images/http_send_sync_ok_pattern_expected.png

補足

送信対象のリクエストIDが複数存在する場合、送信順のテストは不可能である。上記の例の場合、 ProjectSaveMessage より先に、 ProjectSaveMessage2 が送信された場合であってもテストは成功となる。

3.1.20.1.2.1. 障害系のテスト

応答電文の表に「errorMode:」から始まる特定の値を設定することで、障害系のテストを行うことができる[1]。

以下に、設定値と、障害系のテストの対応を示す。

最初のフィールドに設定する値 障害内容 自動テストフレームワークの動作
errorMode:timeout メッセージ送信中にタイムアウトエラーが発生する場合のテスト HttpMessagingTimeoutException (MessagingException のサブクラス)を送出する。 [2]
errorMode:msgException メッセージ送受信エラーが発生する場合のテスト MessagingException をスローする。

この値は、応答電文の表のヘッダおよび本文両方の、「no」を除く最初のフィールドに記載すること。

[1]業務アクション内で、明示的に MessagingException の制御を行っていないのであれば、 個別のリクエスト単体テストにおいて障害系のテストを行う必要は無い。
[2]リクエスト単体テストの実施方法(同期応答メッセージ送信処理)と異なるクラスを送出する。

3.1.20.1.3. モックアップを使用するための記述

testShotsに expectedMessageByClient および responseMessageByClient にグループIDを設定する。モックアップ自体については、同期応答メッセージ送信処理を伴う取引単体テストの実施方法を参照。

グループIDの関連についてはリクエスト単体テストの実施方法(同期応答メッセージ送信処理)における expectedMessage および responseMessage の場合と同様であるため割愛する。

../../../../../../_images/http_send_sync_shot.png
同一アクション内でMOMによる同期応答メッセージ送信処理とHTTP同期応答メッセージ送信処理が同時に行われる場合、
“expectedMessage”、”responseMessage”にMOMによる同期応答メッセージ送信処理で使用するグループIDを、
“expectedMessageByClient”、”responseMessageByClient”にHTTP同期応答メッセージ送信処理で使用するグループIDを
それぞれ個別に指定する。
../../../../../../_images/http_mom_send_sync_shot.png

補足

グループIDはMOMによる同期応答メッセージ送信処理とHTTP同期応答メッセージ送信処理でそれぞれ別の値を設定する必要がある。 同一のグループIDを指定した場合、正しく結果検証が行われないため、注意すること。

3.1.20.1.4. 要求電文のアサート

テストデータのディレクティブ行に設定されたfile-typeの値により、要求電文のアサート方法が変化する。

設定方法やアサート内容についての詳細は リクエスト単体テストの実施方法(同期応答メッセージ受信処理) のレスポンスメッセージの項を参照すること。

3.1.20.2. フレームワークで使用するクラスの設定

通常、これらの設定はアーキテクトが行うものでありアプリケーションプログラマが設定する必要はない。

3.1.20.2.1. モックアップクラスの設定

コンポーネント設定ファイルに、リクエスト単体テストで使用するモックアップクラスを設定する。

<!-- HTTP通信用クライアント -->
<component name="defaultMessageSenderClient"
           class="nablarch.test.core.messaging.RequestTestingMessagingClient">
  <property name="charset" value="Shift-JIS"/>
</component>

なお、charsetに、文字コード名を指定することでログに出力する文字コードを変更することができる。 通常は省略可能で、省略した場合はUTF-8が使用される。