Spring MVCで使う@GetMappingと@PostMappingの基本操作を徹底解説！初心者向けHTTPメソッド入門

Spring MVCで使う @GetMapping / @PostMapping の基本操作（HTTPメソッド入門）

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

新人

「Spring MVCで画面を作っていたら@GetMappingとか@PostMappingが出てきたんですが、正直どう使い分けるのか分からなくなりました。」

先輩

「Spring MVCではHTTPメソッドの考え方がとても大切です。GetMappingとPostMappingは、その入口になります。」

新人

「HTTPメソッドって聞いたことはありますが、Web画面とどう関係しているんですか？」

先輩

「まずはSpring MVCとHTTPメソッドの基本から整理していきましょう。順番に見ていくと分かりやすくなりますよ。」

1. Spring MVCとは何か（Webアプリ開発における役割）

Spring MVCとは、Javaを使ってWebアプリケーションを作成するためのフレームワークです。Spring Frameworkの中でも、特に「画面を表示する処理」や「ブラウザから送られてきたリクエストを受け取る処理」を担当する仕組みとして、多くの開発現場で利用されています。初心者がSpring MVCを学ぶときは、まず「ブラウザとJavaプログラムの橋渡し役をしている」という点を意識すると理解しやすくなります。

Webアプリでは、ユーザーがブラウザからURLにアクセスすると、その情報がサーバーに送られ、Javaのプログラムが動きます。そして処理結果としてHTMLが作られ、再びブラウザに返されます。Spring MVCは、この一連の流れを整理し、役割ごとに分けて実装できるようにしてくれる仕組みです。

Pleiadesを使ってSpring MVCのプロジェクトを作成すると、Webアプリ開発に必要な設定が最初から整った状態になります。Gradleを使った構成のため、必要なライブラリもPleiadesのチェック操作だけで追加でき、プログラミング未経験者でも環境構築でつまずきにくい点が特徴です。

Spring MVCでは、画面表示の処理を担当するクラスをコントローラと呼びます。コントローラには@Controllerアノテーションを付けることで、「このクラスはWeb画面を制御する役割を持つ」ということをSpringに伝えます。

以下は、最もシンプルなSpring MVCのコントローラ例です。ブラウザからアクセスされたときに、指定した画面名を返すだけの処理になっています。


@Controller
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "hello";
    }
}

この例では、「/hello」というURLにアクセスすると、helloという名前の画面が表示されます。難しい処理は一切なく、「URLにアクセスすると画面が返ってくる」というWebアプリの基本的な動きを体験できます。本記事では、このような画面表示を中心に、Spring MVCの基本を分かりやすく解説していきます。

2. HTTPメソッドとは何か（GETとPOSTの基本的な考え方）

HTTPメソッドとは、ブラウザとサーバーが通信するときに「このアクセスは何をしたいのか」をサーバー側に伝えるためのルールです。Spring MVCで@GetMappingや@PostMappingを正しく理解するためには、このHTTPメソッドの役割をしっかり押さえておく必要があります。

代表的なHTTPメソッドがGETとPOSTです。GETは「画面を表示したい」「情報を確認したい」といった目的で使われます。実際に、ブラウザのアドレスバーにURLを入力してページを開く操作は、すべてGETリクエストとしてサーバーに送られています。

一方でPOSTは、「入力した内容を送信したい」「登録や更新をしたい」といった目的で使われます。問い合わせフォームや会員登録画面で、入力内容を送信する場面をイメージすると分かりやすいでしょう。このとき、ブラウザはPOSTリクエストを使ってサーバーにデータを送っています。

初心者の方は、GETとPOSTの違いを難しく感じがちですが、「画面を見るためのアクセスがGET」「何かを送る操作がPOST」と覚えると理解しやすくなります。この考え方は、Spring MVCで画面遷移を設計するときの土台になります。

例えば、次のような非常にシンプルなHTMLを考えてみましょう。ボタンを押すだけでサーバーにアクセスする仕組みです。


<form action="/sample" method="get">
    <button type="submit">画面を表示する</button>
</form>

<form action="/sample" method="post">
    <button type="submit">データを送信する</button>
</form>

同じ「/sample」というURLでも、methodがgetかpostかによって、ブラウザが送るリクエストの意味はまったく変わります。Spring MVCでは、この違いを@GetMappingと@PostMappingで受け分けることができます。

HTTPメソッドを意識せずに開発を進めてしまうと、「URLは合っているのに画面が表示されない」「処理が実行されない」といった原因不明の問題に直面しやすくなります。そのため、GETとPOSTの基本的な役割をこの段階でしっかり理解しておくことが、Spring MVC初心者にとってとても重要です。

