@PostMappingとは？@PostMappingの使い方を完全ガイド！初心者でもわかるSpring MVCのPOSTリクエスト処理

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

新人

「Spring MVCで@PostMappingって何に使うんですか？あまりピンとこなくて…」

先輩

「@PostMappingは、ユーザーがフォームを送信したときなどのPOSTリクエストを処理するために使うんだ。データを送信して処理したいときに便利なんだよ。」

新人

「なるほど！でも、@RequestMappingでも同じことができるって聞いたことがあります。」

先輩

「確かにできるけど、@PostMappingを使うともっとシンプルで読みやすくなるんだよ。詳しく見ていこう！」

1. @PostMappingとは？

@PostMappingは、Spring MVCでPOSTリクエストを処理するためのアノテーションです。POSTリクエストは、フォームからデータを送信したり、APIにデータを渡すときに使用されます。@PostMappingを使うことで、処理メソッドとリクエストURLを簡単に紐づけられます。

例えば、ユーザー登録フォームのデータを受け取って処理したい場合、@PostMappingを使うことで、送信ボタンを押したときに対応する処理が実行されます。

2. @PostMappingがなぜ使われるのか（役割と利便性）

@PostMappingが使われる理由は、コードの簡潔さと可読性の向上にあります。従来は@RequestMappingにmethod = RequestMethod.POSTを指定していましたが、@PostMappingを使うとコードが短くなり、処理内容が直感的に理解できるようになります。

① @RequestMappingを使用した例


package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class FormController {

    @RequestMapping(value = "/submit", method = RequestMethod.POST)
    public String submitForm() {
        return "result";
    }
}

② @PostMappingを使用した例


package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;

@Controller
public class FormController {

    @PostMapping("/submit")
    public String submitForm() {
        return "result";
    }
}

上記のように、@PostMappingを使うと記述がシンプルでわかりやすくなります。特に複数のPOSTリクエストを処理する場合に、可読性が大幅に向上します。

③ 実行結果のイメージ


データが正常に送信されました！

実際にフォームからデータを送信すると、「データが正常に送信されました！」と表示されます。このように、@PostMappingはユーザーから送信されたデータを処理する際に非常に便利です。

開発環境のポイント:

開発環境はpleiadesを使用し、依存関係はSpring Webを追加してください。
ビルドツールはGradleを使用し、build.gradleで依存関係を管理します。
HTMLファイルはsrc/main/resources/templatesフォルダに配置します。

3. @PostMappingの基本的な使い方（簡単なコード例付き）

@PostMappingは、フォーム送信やデータ登録処理など、ユーザーからのPOSTリクエストを処理するために使います。GETリクエストが主に情報取得を目的とするのに対し、POSTリクエストはデータの送信や変更、登録が目的です。ここでは、簡単なフォーム送信処理の例を紹介します。

① コントローラクラスの作成


package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class ContactController {

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

    @PostMapping("/contact")
    public String submitForm(@RequestParam("name") String name, 
                              @RequestParam("message") String message, 
                              Model model) {
        model.addAttribute("name", name);
        model.addAttribute("message", message);
        return "result";
    }
}

このコードでは、/contactにGETリクエストが来た場合はフォームを表示し、POSTリクエストが来た場合は送信されたデータを受け取って処理します。

② フォーム画面のHTML（contact.html）


<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <title>お問い合わせフォーム</title>
</head>
<body>
    <h1>お問い合わせフォーム</h1>
    <form action="/contact" method="post">
        <label for="name">お名前：</label>
        <input type="text" id="name" name="name" required><br><br>

        <label for="message">メッセージ：</label><br>
        <textarea id="message" name="message" rows="5" cols="30" required></textarea><br><br>

        <button type="submit">送信</button>
    </form>
</body>
</html>

③ 結果表示画面のHTML（result.html）


<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <title>送信結果</title>
</head>
<body>
    <h1>送信結果</h1>
    <p th:text="'お名前: ' + ${name}">お名前: 未入力</p>
    <p th:text="'メッセージ: ' + ${message}">メッセージ: 未入力</p>
</body>
</html>

【実行結果のイメージ】


