3.2.9. 目的別API使用方法¶

3.2.9.1.1. テストソースコード実装例¶

public class EmployeeComponentTest extends DbAccessTestSupport {

    @Test
    public void testGetName() {
       // Excelファイルからデータ取得
       List<Map<String, String>> parameters = getListMap("testGetName", "parameters");
       Map<String, String>> param = parameters.get(0);

       // 引数および期待値を取得
       String empNo = parameter.get("empNo");
       String expected = parameter.get("expected");

       // テスト対象メソッド起動
       EmployeeComponent target = new EmployeeComponent();
       String actual = target.getName(empNo);

       // 結果確認
       assertEquals(expected, actual);

       // ＜後略＞
    }

3.2.9.1.2. Excelファイル記述例¶

LIST_MAP=parameters

上記の表で取得可能なオブジェクトは、以下のコードで取得できるListと等価である。

List<Map<String, String>> list = new ArrayList<Map<String, String>>();
Map<String, String> first = new HashMap<String, String>();
first.put("empNo","00001");
first.put("expected", "山田太郎");
list.add(first);
Map<String, String> second = new HashMap<String, String>();
second.put("empNo","00002");
map.put("expected", "鈴木一郎");
list.add(second);

3.2.9.2.1. テストソースコード実装例¶

public class EmployeeComponentTest extends DbAccessTestSupport {