3. Spring MVCでHTTPメソッドを扱う理由

Spring MVCでHTTPメソッドを扱う理由は、Webアプリの動きを安全かつ分かりやすく整理するためです。同じURLであっても、GETとPOSTでは意味が異なる場合があります。Spring MVCでは、この違いを明確にすることで、処理の役割をはっきりさせることができます。

例えば、画面を表示する処理と、入力内容を送信する処理を同じURLで扱うケースは珍しくありません。そのときにHTTPメソッドを使い分けることで、「表示用の処理」「登録用の処理」を分離できます。これにより、コードの可読性が向上し、初心者でも処理の流れを追いやすくなります。

Spring MVCでは、@GetMappingや@PostMappingを使うことで、「このメソッドはGET専用」「このメソッドはPOST専用」という意図をコード上で明確に表現できます。これは、@RequestMappingをHTTPメソッドごとに分かりやすくした仕組みだと考えると理解しやすいです。

HTTPメソッドを正しく扱うことで、画面遷移の設計が整理され、後からコードを見返したときにも迷いにくくなります。Spring MVC初心者の方は、まず「なぜHTTPメソッドを分けるのか」という考え方をしっかり身に付けることが重要です。

4. @GetMappingとは何か（GETリクエストの役割）

@GetMappingは、Spring MVCでGETリクエストを受け取るためのアノテーションです。GETリクエストとは、主に「画面を表示したい」「情報を取得したい」といった目的で使われるHTTPメソッドです。ブラウザでURLを入力してページを開く操作は、ほとんどの場合GETリクエストになります。

Spring MVCでは、画面表示を行う処理の多くがGETリクエストに対応しています。そのため、初心者が最初に触れるHTTPメソッドがGETになることが多いです。@GetMappingを使うことで、「このメソッドは画面を表示するための処理である」という意図をコード上ではっきり示すことができます。

例えば、トップページや入力フォーム画面を表示する処理は、@GetMappingを使って定義するのが一般的です。URLにアクセスされたときに、対応する画面を返す、という流れをシンプルに表現できます。

以下は、@GetMappingを使って画面を表示する基本的な例です。Pleiadesで作成したGradleプロジェクトに@Controllerを用意し、画面遷移を定義しています。


@Controller
public class SampleController {

    @GetMapping("/input")
    public String showInput() {
        return "input";
    }
}

この例では、「/input」というURLにGETリクエストでアクセスすると、inputという画面が表示されます。@GetMappingを使うことで、「この処理はGET専用である」ということが一目で分かるようになります。

Spring MVC初心者の方は、まず「画面を表示する処理は@GetMapping」という基本ルールを意識すると、コードの流れを理解しやすくなります。

5. @PostMappingとは何か（POSTリクエストの役割）

@PostMappingは、Spring MVCでPOSTリクエストを受け取るためのアノテーションです。POSTリクエストは、「入力されたデータをサーバーに送信する」「登録や更新などの処理を行う」といった目的で使われます。

Webアプリでは、フォームに入力した内容を送信する場面がよくあります。このときに使われるのがPOSTリクエストです。Spring MVCでは、こうしたデータ送信処理を@PostMappingで受け取ることで、処理の役割を明確に分けることができます。

初心者の方が混乱しやすい点として、「GETとPOSTでURLが同じでも良いのか」という疑問があります。Spring MVCでは、同じURLであっても、HTTPメソッドが違えば別の処理として扱うことができます。そのため、画面表示とデータ送信を同じURLで設計するケースも少なくありません。

以下は、フォームから送信された内容を受け取る@PostMappingのシンプルな例です。


@Controller
public class SampleController {

    @PostMapping("/input")
    public String submitInput() {
        return "result";
    }
}

この例では、「/input」というURLにPOSTリクエストが送信されたときに、submitInputメソッドが実行されます。画面表示は@GetMapping、送信処理は@PostMappingという形で役割を分けることで、処理内容が分かりやすくなります。

@PostMappingを使うことで、「この処理はデータを送信するためのものだ」という意図が明確になり、Spring MVC初心者でもコードを読みやすくなります。

6. @GetMappingと@PostMappingの使い分け方

@GetMappingと@PostMappingの使い分けは、Spring MVCを理解するうえで非常に重要なポイントです。基本的な考え方として、「画面を表示する処理は@GetMapping」「データを送信する処理は@PostMapping」と覚えると分かりやすくなります。

例えば、入力フォームを表示する処理と、入力内容を送信して結果画面を表示する処理は、役割がまったく異なります。これらを同じHTTPメソッドで扱ってしまうと、処理の意図が分かりにくくなり、初心者ほど混乱しやすくなります。