お名前: 山田太郎
メッセージ: はじめまして。問い合わせです。

フォームに入力して送信すると、入力された名前とメッセージが結果画面に表示されます。@RequestParamを使うことで、フォームから送信されたデータを簡単に取得できます。

4. フォームデータの受け取り方

フォームデータは、@RequestParamや@ModelAttributeを使って受け取ることができます。ここでは、シンプルな方法である@RequestParamを中心に解説します。

① @RequestParamの使用例


@PostMapping("/submit")
public String handleSubmit(@RequestParam("username") String username, 
                           @RequestParam("email") String email, 
                           Model model) {
    model.addAttribute("username", username);
    model.addAttribute("email", email);
    return "submitResult";
}

このコードでは、フォームから送信されたusernameとemailを受け取り、結果画面に表示しています。

② 対応するHTMLフォーム（submitForm.html）


<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <title>ユーザー登録</title>
</head>
<body>
    <h1>ユーザー登録フォーム</h1>
    <form action="/submit" method="post">
        <label>ユーザー名:</label>
        <input type="text" name="username" required><br><br>

        <label>メールアドレス:</label>
        <input type="email" name="email" required><br><br>

        <button type="submit">登録</button>
    </form>
</body>
</html>

③ 実行結果のイメージ（submitResult.html）


ユーザー名: 佐藤花子
メールアドレス: hanako@example.com

フォームに入力して送信すると、ユーザー名とメールアドレスが表示されます。@RequestParamは、名前が一致するパラメータを自動的に取得するため、簡単で便利です。

5. パス変数とクエリパラメータの違いと扱い方

パス変数とクエリパラメータは、どちらもリクエスト時にデータを送信する方法ですが、用途が異なります。

① パス変数の使用例


@GetMapping("/user/{id}")
public String getUserById(@PathVariable("id") int id, Model model) {
    model.addAttribute("userId", id);
    return "userDetails";
}

パス変数は、URLの一部としてデータを渡す方法で、リソースの特定に使われます。例として、/user/10にアクセスすると、IDが10のユーザー情報が表示されます。

② クエリパラメータの使用例


@GetMapping("/search")
public String search(@RequestParam("query") String query, Model model) {
    model.addAttribute("searchQuery", query);
    return "searchResults";
}

クエリパラメータは、?query=キーワードのようにURLの末尾にデータを渡す方法で、検索やフィルタリングに使用されます。例として、/search?query=Springにアクセスすると、"Spring"に関する検索結果が表示されます。

③ パス変数とクエリパラメータの比較

項目	パス変数	クエリパラメータ
使用目的	特定のリソースの取得	条件付きデータ取得
URLの例	/user/5	/search?query=Spring
読みやすさ	リソースが直感的に分かる	複数条件の指定に便利

パス変数はリソースの一意識別に適しており、クエリパラメータはオプション情報の指定に便利です。用途に応じて適切に使い分けましょう。

6. @PostMappingを使った簡単なWebアプリケーション作成例

@PostMappingを使うことで、ユーザーからのフォームデータを受け取り、サーバーで処理する簡単なWebアプリケーションを作成できます。ここでは、ユーザーがフィードバックを送信できるシンプルなアプリケーションを例に紹介します。

① コントローラクラスの作成


package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class FeedbackController {

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

    @PostMapping("/feedback")
    public String submitFeedback(@RequestParam("username") String username,
                                 @RequestParam("comments") String comments,
                                 Model model) {
        model.addAttribute("username", username);
        model.addAttribute("comments", comments);
        return "feedbackResult";
    }
}

このコードでは、/feedbackへのGETリクエストでフィードバックフォームを表示し、POSTリクエストでユーザーからのデータを処理して結果画面に表示します。

② フィードバックフォーム画面のHTML（feedback.html）


<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <title>フィードバックフォーム</title>
</head>
<body>
    <h1>フィードバックフォーム</h1>
    <form action="/feedback" method="post">
        <label for="username">お名前：</label>
        <input type="text" id="username" name="username" required><br><br>

        <label for="comments">コメント：</label><br>
        <textarea id="comments" name="comments" rows="5" cols="30" required></textarea><br><br>

        <button type="submit">送信</button>
    </form>