    @Test
    public void testSelectByPk() {
       // 準備データ投入
       setUpDb("testSelectByPk");

       // Excelファイルからデータ取得
       List<Map<String, String>> parameters = getListMap("testGetName", "parameters");

       for (Map<String, String> param : parameters) {
           // 引数および期待値を取得
           String empNo = parameter.get("empNo");
           String expectedDataId = parameter.get("expectedDataId");

           // テスト対象メソッド起動
           EmployeeComponent target = new EmployeeComponent();
           SqlResultSet actual = target.selectByPk(empNo);

           // 結果確認
           assertSqlResultSetEquals("testSelectByPk", expectedDataId, actual);
        }
    }

3.2.9.2.2. Excelファイル記述例¶

// ループさせるデータ

LIST_MAP=parameters

// データベースの準備データ

SETUP_TABLE=EMPLOYEE

// 期待するデータその１

LIST_MAP=expected01

// 期待するデータその２

LIST_MAP=expected02

3.2.9.3.1. テストソースコード実装例¶

// DBにデータ登録（グループIDが"case_001"のものだけ登録対象になる）
setUpDb("testUpdate", "case_001");


// 結果確認（グループIDが"case_001"のものだけassert対象になる）
assertTableEquals("データベース更新結果確認", "testUpdate", "case_001");

3.2.9.3.2. Excelファイル記述例¶

// ケース001:従業員の所属を変更する。

SETUP_TABLE[case_001]=EMPLOYEE_TABLE

EXPECTED_TABLE[case_001]=EMPLOYEE_TABLE

// ケース002:従業員の氏名を変更する。

SETUP_TABLE[case_002]=EMPLOYEE_TABLE

EXPECTED_TABLE[case_002]=EMPLOYEE_TABLE

3.2.9.3.3. 注意事項¶

複数のグループIDのデータを記述する際は、 複数のデータタイプ使用時はデータタイプごとにまとめてデータを記述する のようにグループIDごとにまとめて記述すること。 グループIDごとにまとめて記述しないとデータの読み込みが途中で終了しテストが正しく実行されない。

3.2.9.4.1. 設定ファイル例¶

コンポーネント設定ファイルにて、SystemTimeProviderインタフェースの実装クラスを指定する箇所に FixedSystemTimeProviderを指定し、そのプロパティに任意の日時を設定する。 例えば、システム日時を2010年9月14日12時34分56秒とする場合は以下のように設定する。

<component name="systemTimeProvider"
    class="nablarch.test.FixedSystemTimeProvider">
  <property name="fixedDate" value="20100913123456" />
</component>

// システム日時を取得
SystemTimeProvider provider = (SystemTimeProvider) SystemRepository.getObject("systemTimeProvider");
Date now = provider.getDate();

3.2.9.5.1. 設定ファイルの例¶

この例では、下記のように本番用の設定ファイルにシーケンスオブジェクトの採番定義がされているとする。

<!-- シーケンスオブジェクトを使用した採番設定 -->
<component name="idGenerator" class="nablarch.common.idgenerator.OracleSequenceIdGenerator">
    <property name="idTable">
        <map>
            <entry key="1101" value="SEQ_1"/> <!-- ID1採番用 -->
            <entry key="1102" value="SEQ_2"/> <!-- ID2採番用 -->
            <entry key="1103" value="SEQ_3"/> <!-- ID3採番用 -->
            <entry key="1104" value="SEQ_4"/> <!-- ID4採番用 -->
        </map>
    </property>
</component>

この場合、テスト用の設定ファイルでは、上記本番用の設定をテーブル採番用の設定で上書きする。

<!-- シーケンスオブジェクトの採番設定をテーブルを使用した採番設定に置き換える -->
<component name="idGenerator" class="nablarch.common.idgenerator.FastTableIdGenerator">
    <property name="tableName" value="TEST_SBN_TBL"/>
    <property name="idColumnName" value="ID_COL"/>
    <property name="noColumnName" value="NO_COL"/>
    <property name="dbTransactionManager" ref="dbTransactionManager" / >
</component>

補足

テーブル採番用の設定値の詳細は、IdGeneratorを参照すること。

3.2.9.5.2. Excelファイル記述例¶

採番対象ID:1101を採番する処理をテストする場合を例に説明する。

// 準備データ

// 採番用テーブル

SETUP_TABLE=TEST_SBN_TBL

ID_COL	NO_COL
1101	100

補足

採番用テーブルに準備データを設定する。 準備データでは、テスト範囲内で使用する採番対象のレコードのみを設定する。

// 期待値

// 採番用テーブル

EXPECTED_TABLE=TEST_SBN_TBL

ID_COL	NO_COL
1101	101

// 期待値

// 採番した値が登録されるテーブル(USER_IDに採番された値が登録される。)

EXPECTED_TABLE=USER_INFO

USER_ID	KANJI_NAME	KANA_NAME
0000000101	漢字名	ｶﾅﾒｲ

補足

本記述例では、テスト内で1度のみ採番処理が行われていることを想定している。 このため、期待値は「準備データの値 + 1」となっている。

3.2.9.6.1. テストソースコード実装例¶

public class DbAccessTestSample extends DbAccessTestSupport {
    // ＜中略＞
    @Test
    public void testInsert() {
        // ThreadContextに値を設定する（シート名、IDを指定）
        setThreadContextValues("testSelect", "threadContext");

       // ＜後略＞

3.2.9.6.2. テストデータ記述例¶

シート[testInsert]に以下のようにデータを記載する。(IDは任意）

LIST_MAP=threadContext

3.2.9.7.1. テストソースコード実装例¶

TestDataParser parser = (TestDataParser) SystemRepository.getObject("testDataParser");
List<Map<String, String>> list = parser.getListMap("/foo/bar/Baz.xlsx", "sheet001", "params");

3.2.9.8.1. 注意事項¶

上記のアノテーションを利用する際は、以下の点に注意すること。

3.2.9.10.1. テストソースコード実装例¶

public class SampleTest extends AnotherSuperClass {

    /** DbAccessテストサポート */
    private DbAccessTestSupport dbSupport
          = new DbAccessTestSupport(getClass());

    /** 前処理 */
    @Before
    public void setUp() {
        // DbSupportの前処理を起動
        dbSupport.beginTransactions();
    }

    /** 後処理 */
    @After
    public void tearDown() {
        // DbSupportの後処理を起動
        dbSupport.endTransactions();
    }

    @Test
    public void test() {
        // データベースに準備データ投入
        dbSupport.setUpDb("test");

        // ＜中略＞
        dbSupport.assertSqlResultSetEquals("test", "id", actual);
    }
}

3.2.9.11.1. テストソースコード実装例¶

public class UserUpdateActionRequestTest extends HttpRequestTestSupport {

    @Test
    public void testRW11AC0301Normal() {
        execute("testRW11AC0301Normal", new BasicAdvice() {
            @Override
            public void afterExecute(TestCaseInfo testCaseInfo,
                    ExecutionContext context) {
                String message = testCaseInfo.getTestCaseName();
                String sheetName = testCaseInfo.getSheetName();

                UserForm form = (UserForm) context.getRequestScopedVar("user_form");
                UsersEntity users = form.getUsers();

                // users のプロパティ kanjiName,kanaName,mailAddress を検証。
                assertObjectPropertyEquals(message, sheetName, "expectedUsers", users);
            }
        }
    }

3.2.9.11.2. Excelファイル記述例¶

LIST_MAP=expectedUsers

3.2.9.16.1. 実装するインタフェース¶

• nablarch.test.core.file.TestDataConverter

3.2.9.16.2. システムリポジトリ登録内容¶

3.2.9.16.3. システムリポジトリ登録例¶

<!-- テストデータコンバータ定義 -->
<component name="TestDataConverter_FormUrlEncoded"
           class="please.change.me.test.core.file.FormUrlEncodedTestDataConverter"/>

3.2.9.16.4. Excelファイル記述例¶

上記で指定したコンバータでセル内の各データにURLエンコーディングを行うように実装した場合、 テストフレームワーク内部では以下のデータを記述した場合と同様に扱われる。