3.2.2. データベースを使用するクラスのテスト¶

3.2.2.1.1. 全体像¶

3.2.2.2.1. 参照系のテスト¶

参照系のテストにおいて、テスト対象クラスが期待通りにデータを取得していることを確認する場合、以下の手順でデータベースからの参照結果を確認できる。

1. データベースに準備データを登録する。
2. テスト対象クラスのメソッドを起動する。
3. 戻り値として受け取った検索結果が期待した値であるか確認する。

3.2.2.2.1.1. シーケンス¶

3.2.2.2.2. 更新系のテスト¶

テスト対象クラスが期待通りにデータを更新していることを確認する場合、以下の手順でデータベースの更新結果を確認できる。

1. データベースに準備データを登録する。
2. テスト対象クラスのメソッドを起動する。
3. トランザクションをコミットする。
4. データベースの値が期待通り更新されていることを確認する。

3.2.2.2.2.1. シーケンス¶

3.2.2.3.1. DBに準備データのカラムを省略する場合¶

データベース準備データを記述する際にカラムを省略すると、省略されたカラムにはデフォルト値が設定されているものとして扱われる。

ただし、主キーカラムは省略できない。

3.2.2.3.2. DB期待値のカラムを省略する場合¶

DB期待値から単純に無関係なカラムを省略すると、省略されたカラムは比較対象外となる。更新系テストの場合には、「無関係なカラムが更新されていないことを確認する」という観点も必要である。 この場合、データタイプにEXPECTED_TABLEではなく、EXPECTED_COMPLETE_TABLEを使用する。 EXPECTED_TABLEを使用した場合、省略されたカラムは比較対象外となるが、EXPECTED_COMPLETE_TABLEを使用した場合は、省略されたカラムにはデフォルト値が格納されているものとして比較が行われる。

3.2.2.3.3. 具体例¶

全カラムを記載した場合と、関係のあるカラムのみを記載した場合の記述例を以下に示す。

3.2.2.3.4. デフォルト値¶

自動テストフレームワークのコンポーネント設定ファイルにて明示的に指定していない場合、デフォルト値には以下の値が使用される。

3.2.2.3.5. デフォルト値の変更方法¶

<!-- TestDataParser -->
<component name="testDataParser" class="nablarch.test.core.reader.BasicTestDataParser">
  <!-- データベースデフォルト値 -->
  <property name="defaultValues">
    <component class="nablarch.test.core.db.BasicDefaultValues">
      <property name="charValue" value="a"/>
      <property name="dateValue" value="2000-01-01 12:34:56.123456789"/>
      <property name="numberValue" value="1"/>
    </component>
  </property>
  <!-- 中略 -->
</component>

3.2.2.4.1. setUpDbメソッドに関する注意点¶

• Excelファイルには必ずしも全カラムを記述する必要はない。 省略されたカラムには、デフォルト値が設定される。
• Excelファイルの１シート内に複数のテーブルを記述できる。 setUpDb(String sheetName)実行時、指定されたシート内のデータタイプ”SETUP_TABLE”全てが登録対象となる。

3.2.2.4.2. assertTableEqualsメソッドに関する注意点¶

• 期待値の記述で省略されたカラムは、比較対象外となる。
• 比較実行時、レコードの順番が異なっていても主キーを突合して正しく比較ができる。 レコードの順序を意識して期待データを作成する必要はない。
• １シート内に複数のテーブルを記述できる。assertTableEquals(String sheetName)実行時、指定されたシート内のデータタイプ”EXPECTED_TABLE”であるデータが全て比較される。
• 更新日付のようなjava.sql.Timestamp型のフォーマットは”yyyy-mm-dd hh:mm:ss.fffffffff”である(fffffffffはナノ秒)。ナノ秒が設定されていない場合でも、フォーマット上は0ナノ秒として表示される。例えば、2010年1月1日12時34分56秒ジャストの場合、2010-01-01 12:34:56.0となる。Excelシートに期待値を記載する場合は、末尾の小数点＋ゼロを付与しておく必要がある。

3.2.2.4.3. assertSqlResultSetEqualsメソッドに関する注意点¶

• SELECT文で指定された全てのカラム名（別名）が比較対象になる。ある特定のカラムを比較対象外にすることはできない。
• レコードの順序が異なる場合は、等価でないとみなす（アサート失敗）。 これは以下の理由による。
  • SELECTで指定されたカラムに主キーが含まれているとは限らない為。
  • SELECT実行時はORDER BY指定がなされる場合がほとんどであり、順序についても厳密に比較する必要がある為。

3.2.2.4.4. クラス単体テストにおける登録・更新系テストの注意点¶

• 自動設定項目を利用してデータベースに登録・更新する際は、ThreadContextにリクエストIDとユーザIDが設定されている必要がある。テスト対象クラス起動前にこれらの値をThreadContextに設定しておくこと。 ThreadContextの設定方法については、次の項を参照。（ ThreadContextにユーザID、リクエストIDなどを設定したい ）
• デフォルト以外のトランザクションを使用する場合は、本フレームワークにトランザクション制御を行わせる必要がある。トランザクション制御の設定方法については、次の項を参照。（ デフォルト以外のトランザクションを使用したい ）

3.2.2.4.5. 外部キーが設定されたテーブルにデータをセットアップしたい¶

マスタデータ復旧機能 と同じ機能を用いて、テーブルの親子関係を判断しデータを削除及び登録する。 詳細は 外部キーが設定されたテーブルを使用する場合について を参照。

3.2.2.4.6. Excelファイルに記述できるカラムのデータ型に関する注意点¶

Excelファイルには、SqlPStatement で対応している型のカラムのみ テストデータとして記述できる。

そのため、それ以外のデータ型(例えば、OracleのROWIDやPostgreSQLのOIDなど)のカラムはテストデータとして記述できない点に注意すること。