</body>
</html>

③ 送信結果表示画面のHTML（feedbackResult.html）


<!DOCTYPE html>
<html lang="ja">
<head>
    <meta charset="UTF-8">
    <title>送信結果</title>
</head>
<body>
    <h1>フィードバック送信結果</h1>
    <p th:text="'お名前: ' + ${username}">お名前: 未入力</p>
    <p th:text="'コメント: ' + ${comments}">コメント: 未入力</p>
</body>
</html>

【実行結果のイメージ】


お名前: 鈴木一郎
コメント: このアプリはとても使いやすいです！

フォームに名前とコメントを入力して送信すると、入力内容が結果画面に表示されます。@RequestParamを使うことで、簡単にフォームデータを取得できます。

7. よくあるエラーとその解決方法

@PostMappingを使用していると、初心者がよく遭遇するエラーがあります。ここでは代表的なエラーとその解決方法を紹介します。

① HTTP 405 Method Not Allowed エラー

このエラーは、リクエストされたURLに対応するメソッドが存在しない場合に発生します。主な原因は、@PostMappingで処理するはずのURLにGETリクエストを送っている場合です。


// 原因: GETリクエストが処理されない場合
@PostMapping("/submit")
public String submit() {
    return "result";
}

解決方法: GET用のメソッドも用意することで解消されます。


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

② Required request parameter 'name' is not present

このエラーは、@RequestParamで指定したパラメータがフォームに存在しない場合に発生します。


@PostMapping("/submit")
public String submitForm(@RequestParam("name") String name) {
    return "result";
}

解決方法: HTMLフォームにname属性を正しく追加してください。


<input type="text" name="name" required>

③ 404 Not Found エラー

コントローラのURLパスが間違っている、またはHTMLファイルが指定の場所にない場合に発生します。パスのスペルやファイル配置を確認してください。

8. @PostMappingを学ぶ際のポイントと今後の学習ステップ

@PostMappingの基礎を理解したら、次のステップとして以下の内容を学ぶと実践的な開発スキルが向上します。

@GetMappingとの使い分け: データ取得と送信の処理の違いを理解することで、適切なルーティングが実現できます。
フォームバリデーション: ユーザーからの不正なデータ送信を防ぐために、@ValidやBindingResultを使用した入力チェックを学びましょう。
エラーハンドリング: @ControllerAdviceを用いた共通のエラー処理方法を習得すると、アプリケーション全体の品質が向上します。
サービス層の分離: ビジネスロジックをサービスクラスに分離することで、コードの再利用性とテスト性が向上します。

これらの知識を深めることで、より実用的なWebアプリケーションが作成できるようになります。次は@GetMappingやフォームバリデーションの詳細を学ぶのがおすすめです！

@PostMappingとは？@PostMappingの使い方を完全ガイド！初心者でもわかるSpring MVCのPOSTリクエスト処理

1. @PostMappingとは？

2. @PostMappingがなぜ使われるのか（役割と利便性）

① @RequestMappingを使用した例

② @PostMappingを使用した例

③ 実行結果のイメージ

3. @PostMappingの基本的な使い方（簡単なコード例付き）

① コントローラクラスの作成

② フォーム画面のHTML（contact.html）

③ 結果表示画面のHTML（result.html）

【実行結果のイメージ】

4. フォームデータの受け取り方

① @RequestParamの使用例

② 対応するHTMLフォーム（submitForm.html）

③ 実行結果のイメージ（submitResult.html）

5. パス変数とクエリパラメータの違いと扱い方

① パス変数の使用例

② クエリパラメータの使用例

③ パス変数とクエリパラメータの比較

6. @PostMappingを使った簡単なWebアプリケーション作成例

① コントローラクラスの作成

② フィードバックフォーム画面のHTML（feedback.html）

③ 送信結果表示画面のHTML（feedbackResult.html）

【実行結果のイメージ】

7. よくあるエラーとその解決方法

① HTTP 405 Method Not Allowed エラー

② Required request parameter 'name' is not present

③ 404 Not Found エラー

8. @PostMappingを学ぶ際のポイントと今後の学習ステップ

関連記事: