Javaでユニットテストを書くときの注意点｜初心者でも失敗しないテスト設計の考え方

はじめに
ユニットテストとは何か
なぜ Java ではユニットテストが重要なのか
Java でユニットテストを書くときの注意点
Java のユニットテスト例
外部依存はテストしない
ユニットテストは最初から完璧を目指さない
Java プログラマーを目指すなら必須の考え方
まずは自己学習から始めよう
それでも不安な人へ
まとめ

はじめに

Java で開発をしていると、必ずと言っていいほど出てくるのが ユニットテスト です。
「テストは大事と聞くけど、正直よく分からない」
「とりあえず動けばいいコードを書いてしまう」

そんな悩みを持つ人はとても多いです。

実は、ユニットテストは Java プログラマーとして成長するための近道 でもあります。
この記事では、プログラミング初心者でも理解できるように、
Java でユニットテストを書くときの注意点 をやさしく解説します。

ユニットテストとは何か

ユニットテストとは、
プログラムの小さな部品が正しく動くかを確認するテスト です。

Java でいうと

メソッド
クラスの処理

といった単位をチェックします。

大きなシステムを一気に確認するのではなく、
「この処理だけは絶対に正しい」
という安心を積み重ねていくイメージです。

なぜ Java ではユニットテストが重要なのか

Java は

業務システム
大規模開発
長期間運用されるシステム

で使われることが多い言語です。

そのため

修正による影響範囲が広い
人が入れ替わる
何年もコードが使われ続ける

という状況が当たり前に起こります。

ユニットテストがあると

修正しても安心
コードの品質が安定する
引き継ぎが楽になる

というメリットがあります。
これは Java の強みを最大限に活かすために欠かせない技術 です。

Java でユニットテストを書くときの注意点

テストは小さく書く

一つのテストでは 一つのことだけ を確認します。

良くない例

複数の処理をまとめてテストする

良い例

足し算だけを確認
引き算だけを確認

小さく書くことで

失敗した原因がすぐ分かる
テストが読みやすい

という効果があります。

テスト同士を依存させない

あるテストの結果に、別のテストが依存してはいけません。

例えば

先に実行されたテストが成功しないと失敗する
実行順で結果が変わる

これはとても危険です。

ユニットテストは
どれを単独で実行しても成功する状態
を目指しましょう。

テスト名は説明文のつもりで書く

テスト名を見ただけで
「何を確認しているテストか」
が分かるのが理想です。

テストコードは
未来の自分やチームメンバーへの説明書
になります。

Java の現場では
「テストを読めば仕様が分かる」
という状態がとても評価されます。

テストの中にロジックを書きすぎない

テストコードの中に

if 文
複雑な計算

を書いてしまうと、本末転倒です。

テストは

準備
実行
確認

だけに集中しましょう。

テストが複雑になるほど
「テストが正しいのか分からない」
状態になります。

期待する結果をはっきり書く

Java のユニットテストでは
「こうなるはず」という 期待値 を明確にします。

あいまいなチェックは

バグを見逃す
テストの意味がなくなる

原因になります。

Java のユニットテスト例

とてもシンプルな例を見てみましょう。

public class Calculator {

    public int add(int a, int b) {
        return a + b;
    }
}

このクラスに対するテストです。

import static org.junit.jupiter.api.Assertions.*;
import org.junit.jupiter.api.Test;

public class CalculatorTest {

    @Test
    void addは二つの値を足した結果を返す() {
        Calculator calculator = new Calculator();
        int result = calculator.add(three, two);
        assertEquals(five, result);
    }
}

このように