【超入門】Spring BootのGETとPOSTをやさしく解説！使い分けと実装がこれだけで分かる
生徒
「Spring BootでGETとPOSTの違いは知っているつもりなんですが、実際のサービスだとどう使い分ければいいのかイメージできません。」
先生
「イメージがつかみにくいとよく言われますね。簡単に言うと、読むときはGET、何かを送ってサーバーの状態を変えるときはPOSTです。たとえば、ネットショッピングなら、商品を見ているときはGET、注文ボタンを押して情報を送るときはPOSTですね。」
生徒
「なるほど！では、プロフィール更新みたいに『入力フォームを開く→保存』の場合はどうですか？フォームを開くのはGETで、保存してDBに書き込むのはPOST、という感じですか？」
先生
「その通り！フォーム表示はGETで、送信して更新処理を行うのがPOSTです。Spring Bootだと@GetMappingと@PostMappingを使い分けるだけなので、実装も覚えやすいですよ。」
1. GETとPOSTの違いとは？
まずは「何をするときにどちらを使うか」をイメージで押さえましょう。GETは
データを取りに行く（読む）ためのリクエスト、POSTは
データを送り込む（書く）ためのリクエストです。日常の例で言うと、
メニューを見るのがGET、注文票を渡すのがPOSTという感覚です。
GETメソッドはURLに条件（クエリ）を付けてサーバーに「見せて」と頼みます。 ページ閲覧や検索に向いており、基本的にサーバーの中身を変えません（安全・冪等）。 例えば次のようにURLだけで動きます。
# 例：ユーザー名で検索（URLに条件を付ける）
curl "http://localhost:8080/users?keyword=taro"
- URLに条件が見えるので、ブックマークや共有が簡単。
- ブラウザやプロキシのキャッシュが効きやすい。
- URL長に上限があるため、送れるデータは少量が前提。
POSTメソッドはリクエストの本文（ボディ）にデータを入れて送ります。 登録・更新・ログインなど、サーバーの状態が変わる処理に使います。 たくさんの項目やファイルも送れ、URLはすっきりしたままです。
# 例：新規ユーザーを登録（本文にデータを入れる）
curl -X POST "http://localhost:8080/register" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "username=taro&email=taro@example.com"
- 本文に載せるため大量のデータを扱える（フォーム送信に最適）。
- URLに値が出ないので、情報が露出しにくい（ただしHTTPSは必須）。
- 再送で重複登録を生みやすいので、後述の対策（トークン等）を考えるのが定石。
- 読むだけ（検索・一覧・詳細）→
GET - サーバーの中身が変わる（登録・更新・削除・ログイン）→
POST - URLに条件を残して再現したい（共有・履歴）→
GET - 入力項目が多い・ファイルを送る →
POST
要点は「GET＝取得、POST＝送信」。まずはこの軸で迷わず選べれば十分です。
以降の実装では、@GetMappingと@PostMappingに当てはめるだけで、
同じ考え方のままコードへ落とし込めます。
2. Spring BootでのGETリクエスト: @GetMapping
Spring Bootでは、@GetMappingを使ってGETリクエストを受け取ります。次の例では、URLからクエリパラメータを受け取って表示します。
<!-- コントローラー: HelloController.java -->
@Controller
public class HelloController {
@GetMapping("/hello")
public String hello(@RequestParam(name = "name", defaultValue = "World") String name, Model model) {
model.addAttribute("message", "Hello, " + name + "!");
return "hello";
}
}
このコードでは、/hello?name=Javaというリクエストに対して「Hello, Java!」と表示するページをレンダリングします。@GetMappingを使うことで、簡単にGETリクエストを処理できます。
3. Spring BootでのPOSTリクエスト: @PostMapping
フォームなどのデータをサーバーに送信する際には、@PostMappingを使います。以下の例では、ユーザー名とメールアドレスを送信し、サーバー側で受け取るコードを示します。
<!-- コントローラー: UserController.java -->
@Controller
public class UserController {
@PostMapping("/register")
public String register(@RequestParam String username, @RequestParam String email, Model model) {
model.addAttribute("message", "User " + username + " with email " + email + " registered successfully.");
return "register";
}
}
このコードに対して、フォームからPOSTリクエストを送信すると、ユーザー名とメールアドレスを受け取ることができます。
4. GETとPOSTの使い分け
GETとPOSTの使い分けは、基本的に次のルールに従います。
- データの取得には
GETを使います。データを取得するだけで、サーバーの状態を変更しない場合に使います。 - データの送信には
POSTを使います。フォームデータやアップロードデータをサーバーに送る場合、またはサーバーの状態を変更する操作（例: データの登録や更新）に使います。
例えば、ユーザーの検索はGETリクエストで行い、ユーザーの登録や更新はPOSTリクエストで行うのが一般的です。
5. GETとPOSTの実際の使い方の例
最後に、GETとPOSTを使ったフォームの実際の例を見てみましょう。
GETリクエストのフォーム例
<!-- HTML: getForm.html -->
<form action="/hello" method="get">
<input type="text" name="name" placeholder="Enter your name" />
<button type="submit">Say Hello</button>
</form>
POSTリクエストのフォーム例
<!-- HTML: postForm.html -->
<form action="/register" method="post">
<input type="text" name="username" placeholder="Enter your username" />
<input type="email" name="email" placeholder="Enter your email" />
<button type="submit">Register</button>
</form>
これらのフォームを使えば、GETとPOSTの使い方の違いが実際に確認できます。GETフォームは主に検索やクエリのために、POSTフォームはデータ送信のために使用します。
6. まとめ
この記事では、Spring Bootを使ったGETリクエストとPOSTリクエストの基本的な使い方について詳しく解説しました。それぞれのHTTPメソッドの特徴や用途、具体的な実装例を通じて、初心者でも理解しやすいように構成しました。
GETリクエストは、主にデータをサーバーから取得するために使用され、URLにパラメータを付加してリクエストを送信します。一方、POSTリクエストは、サーバーにデータを送信するために使用され、フォームデータやファイルの送信に適しています。これらの違いを理解することで、正しいHTTPメソッドを適切な状況で使用できるようになります。
また、Spring Bootでの実装方法として、@GetMappingと@PostMappingを使用する方法を紹介しました。それぞれのアノテーションを使うことで、GETやPOSTのリクエストを簡単に処理できます。特に、GETリクエストではURLからクエリパラメータを受け取り、POSTリクエストではフォームデータを受け取る実装例を示しました。
以下に、この記事の内容を整理したサンプルコードを掲載します。GETとPOSTの使い方の違いをさらに深く理解するために活用してください。
<!-- GETリクエスト: HTML -->
<form action="/hello" method="get">
<input type="text" name="name" placeholder="名前を入力" />
<button type="submit">送信</button>
</form>
<!-- POSTリクエスト: HTML -->
<form action="/register" method="post">
<input type="text" name="username" placeholder="ユーザー名" />
<input type="email" name="email" placeholder="メールアドレス" />
<button type="submit">登録</button>
</form>
<!-- GETリクエスト: コントローラー -->
@GetMapping("/hello")
public String hello(@RequestParam(name = "name", defaultValue = "ゲスト") String name, Model model) {
model.addAttribute("message", "こんにちは、" + name + "さん！");
return "hello";
}
<!-- POSTリクエスト: コントローラー -->
@PostMapping("/register")
public String register(@RequestParam String username, @RequestParam String email, Model model) {
model.addAttribute("message", username + "さんの登録が完了しました（メール: " + email + "）。");
return "register";
}
このように、GETリクエストではデータの取得、POSTリクエストではデータの送信といった用途に応じて使い分けることが重要です。また、GETリクエストはURLにデータを含めるため公開性が高い一方、POSTリクエストはデータがリクエストボディに含まれるため、よりセキュアな用途に向いています。
この記事を参考に、GETとPOSTの使い方を理解し、実際のプロジェクトで活用してみてください。Spring Bootの強力なアノテーション機能を使えば、効率的なリクエスト処理が可能になります。
生徒
「GETとPOSTの違いがよくわかりました！GETはデータを取得するため、POSTはデータを送信するためなんですね。」
先生
「その通りです。それぞれのHTTPメソッドの役割を理解することが、ウェブアプリケーション開発の基礎となります。」
生徒
「Spring Bootでの実装も簡単ですね。アノテーションを使うだけでリクエストを処理できるのが便利です。」
先生
「はい。GETとPOSTを使い分けることで、適切なリクエスト処理を実現できます。次回はPUTやDELETEといった他のHTTPメソッドについても学んでみましょう。」
生徒
「ぜひ学びたいです！ウェブアプリケーション開発がもっと楽しくなりそうです。」
この記事を読んだ人からの質問
