JUnitで使用可能なアノテーションの種類についてまとめておきます。
| アノテーション | 用途 |
|---|---|
| @Before | メソッド単位で事前実行する |
| @BeforeClass | テストクラスで一回だけ事前実行 |
| @After | メソッド単位で事後実行する |
| @AfterClass | テストクラスで一回だけ事後実行 |
| @Rule | テスト時における一時的なルールの作成 |
| @ClassRule | 複数のテストを通じてのルール設定 |
| @Test | テストメソッドの指定 |
| @Ignore | 一時的にテスト対象外メソッドを指定 |
業務でSQLを使用する場合、必ず使用する事になると言って良いのがテーブルの結合処理です。WEB系システムの場合、そのほとんどはRDBMSを使用してますのでテーブルが一つだけなどという事はまずありえません。複数のテーブルからその時々に応じて必要なデータを取得し使用するのが常です。その際に重要になるポイントの一つが内部結合と外部結合です。
| 商品テーブル「goods」 | 属性コードテーブル「type_code」 |
|---|---|
 |  |
|
1 2 3 4 |
SELECT goods.type_code, goods.name, type_code.code_name FROM goods INNER JOIN type_code ON goods.type_code = type_code.code; |
|
1 2 3 4 |
SELECT goods.type_code, goods.name, type_code.code_name FROM goods LEFT OUTER JOIN type_code ON goods.type_code = type_code.code; |
Web系の開発していると画面表示確認する際に、「cssやjsは変更したのに画面を表示してみると反映されていない」という事を経験した方は少なくないと思います。
こういう場合はまず、F5もしくはctrl+F5を押下して画面を再表示（リロード）確認すると思いますが、そもそも「F5単独」押下と「ctrl+F5同時」押下では何が違うんだろう？という事についてメモしておきます。
 |
 |
