3.1.5. 同期応答メッセージ送信処理を伴う取引単体テストの実施方法¶

3.1.5.1.1.1. 書き方の例¶

以下に、Excelファイルの記載例を示す。

3.1.5.1.1.2. 電文のフォーマットおよびデータの記載方法¶

電文のフォーマットおよびデータは以下の書式で記載する。

3.1.5.1.1.3. Excelファイルの再読み込み¶

モックアップクラスは、Excelファイルを手動で編集してテストをやり直すケースや、同じデータで繰り返しテストを行うケースを想定し、 Excelファイルのタイムスタンプが更新された場合に、ファイルを再読み込みする機能を提供している。

通常、以下の応答電文を返却するたびにnoのインクリメントが行われ、アプリケーションサーバが起動している間は、noの値が初期化されることはない。

以下のような応答電文データを定義した場合、１回目のメッセージ同期送信ではno.1の応答電文が返却され、 noのインクリメントが行われる。そして２回目のメッセージ同期送信ではno.2の応答電文が返却される。

しかし、Excelファイルの編集や上書きを行い、タイムスタンプを更新することで、アプリケーションサーバ起動中にExcelファイルの再読み込みを行うことができる。

以下に、Excelファイルを編集し、テストをやり直す場合の例を示す。

3.1.5.1.1.4. 障害系のテスト¶

応答電文の本文の表の最初のフィールドに「errorMode:」から始まる特定の値を設定することで、障害系のテストを行うことができる。

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

最初のフィールドに設定する値	障害内容	自動テストフレームワークの動作
errorMode:timeout	メッセージ送信中にタイムアウトエラーが発生する場合のテスト	sendSyncメソッドの戻り値としてnullを返却する。
errorMode:msgException	メッセージ送受信エラーが発生する場合のテスト	MessagingExceptionをスローする。

記載例を以下に示す。

3.1.5.1.4.1. モックアップクラスの設定¶

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

<!-- モックのメッセージングプロバイダ -->
<component name="messagingProvider"
           class="nablarch.test.core.messaging.MockMessagingProvider">
</component>

3.1.5.1.4.2. Excelファイルの配置場所を記載するプロパティファイルのパスの設定¶

コンポーネント設定ファイルで、Excelファイルの配置場所のパスが記載されるプロパティファイルのパスや、プロパティのキーを設定する。

<!-- Excelファイルの配置場所のパスを記載するプロパティファイルのパスを指定する -->
<config-file file="web/filepath.config" />

<component name="filePathSetting"
         class="nablarch.core.util.FilePathSetting" autowireType="None">
   <property name="basePathSettings">
     <map>
       <!- Excelファイルの配置場所のパスを記載するプロパティのキー名を指定する -->
       <entry key="sendSyncTestData" value="${file.path.send.sync.test.data}" />
       <entry key="format" value="classpath:web/format" />
     </map>
   </property>
   <property name="fileExtensions">
     <map>
       <!- Excelファイルの拡張子（xlsx）を定義する-->
       <entry key="sendSyncTestData" value="xlsx" />
       <entry key="format" value="fmt" />
     </map>
   </property>
</component>

3.1.5.1.4.3. テストデータ解析クラスの設定¶

コンポーネント設定ファイルに、取引単体テストで使用するテストデータ解析クラスを設定する。

 <!-- TestDataParser -->
<component name="messagingTestDataParser" class="nablarch.test.core.reader.BasicTestDataParser">
  <property name="testDataReader">
    <component name="xlsReaderForPoi" class="nablarch.test.core.reader.PoiXlsReader"/>
  </property>
  <property name="interpreters" ref="messagingTestInterpreters" />
</component>
 <!-- テストデータ記法の解釈を行うクラス群  -->
<list name="messagingTestInterpreters">
  <component class="nablarch.test.core.util.interpreter.NullInterpreter"/>
  <component class="nablarch.test.core.util.interpreter.QuotationTrimmer"/>
  <component class="nablarch.test.core.util.interpreter.CompositeInterpreter">
    <property name="interpreters">
      <list>
        <component class="nablarch.test.core.util.interpreter.BasicJapaneseCharacterInterpreter"/>
      </list>
    </property>
  </component>
</list>

3.1.5.1.4.4. 必要な単体テストライブラリをpom.xmlへの追加¶

以下のdependencyをpom.xmlへ追加する

<dependency>
  <groupId>com.nablarch.framework</groupId>
  <artifactId>nablarch-testing</artifactId>
  <exclusions>
    <exclusion>
      <groupId>org.mortbay.jetty</groupId>
      <artifactId>*</artifactId>
    </exclusion>
    <exclusion>
      <groupId>com.google.code.findbugs</groupId>
      <artifactId>*</artifactId>
    </exclusion>
  </exclusions>
</dependency>

3.1.5.1.4.5. 取引単体テストで使用するライブラリの設定¶

取引単体テストでは、以下のjarファイルをアプリケーションサーバのクラスパスに通す必要がある。

• nablarch-tfw.jar
• Apache POIのjar

Nablarchが標準で提供するサンプルアプリケーションは、デフォルトでこれらのjarのクラスパス設定が行われた状態になっている。 具体的には、サンプルアプリケーションのtest/libディレクトリにこれらのjarを配置し、下図のとおりEclipseの機能を使用し、クラスパス設定を行っている。

これらのjarは単体テスト以外では使用しないので、上記の例のようにWEB-INF/libではなく、別の場所に配置することを推奨する。