テスト対象のメソッドを呼び出して結果をチェックする

新人と先輩の会話形式で理解しよう

新人

「Springのテストを書いていると、メソッドを呼び出して結果を確認するって言われるんですが、正直どこまでやればいいのか分からなくて……」

先輩

「最初はそう感じますよね。でも実は、テストでやることはとてもシンプルなんです。」

新人

「シンプル、ですか？テストって難しいイメージしかなくて……」

先輩

「テストは、対象のメソッドを呼び出して、その結果を確認するだけです。その流れが分かれば大丈夫ですよ。」

1. テストでメソッドを呼び出すとはどういうことか

Springのテストと聞くと、何か特別なことをしなければならないように感じるかもしれません。しかし、超初心者の段階で意識してほしいのは、「テストでも、普段と同じようにメソッドを呼び出している」という点です。

普段のJavaプログラミングでは、クラスを作り、その中にメソッドを書き、必要な場面でそのメソッドを呼び出します。テストでも、この考え方は変わりません。テストクラスの中から、確認したいメソッドを呼び出すだけです。

PleiadesでSpringのプロジェクトを作成すると、 mainフォルダとは別にtestフォルダが用意されます。このtestフォルダの中にテストクラスを作り、そこからテスト対象のメソッドを呼び出します。これが「テストでメソッドを呼び出す」という意味です。

Spring テストメソッド呼び出しと聞くと難しそうですが、実際には「別のクラスからメソッドを使う」だけです。特別な魔法のようなことをしているわけではありません。この点を理解するだけで、テストへのハードルは一気に下がります。


@Controller
public class SampleService {

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

例えば、このようなメソッドがあるとします。普段のプログラムでは、このcalculateメソッドを呼び出して結果を使います。テストでも同じように、このメソッドを呼び出して、「返ってきた結果が正しいか」を確認します。


public class SampleServiceTest {

    public void testCalculate() {
        SampleService service = new SampleService();
        int result = service.calculate(2, 3);
        // resultの中身を確認する
    }
}

このように、テストでメソッドを呼び出すとは、「テストクラスから対象クラスを使ってメソッドを実行すること」だと考えてください。難しく考えず、普段のJavaの書き方と同じだと捉えることが大切です。

2. なぜメソッドの戻り値を確認する必要があるのか

では、なぜテストではメソッドを呼び出したあとに、その戻り値を確認する必要があるのでしょうか。それは、プログラムは「結果が正しいかどうか」が一番重要だからです。

メソッドは何かしらの処理を行い、その結果を返します。その結果が想定と違っていれば、プログラムは見た目上動いていても、中身は間違っている可能性があります。これを防ぐために、テストで結果をチェックします。

人の目で毎回確認するのは大変ですが、テストコードに「この結果になるはず」と書いておけば、プログラムが自動で確認してくれます。これが、JUnit メソッドテスト初心者の方にまず知ってほしいテストの価値です。

また、プログラムは一度作って終わりではありません。機能追加や修正を繰り返していく中で、以前は正しく動いていた処理が、知らないうちに壊れてしまうこともあります。戻り値を確認するテストがあれば、そうした問題にもすぐ気づくことができます。


@Controller
public class PriceService {

    public int getPriceWithTax(int price) {
        return price + 100;
    }
}

このメソッドは、価格に何かを加えて返す処理をしています。テストでは、この戻り値が「本当に想定通りの数字になっているか」を確認します。


public class PriceServiceTest {

    public void testGetPriceWithTax() {
        PriceService service = new PriceService();
        int result = service.getPriceWithTax(1000);
        // 期待した結果になっているかを確認する
    }
}

このように、メソッドの戻り値をチェックすることで、「この処理は正しく動いている」という安心感を得ることができます。テストは間違いを責めるものではなく、正しく動いていることを確認するためのものです。

初心者のうちは、「テストは難しい」「書き方が分からない」と感じることも多いと思います。しかし、「メソッドを呼び出して、結果を見るだけ」という考え方を持てば、テストは決して怖いものではありません。この基本をしっかり押さえておきましょう。

3. テストクラスから対象メソッドを呼び出す基本的な流れ

ここからは、テストクラスで実際にどのような流れでテスト対象のメソッドを呼び出すのかを整理していきます。 Springのテストと聞くと構えてしまいがちですが、流れを分解するととても単純です。

基本となる流れは、常に次の三つです。「メソッドを呼ぶ」「結果を受け取る」「その結果を確認する」この順番を何度も意識してください。 JUnit メソッド戻り値テストの基本は、すべてこの形に集約されます。

まず、テストクラスの中でテスト対象のクラスを用意します。 Pleiadesで作成したSpringプロジェクトでは、 mainフォルダに本番用クラス、 testフォルダにテストクラスを置く構成になっています。テストクラスから、本番クラスを使うイメージです。

次に、そのクラスの中にある確認したいメソッドを呼び出します。ここでは、処理の中身を深く考える必要はありません。「このメソッドを実行すると、どんな結果が返ってくるのか」という点だけに注目します。


@Controller
public class MessageService {