Spring MVCでは、同じURLを使いながらも、GETとPOSTで処理を分ける設計がよく使われます。この設計によって、URL構造をシンプルに保ちつつ、処理内容を整理することができます。

以下は、@GetMappingと@PostMappingを組み合わせた、典型的な画面遷移の例です。


@Controller
public class SampleController {

    @GetMapping("/form")
    public String showForm() {
        return "form";
    }

    @PostMapping("/form")
    public String submitForm() {
        return "complete";
    }
}

このように記述すると、「/form」にGETでアクセスしたときは入力画面が表示され、POSTで送信されたときは完了画面が表示されます。URLの流れと画面の動きが直感的に理解できる構成です。

Spring MVC初心者の方は、まずこのパターンをしっかり身に付けることが大切です。@GetMappingと@PostMappingを正しく使い分けられるようになると、HTTPメソッドの理解が深まり、より安定したWebアプリを作れるようになります。

7. GETとPOSTを間違えたときによく起こる問題

Spring MVCで@GetMappingと@PostMappingを使い始めた初心者が最も戸惑うのが、「画面が表示されない」「処理が呼ばれない」といった問題です。その原因の多くは、GETとPOSTの使い分けを誤っていることにあります。

例えば、フォームから送信する処理を@GetMappingで定義している場合、ブラウザからはPOSTリクエストが送信されるため、Spring MVCは対応するメソッドを見つけることができません。この結果、エラー画面が表示されたり、何も起こらないように見えたりします。

逆に、画面を表示したいだけなのに@PostMappingを使っている場合も、期待した動きにならないことがあります。ブラウザでURLを直接入力したアクセスはGETリクエストになるため、@PostMappingで定義された処理は実行されません。

このような問題が起きたときは、「この画面や処理は、見るためのものなのか、それとも送るためのものなのか」を改めて考えることが重要です。Spring MVCでは、HTTPメソッドの違いがそのまま処理の分岐条件になります。

GETとPOSTを正しく使い分けることで、画面表示とデータ送信の役割が明確になり、思わぬ動作不良を防ぐことができます。初心者のうちは、動かない原因をコードの書き方ではなく、HTTPメソッドの選択から確認する習慣を身に付けることが大切です。

8. 初心者がつまずきやすいポイントと注意点

Spring MVCで@GetMappingと@PostMappingを学ぶ過程では、いくつか共通したつまずきポイントがあります。その一つが、「同じURLなのに処理が呼ばれない」という混乱です。これは、HTTPメソッドの違いを意識できていないことが原因である場合がほとんどです。

また、コントローラに@Controllerアノテーションを付け忘れているケースもよくあります。この場合、Spring MVCがそのクラスをコントローラとして認識しないため、どれだけ正しく@GetMappingや@PostMappingを書いても処理は実行されません。

さらに、Pleiadesで作成したプロジェクトでは、パッケージ構成によってコンポーネントスキャンの対象外になってしまうこともあります。コントローラクラスが正しいパッケージに配置されているかどうかも、画面が表示されないときの重要な確認ポイントです。

初心者の方は、エラーが出たときにすぐにコードを書き換えたくなりますが、まずは「どのHTTPメソッドでアクセスされているか」「どのアノテーションで受け取っているか」を冷静に確認することが重要です。

Spring MVCは、ルールを理解すれば非常に分かりやすいフレームワークです。GETとPOSTの役割を整理しながら、一つずつ確認していくことで、確実に理解を深めることができます。

9. @GetMapping / @PostMappingを理解した後に学ぶべきこと

@GetMappingと@PostMappingの基本を理解できたら、次のステップとして@RequestMappingとの関係を整理してみるとよいでしょう。@GetMappingや@PostMappingは、@RequestMappingをHTTPメソッドごとに分かりやすくしたものです。

そのため、クラスレベルで@RequestMappingを使い、メソッドレベルで@GetMappingや@PostMappingを使う設計を理解すると、より整理されたURL構造を作れるようになります。これは、Spring MVCのルーティングを学ぶうえで重要な考え方です。

また、画面表示を前提としたSpring MVCの開発では、フォーム入力、画面遷移、入力チェックといった要素も自然に登場してきます。HTTPメソッドの役割を理解していると、これらの仕組みもスムーズに理解できるようになります。

Spring MVC初心者の方は、まず「なぜ@GetMappingなのか」「なぜ@PostMappingなのか」を説明できるようになることを目標にしましょう。その理解があれば、次に学ぶ内容も無理なくつながっていきます。

HTTPメソッド入門として@GetMappingと@PostMappingをしっかり押さえることは、Spring MVC全体を理解するための大きな一歩です。焦らず、基本を大切にしながら学習を進めていきましょう。