Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

・テストメソッド作成

Util#checkUserData メソッドをテストするメソッドを作成します。

...

  1. ソースコードペインで Util#checkUserData メソッドを開きます。

...


  1. Image Added

...


  1. Util#checkUserData メソッドは User クラスの引数を持つメソッドのためテストの実行には User クラスを構成する要素をテストデータとして用意する必要があります。

...

  1. Userクラスは以下の要素にそれぞれの getter/setter メソッドを持つ構成です。

    Code Block
    themeEclipse
    /**

...

  1. 
    * ユーザー名を保存します。

...

  1. 
     */

...

  1. 
    private String name;

...

  1. 
    
    /**

...

/**
 * ユーザーの住所を保存します。
 */
private String address;

/**
 * ユーザーのメールアドレスを保存します。
 */
private String email;

/**
 * ユーザーの電話番号を保存します。
 */
private String phone;

...

  1. 
     * ユーザーIDを保存します。
     */
    private String userId;
    
    /**
     * ユーザーの住所を保存します。
     */
    private String address;
    
    /**
     * ユーザーのメールアドレスを保存します。
     */
    private String email;
    
    /**
     * ユーザーの電話番号を保存します。
     */
    private String phone;


  2. ソースコードペインで Util#checkUserData(User) メソッドを選択し、単体テストアシスタントビューで Image Modified をクリックします。

...


  1. Image Added

...


  1. 起動した設定画面で以下の設定を確認します。※赤字が設定する値となります

...


  1. ● テストケースの追加:パラメータライズ

...

  1. 作成するテストケースの形式をラジオボタンで選択します。

       ○ 通常:通常のテストケースを作成します。

       ○ パラメータライズ:パラメータライズされたテストケースを作成します。

       ○ Cobined:異なるデータでテストした場合に結果が変わるメソッドの場合にパラメータライズされたテストケースを作成します。
         結果が変わらないメソッドの場合は通常のテストケースを作成します。

...

  1. ● 1 つのテストケースに対して作成されるパラメータセットの最大数(デフォルト5)1

...

  1. パラメータライズテストケースの生成時に Jtest が自動で生成するテストデータの最大個数を定義します。

...

  1. テストデータはパラメータの型ごとに以下の画面から設定することができます。

...

  1. 1) メニューの [Parasoft] > [設定] を選択して設定ダイアログを開きます。

...

  1. 2) [Parasoft] > [単体テスト アシスタント] を選択します。

...

  1. 3) パラメータライズされたテストタイプ で パラメータライズの設定を押下します。

        

...

  1. Image Added

...

  1. 4) 起動する パラメータライズの設定画面で型ごとにデフォルトのテストデータとして使用するデータを登録します。

...

  1.  (本チュートリアルではデフォルトを変更せず実行してください。)

        Image Modified

...

  1. ● データの生成先:Code

...

  1. パラメータライズテストケースの生成時にテストデータを、以下のどちらに定義するかをリストボックスから選択します。

...

  1.  ○ Code : ソースコード内にテストデータを定義します。

...

  1.  ○ CSV : プロジェクトに CSV ファイルを追加し、CSV ファイル内にテストデータを定義します。

...

  1. ● 作成されたテストの実行タイムアウト(ミリ秒):チェックボックスをOFF

...

  1. 一連のテストを実行するための制限時間(ミリ秒単位)を指定します。

...

  1. 制限時間を超えるとテスト実行が停止し、テストは失敗します。

    設定画面例)

    Image Modified

...


  1. 設定画面で “OK” ボタンを押下します。