    public String getMessage() {
        return "hello";
    }
}

このようなメソッドがある場合、テストクラスでは次のような流れになります。


public class MessageServiceTest {

    public void testGetMessage() {
        MessageService service = new MessageService();
        String result = service.getMessage();
        // resultを確認する
    }
}

このコードの中でやっていることは、本番クラスを用意し、メソッドを呼び出し、戻ってきた結果を変数に入れているだけです。 Spring テスト結果確認の第一歩として、この流れを自然に書けるようになることが重要です。

4. 戻り値を変数で受け取って確認する考え方

テストでは、メソッドを呼び出した結果をそのまま放置することはほとんどありません。必ず一度、変数で受け取ります。これは、後から結果を確認するためです。

初心者の方は、「なぜわざわざ変数に入れるのか」と疑問に思うかもしれません。しかし、変数に入れることで、「今の結果はこれだ」と落ち着いて確認できるようになります。

テストはスピード勝負ではありません。正しく確認できる形にすることが大切です。戻り値を変数で受け取ることで、処理の流れが目で追いやすくなります。これが、実務未経験の初心者にとってとても大きな助けになります。


@Controller
public class CalculationService {

    public int multiply(int a, int b) {
        return a * b;
    }
}

このような計算メソッドがある場合、テストでは次のように書きます。


public class CalculationServiceTest {

    public void testMultiply() {
        CalculationService service = new CalculationService();
        int result = service.multiply(2, 4);
        // resultの値を使って確認を行う
    }
}

ここで重要なのは、「resultという変数に、計算結果が入っている」という事実をはっきりさせることです。そのうえで、「このresultは、想定通りの値か」を確認します。メソッドを呼ぶ、結果を受け取る、確認する、この流れを何度も繰り返し意識してください。

5. 想定した結果と実際の結果を比べる意味

テストで一番大切なのは、「想定した結果」と「実際の結果」を比べることです。メソッドを呼び出すだけでは、テストとしてはまだ不十分です。結果が正しいかどうかを判断して初めて、テストに意味が生まれます。

想定した結果とは、「この処理なら、この値になるはず」と自分が考えた答えです。実際の結果とは、メソッドを実行して返ってきた値です。この二つが一致しているかどうかを確認します。

Spring テスト結果確認では、この比較を行うことで、処理が壊れていないかを判断します。プログラムは後から修正されることが前提です。そのたびに、「前と同じ結果が出るか」を機械的に確認できるのがテストの強みです。


@Controller
public class DiscountService {

    public int applyDiscount(int price) {
        return price - 100;
    }
}


public class DiscountServiceTest {

    public void testApplyDiscount() {
        DiscountService service = new DiscountService();
        int actual = service.applyDiscount(1000);
        int expected = 900;
        // actualとexpectedを比べて確認する
    }
}

このように、期待している値を別の変数として用意すると、テストの意図がとても分かりやすくなります。「九百になるはずだ」という考えを、そのままコードに書いている状態です。

テストは、難しい仕組みを理解するためのものではありません。「メソッドを呼ぶ」「結果を受け取る」「想定と同じかを確認する」この流れを丁寧に積み重ねることが大切です。この考え方が身につけば、テストは少しずつ安心できる存在になっていきます。

6. メソッドの結果をテストで確認できると何が安心なのか

ここまで読んで、「メソッドを呼び出して結果を見る」という流れ自体は、少しずつイメージできてきたと思います。では、その確認ができるようになると、具体的に何が安心なのでしょうか。

一番大きいのは、「自分が書いた処理を信じすぎなくてよくなる」という点です。プログラムを書いていると、頭の中では正しく動いているつもりでも、実際には思い込みが入っていることがよくあります。テストは、その思い込みを静かにチェックしてくれます。

例えば、「この計算ならこの値になるはず」「この文字列が返ってくるはず」そう考えて書いた処理が、本当にその通りになっているかを、毎回自分の目で確認するのは大変です。 JUnit メソッドテスト基本を使えば、その確認を自動で任せることができます。

テストがあると、プログラムを実行した瞬間に、「結果は問題ない」あるいは「想定と違う」ということがすぐに分かります。これは、初心者にとって大きな安心材料です。不安なまま次の作業に進まなくて済むからです。


@Controller
public class GreetingService {