|
上記で説明している「更新ボタン」ですが、以下の様にブラウザのアドレスバー付近に表示されている以下のような赤枠内のボタンのことを「更新ボタン」と記載しております。
junitでexceptionが発生した事の確認テストはどのようにすれば良いかメモしておきます。
exceptionの発生確認は@Test内に「(expected = [確認したいExceptionクラス])」を指定する事で簡単に確認する事が出来ます。
|
1 2 3 4 5 6 7 8 9 |
@Test(expected = IndexOutOfBoundsException.class) public void testIndexOutOfBoundsException() { // 準備 List<String> test = new ArrayList<String>(); test.add("abc"); // 実行 test.get(1); } |
ちょっとdjUnitで「addReturnValue」を使用しても全く効いてない？という事象に少しハマっていたので原因についてメモしておきます。
addReturnValueが効かない原因として上げられるのが概ね以下の3つになるかと思います。1と2については少し見なおせばすぐ発見出来そうですが、今回ハマった原因が3でした。。。
では「指定したメソッドが複数回実行されている」というのはどういう事かというとについて説明します。
根本的な話として以下の2つのコードは全く同じ意味という事を理解しておく必要があります。
|
1 2 |
addReturnValue(UtilClass1.class, "getStr", expected1); setReturnValueAt(UtilClass1.class, "getStr", 0, expected1); |
これだけで気づく方はハッと思うかもしれませんが、ここで重要なのはaddReturnValueでは「1回目に実行」されたメソッドのみしかaddReturnValueで指定した値が返ってこないという事です。つまり「setReturnValueAt」で1回目を指定した場合と同様の動きしかしてくれないのです。
今回私がハマったのは指定したメソッドが想定した箇所よりも手前で事前に実行されていた為、想定したいたメソッドは2回目の実行になっていたために2回目の方にはaddReturnValueが効いていなかったという事象でした。
addReturnValueをしてクラス名やメソッド名は正しいのにどうも効いていないように見える時は一度「getCallCount」でメソッドの実行回数を調査して見ると良いかもしれません。
djUnitではメソッドが呼び出されている事の確認は「assertCalled」を使用する事で確認出来ましたが、逆にメソッドを呼び出されていない事の確認では「assertNotCalled」を使用する事で確認出来ます。
|
1 2 3 4 5 6 7 8 9 |
/** * <p>[概 要] メソッド呼出サンプル確認用</p> * <p>[詳 細] </p> * <p>[備 考] </p> */ public static void sample1(){ String strEscape = htmlEscape("sample1-1"); String strEncode = urlEncode("sample1-2", "sample1-3"); } |
|
1 2 3 4 5 6 7 8 |
@Test public void testSample1_2() { // 実行 UtilSample1.sample1(); // 検証 assertNotCalled(UtilSample1.class, "getDiffDays"); } |
djUnitではassertCalledを使用する事でメソッドが呼び出された事が確認出来ます。
|
1 2 3 4 5 6 7 8 9 |
/** * <p>[概 要] メソッド呼出サンプル確認用</p> * <p>[詳 細] </p> * <p>[備 考] </p> */ public static void sample1(){ String strEscape = htmlEscape("sample1-1"); String strEncode = urlEncode("sample1-2", "sample1-3"); } |
|
1 2 3 4 5 6 7 8 9 |
@Test public void testSample1() { // 実行 UtilSample1.sample1(); // 検証 assertCalled(UtilSample1.class, "htmlEscape"); assertCalled(UtilSample1.class, "urlEncode"); } |
以下の様に「getCallCount」を使用する事でメソッドが何回呼び出されたかを確認する事も出来ます。
|
1 2 |
int countHtmlEscape = getCallCount(UtilSample1.class, "htmlEscape"); assertEquals(10, countHtmlEscape); |
djUnitでテストする際に、一部のメソッドは特に実行する必要はないけどそのメソッドの処理はスルーさせたいケースがたまに発生します。こういう場合にはdjUnitのaddReturnValue機能を活用する事でそのメソッドの処理を無効化する事が出来ます。
通常addReturnValueはメソッドの戻り値を好みの値に変更する際に使用しますが、戻り値なし（void）のメソッドの時には通常使用しません。それでも戻り値なしのメソッドをaddReturnValueで指定するとそのメソッドが実行されずメソッドの処理を無効化する事が出来ます。
ただし、この方法は戻り値なし（void）のメソッドにしか活用出来ませんのでご注意下さい。
|
1 2 3 4 5 6 7 8 9 |
/** * <p>[概 要] メソッド無効化サンプル確認用</p> * <p>[詳 細] </p> * <p>[備 考] </p> * @param String 文字列 */ public static void sample1(String str){ System.out.println(str); } |
|
1 2 3 4 5 6 7 8 |
@Test public void testSample1() { // 準備：メソッドの無効化 addReturnValue(UtilSample1.class, "sample1"); // 実行 UtilSample1.sample1("sample1メソッドが実行されました"); } |
djUnitでメソッドの返却値を好みのものに変更する場合は「addReturnValue」メソッドを使用しますが、
同一メソッドを複数回使用していてそれぞれ別々の戻り値に変更したい場合には「setReturnValueAt」メソッドを使用します。
|
1 2 3 4 5 6 7 8 9 10 11 |
public class UtilClass1{ /** * <p>[概 要] サンプルメソッド</p> * <p>[詳 細] </p> * <p>[備 考] </p> * @return 文字列 */ public static String getStr(){ return "hoge"; } } |
|
1 2 3 4 5 6 7 8 9 10 11 |
public class DriverClass1{ /** * <p>[概 要] ドライバーメソッド</p> * <p>[詳 細] </p> * <p>[備 考] </p> */ public static void driverMethod1(){ System.out.println(UtilClass1.getStr()); System.out.println(UtilClass1.getStr()); } } |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
import jp.co.dgic.testing.framework.DJUnitTestCase; import org.junit.Test; public class UtilClassDjUnitTest extends DJUnitTestCase { @Test public void testGetStr2() { // 準備：getStrメソッドの返却値を1回目と2回目で別々の戻り値に変更します。 String expected1 = "test1"; String expected2 = "test2"; setReturnValueAt(UtilClass1.class, "getStr", 0, expected1); setReturnValueAt(UtilClass1.class, "getStr", 1, expected2); // 実行 DriverClass1.driverMethod1(); } } |
|
1 2 |
test1 test2 |
djUnitを使用する上での最大の利点と言っても良いのがVirtual Mock Objects（仮想モックオブジェクト）が使用出来る事です。
このVirtual Mock Objectsを使用すると作成したクラスでUtilクラスなどのメソッドを使用している場合、使用しているメソッドの戻り値を自由に変更する事が可能となります。
djUnitでメソッドの返却値を好みのものに変更する場合は「addReturnValue」メソッドを使用します。
「addReturnValue」メソッドの使用タイミングとしては、作成したクラスで使用している共通クラスのメソッドなどが未完成の場合でスタブが必要になるケースなどが考えられます。
|
1 2 3 4 5 6 7 8 9 10 11 |
public class UtilClass1{ /** * <p>[概 要] サンプルメソッド</p> * <p>[詳 細] </p> * <p>[備 考] </p> * @return 文字列 */ public static String getStr(){ return "hoge"; } } |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
import jp.co.dgic.testing.framework.DJUnitTestCase; import org.junit.Test; public class UtilClassDjUnitTest extends DJUnitTestCase { @Test public void testGetStr() { // 準備：getStrメソッドの返却値を好みのものに変更します。 String expected = "test"; addReturnValue(UtilClass1.class, "getStr", expected); // 実行 String result = UtilClass1.getStr(); // 検証 assertEquals("文字列が一致していません。", expected, result); } } |