...


  1. UTA プロジェクトの tests フォルダにUtilParameterizedTest.javaが作成されたことを確認します。
       (CSV ファイルベースのテストメソッド作成』で既にテストクラスを作成している場合はメソッドが追加されます。

...


Image Removed

...


  1. UtilParameterizedTest.java

...

  1. には2つのテストメソッドテンプレートが作成されます。
       (テストメソッド名は連番で付けられるため本チュートリアルの実施順によって異なります。)
    • testCheckUserData()
    • testCheckUserData_Parameters()

・テストメソッドの確認

...

  1. testCheckUserData() の確認
    生成された testCheckUserData() を確認します。

    Code Block
    theme

@Test

  1. Eclipse
    @Test   // @Parameters アノテーションでテストデータを取得するメソッドを定義
    @Parameters(method = "testCheckUserData_Parameters")

...

  1. 
    public void testCheckUserData(

...

  1. 		// テストメソッド
    String getAddressResult,

...

  1.  
    String getEmailResult,

...

  1.  
    String getNameResult,

...

  1. 
    String getPhoneResult,

...

  1.  
    String getUserIdResult) throws Throwable

...

  1.  {
    
    	Util underTest = new Util();

...

テストインスタンスの生成

...

  1. 		// テストインスタンスの生成
    
    	User user = mock(User.class);

...

  1. 		// checkUserDataの引数 User のモックオブジェクト呼び出し
    
    	when(user.getAddress()).thenReturn(getAddressResult);

...

  1. 
    
    	when(user.getEmail()).thenReturn(getEmailResult);

...

  1. 
    	
    	when(user.getName()).thenReturn(getNameResult);

...

  1. 
    
    	when(user.getPhone()).thenReturn(getPhoneResult);

...

  1. 
    
    	when(user.getUserId()).thenReturn(getUserIdResult);

...

checkUserDataの引数 User のモックオブジェクト呼び出し

...

  1. 
    
    	boolean result = underTest.checkUserData(user);

...

  1. 		// getItemDB メソッドの呼び出し

...

  1. 
    
    	// assertEquals(expected, result);

...

  1. 					// getItemDB の戻り値のチェック用アサーションテンプレート
    
    }

...


  1. testCheckUserData_Parameters() の確認
    生成された testCheckUserData_Parameters() を確認します。

    Code Block
    @SuppressWarnings("unused")

...

  1. 
    private static Object[][] testCheckUserData_Parameters() throws Throwable {

...

  1. 	// データメソッド
    // パラメータ: getAddressResult={0}, 
    getEmailResult={1}, getNameResult={2}, 
    getPhoneResult={3}, getUserIdResult={4}

...

  1. 
    
    return new Object[][] { { "", "", " ", null, "01234567890…" }};

...

テストデータを返却するコード

  1. 	//テストデータを返却するコード
    
    }


・テストデータ編集

作成されたテストデータメソッド、テストメソッドにはアサーション情報が定義されていないため、テストケースごとに期待値となるデータを追加するための設定を行います。

...

  1. testCheckUserData() の編集

    UtilParameterizedTest#testCheckUserData() の引数に期待値用の変数を追加します。

    Code Block
    themeEclipse
    変更前

...

  1. 
    public void testCheckUserData(

...

  1. 
    String getAddressResult,

...

  1.  
    String getEmailResult,

...

  1.  
    String getNameResult,

...

  1. 
    String getPhoneResult,

...

  1.  
    String getUserIdResult) throws Throwable

...

public void testCheckUserData(

String getAddressResult,
String getEmailResult,
String getNameResult,
String getPhoneResult,

...

変更後のファイルを保存し、プロジェクトのビルドが正常に行われることを確認します。

...

  1.  {
    						▼
    変更後
    public void testCheckUserData(
    String getAddressResult, 
    String getEmailResult, 
    String getNameResult,
    String getPhoneResult, 
    String getUserIdResult,
    boolean expected		// Boolean 型の引数を追加
    ) throws Throwable {
    

    変更後のファイルを保存し、プロジェクトのビルドが正常に行われることを確認します。

  2. testCheckUserData_Parameters () の編集
    テストデータを変更します。

    Code Block
    変更前 (改行済み)

...

  1. 
    return new Object[][] {

...

  1.  
    { "", "", " ", null, "01234567890…" }

...

  1. 
    };

...

  1. 
    				▼
    変更後
    return new Object[][] {

...

  1. 
    { "", "", " ", null, "01234567890…", false},

...

  1. 			// boolean型の引数を追加
    {"address", "email", "name", "phone", "userId", true}

...

  1. 	// 新規テストケースを追加
    };

...

boolean型の引数を追加

...


・テスト実行と結果確認

作成したテストメソッドを実行します。
ソースコードペインでUtilParameterizedTest#testCheckUserData メソッドを選択し、単体テストアシスタントビューで  Image Modifiedを押下します。

...


Image Added

実行後、JUnit ビューで 2 テストケースが実行されていることを確認します。

...


Image Added

単体テストアシスタントビューと変数ビューを使って、実行したテストケースと入力されたテストデータが正しく渡されていることを確認します。

単体テストアシスタントビューで任意のテストケースを展開し、UtilParameterizedTest.testCheckUserData (String,String,String,String,String,boolean) を選択すると
変数タブにテストデータメソッドから取得したテストデータの値が表示されます。

...


Image Added

更にテストケースの実行フローを展開するとモックに置き換わった User クラスの各メソッドが呼び出されたときに戻されるデータを確認することができます。

...


Image Added