こんにちは。たいら(@tairaengineer2)です。
転職を繰り返し現在5社経験している、15年目エンジニアです。
この記事では、 Javaのテストで使用するJUnitにあるassertNullメソッドについて
- assertNullメソッドとは
- assertNullメソッドを使ったサンプルプログラム
と、丁寧に解説していきます。
前提条件：実行環境について
実行環境は以下の通りです。
| OS | Windows11 |
|---|---|
| IntelliJ IDEAのエディション | Community(無料版) |
| IntelliJ IDEAのバージョン | 2023.2 |
| プロジェクト | Javaプロジェクト |
| SDK | openjdk-24 |
| JUnitのバージョン | JUnit5 |
Javaを動かすためにIntelliJ IDEAを使っています。
IntelliJ IDEAのインストールは、下の記事をご参考ください。
assertNullメソッドとは
assertNullメソッドとは、第一引数に指定した値がNullかどうかをテストするメソッドです。
使うためには
|
1 |
import static org.junit.jupiter.api.Assertions.assertNull; |
を宣言しておく必要があります。
使い方サンプルは、以下になります。
|
1 |
assertNull(null); |
assertNullメソッドは、第二引数も指定することができます。
第二引数は、第一引数がNullでないときに表示されるエラーメッセージです。
では、次の章で実際に使ってみます。
assertNullメソッドを解説するプログラムの概要
assertNullメソッドを解説するプログラムでは、以下の
- 第一引数にNull
- 第一引数に文字列と第二引数にエラーメッセージ
- 第一引数に空文字
テストメソッドを3つ用意します。
実行したらどうなるかを確認します。
JUnitテストプログラムは「SampleTest.java」です。
JUnitテストサンプルプログラム
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
import org.junit.jupiter.api.Test; import static org.junit.jupiter.api.Assertions.assertNull; public class SampleTest { @Test void test_null() { assertNull(null); } @Test void test_notnull() { assertNull("aaa", "nullではありません"); } @Test void test_empty() { assertNull(""); } } |
実行結果
JUnitテストプログラムを実行します。
実行のやり方は
- プログラムを右クリックして実行
- 実行タブから実行
- ガターから実行
の3種類あるので、いずれかで実行します。
詳しい解説は以下の記事をご参考ください。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
org.opentest4j.AssertionFailedError: nullではありません ==> 予想:null 実際:aaa （中略） org.opentest4j.AssertionFailedError: 予想:null 実際: （中略） プロセスは終了コード -1 で終了しました |
1つ目のテストメソッドは成功と判定されて、2つ目と3つ目のテストメソッドは失敗で、2つ目は指定したエラーメッセージが表示されていることが確認できました。
まとめ：assertNullを使ってみよう！
以上がJUnitのassertNullについての解説でした！
あなたのご参考になったのなら、とても嬉しいです(*´▽｀*)
ではでは～(・ω・)ﾉｼ
コメント