    public String greet(String name) {
        return "こんにちは" + name;
    }
}


public class GreetingServiceTest {

    public void testGreet() {
        GreetingService service = new GreetingService();
        String result = service.greet("太郎");
        // 期待したあいさつになっているかを確認する
    }
}

このように、メソッドの結果をテストで確認できる状態を作っておくと、「とりあえず動いているから大丈夫」ではなく、「確認したうえで大丈夫」という気持ちで作業を進められます。 Spring テスト初心者方法として、この安心感を得られることが、テストを書く一番の価値だと言えます。

7. 処理を修正してもテストで確認できるメリット

プログラムは、一度作ったら終わりではありません。機能の追加や仕様変更、表示内容の調整など、何度も手が入ります。そのたびに起こるのが、「別の部分が壊れていないか」という不安です。

テストがない場合、修正のたびに画面を操作したり、ログを見たりして、人の手で確認する必要があります。これは時間もかかり、見落としも起こりやすい方法です。

一方で、メソッドテストが用意されていれば、修正後にテストを実行するだけで、「前と同じ結果が出ているか」をすぐに確認できます。これが、Spring テスト初心者方法としてとても大きなメリットになります。

特に初心者のうちは、修正するたびに不安が増えがちです。しかし、「このテストが通っているから大丈夫」と思えるだけで、気持ちはかなり楽になります。


@Controller
public class ScoreService {

    public int addScore(int score) {
        return score + 10;
    }
}


public class ScoreServiceTest {

    public void testAddScore() {
        ScoreService service = new ScoreService();
        int result = service.addScore(50);
        // 修正後も同じ結果になるかを確認する
    }
}

仮にこのメソッドの中身を修正したとしても、テストがあれば、「結果が変わっていないか」「意図せず動きが変わっていないか」をすぐにチェックできます。テストは、修正作業のたびに自分を守ってくれる存在です。

JUnit メソッドテスト基本を身につけることで、修正に対する怖さが少しずつ減っていきます。これは、実務に進んだときにも必ず役に立つ感覚です。

8. 初心者が最初に押さえておきたいメソッドテストの考え方

最後に、初心者の段階でぜひ押さえておいてほしいメソッドテストの考え方を整理します。難しいルールや細かい書き方よりも、大切なのは考え方そのものです。

メソッドテストは、「正しさを証明する試験」ではありません。「自分の考えと結果が合っているかを確認する作業」です。この認識を持つだけで、テストに対する印象は大きく変わります。

まずは、一つのメソッドに対して、一つの結果を確認できれば十分です。完璧なテストを書こうとしなくて構いません。メソッドを呼ぶ、結果を受け取る、想定と比べる、この流れが書けていれば合格です。

Spring テスト初心者方法として意識してほしいのは、「テストは確認作業」という立ち位置です。テストを書くことで、自分の理解が間違っていないかを一つ一つ確かめていく、その積み重ねが大切です。


@Controller
public class LengthService {

    public int getLength(String text) {
        return text.length();
    }
}


public class LengthServiceTest {

    public void testGetLength() {
        LengthService service = new LengthService();
        int result = service.getLength("java");
        // 文字数が想定通りかを確認する
    }
}

このようなシンプルなテストでも、「メソッドテストの全体像」はしっかり含まれています。最初は小さな確認で構いません。確認できたという経験を積み重ねることで、テストは少しずつ自然な作業になっていきます。

テストは特別な人のための技術ではありません。自分の書いたコードを安心して使うための、とても身近な確認手段です。この感覚を持てたなら、メソッドテストの第一歩はすでに踏み出せています。