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

新人

「Spring MVCでURLに含まれる値を使って画面を切り替える方法ってありますか？」

先輩

「ありますよ。Spring MVCでは、URLパラメータを使って、どの画面を表示するかや、どんなデータを扱うかを決められます。」

新人

「URLパラメータって、URLの後ろに何か付いているやつですよね？」

先輩

「そうですね。Spring MVCでは、そのURLパラメータを受け取るために@PathVariableという仕組みを使います。Thymeleafと組み合わせると、画面遷移がとても分かりやすくなります。」

1. Spring MVCとは何か（Webアプリ開発の全体像）

Spring MVCは、JavaでWebアプリケーションを作るためのフレームワークです。 Webアプリでは、ブラウザからURLにアクセスすると、サーバ側で処理が行われ、その結果が画面として表示されます。 Spring MVCは、この一連の流れを整理し、分かりやすく管理できるようにする仕組みです。

Spring MVCでは、主に「コントローラ」「ビュー」「モデル」という役割に分かれて処理を行います。コントローラは、URLへのアクセスを受け取り、どの画面を表示するかを決めます。ビューは、Thymeleafを使ってHTML画面を表示します。モデルは、画面に渡すデータを管理します。

このように役割が分かれていることで、Spring MVCのWeb開発では、処理の流れが理解しやすくなり、初心者でもWebアプリの全体像を把握しやすくなります。

2. URLパラメータとは何か（クエリパラメータとの違い）

URLパラメータとは、URLの中に含まれる可変の値のことです。 Spring MVCでは、このURLパラメータを使って、同じ画面構成でも内容を変えることができます。例えば、商品IDやユーザIDをURLに含めることで、表示する情報を切り替えることができます。

よく似た言葉にクエリパラメータがあります。クエリパラメータは「?」や「&」を使ってURLの後ろに付ける形式ですが、 URLパラメータはURLのパスの一部として値を表現します。

URLパラメータを使うと、URLの意味が分かりやすくなり、検索エンジンにも内容が伝わりやすくなるため、SEOの観点でもメリットがあります。 Spring MVCのWeb開発では、URLパラメータは非常によく使われる重要な仕組みです。

3. @PathVariableとは何か（初心者向けの基本説明）

@PathVariableは、Spring MVCでURLパラメータを受け取るためのアノテーションです。 URLの一部として渡された値を、コントローラのメソッド引数として受け取ることができます。

例えば、URLに「/user/1」のような形で数値が含まれている場合、その「1」という値をJavaの変数として扱えるようにするのが@PathVariableの役割です。これにより、URLごとに異なる処理や画面表示が可能になります。

pleiadesで作成したGradleプロジェクトでも、 @Controllerを使ったSpring MVCのコントローラで@PathVariableはそのまま利用できます。特別な設定をしなくても使えるため、初心者でも導入しやすい点が特徴です。


@Controller
@RequestMapping("/sample")
public class SampleController {

    @GetMapping("/detail/{id}")
    public String detail(@PathVariable int id) {
        return "detail";
    }
}

この例では、URLに含まれるidの値を受け取り、その値に応じた画面を表示する準備をしています。 Spring MVCでは、このようにURLパラメータとメソッドを自然に結び付けられるため、 Webアプリの構造がとても分かりやすくなります。


@Controller
@RequestMapping("/item")
public class ItemController {

    @GetMapping("/view/{itemId}")
    public String viewItem(@PathVariable Integer itemId) {
        return "itemView";
    }
}

このように@PathVariableを使うことで、 Spring MVCとThymeleafを連携させた画面遷移の基礎が完成します。 URLパラメータを理解することは、Spring MVCのWeb開発を進める上で欠かせないポイントです。

4. @PathVariableの基本的な使い方（コントローラ側）

Spring MVCでURLパラメータを扱う際、最も基本となるのが@PathVariableの使い方です。ここでは、URLの形とコントローラのコードをセットで確認しながら、 Spring MVC PathVariableの使い方を順番に理解していきます。

例えば、ブラウザから「/product/detail/10」というURLにアクセスしたとします。このURLでは「10」という数値がURLパラメータとして含まれています。 Spring MVCでは、この値をコントローラのメソッド引数として受け取ることができます。

URL設計の段階で「どの部分が可変なのか」を明確にしておくことで、コードの可読性が高くなり、初心者でも処理の流れを追いやすくなります。これがURLパラメータ設計の大きなメリットです。


@Controller
@RequestMapping("/product")
public class ProductController {

    @GetMapping("/detail/{productId}")
    public String detail(@PathVariable int productId) {
        return "productDetail";
    }
}

このコードでは「{productId}」と書かれた部分がURLパラメータです。 URLの「/detail/10」にアクセスすると、productIdには「10」が自動的に代入されます。 @PathVariableを付けることで、URLの値とJavaの引数が結びつきます。

この仕組みにより、Spring MVCではURLを見るだけで「どのデータを表示しようとしているのか」を直感的に理解できるようになります。これが初心者にも分かりやすい理由の一つです。

5. URLとメソッド引数がどのように結びつくのか

Spring MVCでは、URLとコントローラのメソッド引数が自動的に結びつきます。これはフレームワークが内部で処理を行ってくれているためです。難しく感じるかもしれませんが、基本的な考え方はとてもシンプルです。

まず、URLの中で「{}」で囲まれた部分が「ここは値が変わる場所ですよ」という合図になります。次に、コントローラのメソッド引数に@PathVariableを付けることで、その値を受け取る準備が整います。

例えば「/user/profile/5」というURLの場合、数字の「5」は特定のユーザを表すための識別子として使われることが多いです。 Spring MVCでは、このようなURL設計が非常によく使われます。


@Controller
@RequestMapping("/user")
public class UserController {

    @GetMapping("/profile/{userId}")
    public String profile(@PathVariable Integer userId) {
        return "userProfile";
    }
}

この例では、URLの「{userId}」とメソッド引数のuserIdが対応しています。型がIntegerになっている点にも注目してください。 Spring MVCは、URL文字列を自動的に数値型へ変換してくれます。これを型変換と呼びますが、Spring MVCが裏側で処理してくれるため、開発者は特別なコードを書く必要がありません。

このようにURLとメソッド引数が自然に結び付くことで、コントローラの役割が明確になり、処理の流れも理解しやすくなります。 URL設計を意識することは、読みやすいSpring MVCアプリを作る第一歩です。

6. 複数の@PathVariableを使う場合の考え方

Spring MVCでは、1つのURLに対して複数の@PathVariableを使うこともできます。これは、より具体的な情報をURLで表現したい場合に役立ちます。初心者のうちは難しく感じるかもしれませんが、 URLを分解して考えると理解しやすくなります。

例えば「/category/3/item/15」というURLを考えてみましょう。このURLは「カテゴリ3の中にある商品15」という意味を持たせることができます。 URLを見るだけで、どんな情報を扱っているのかが想像しやすくなります。


@Controller
@RequestMapping("/category")
public class CategoryController {

    @GetMapping("/{categoryId}/item/{itemId}")
    public String itemDetail(
            @PathVariable int categoryId,
            @PathVariable int itemId) {
        return "categoryItemDetail";
    }
}

このコードでは、2つの@PathVariableを使っています。 categoryIdとitemIdがそれぞれURLの異なる位置から値を受け取っています。 Spring MVCでは、名前が一致していれば自動的に対応付けが行われます。

複数の@PathVariableを使う際のポイントは、 URLの意味が分かりやすい順番になっているかを意識することです。無理に詰め込まず、URL設計を丁寧に行うことで、 Thymeleafと連携した画面遷移も直感的になります。

このようなURL設計を意識することで、 Spring MVC PathVariableの使い方だけでなく、 Webアプリ全体の構造を理解する力も自然と身についていきます。初心者のうちは、URLを文章のように読む意識を持つことが大切です。

7. Thymeleafで@PathVariableを含むURLを生成する方法

Spring MVCとThymeleafを組み合わせたWeb開発では、コントローラで受け取った@PathVariableを前提として、画面側で正しいURLを生成することがとても重要になります。ここでは、Thymeleaf URL パラメータの基本的な考え方から確認していきます。

HTMLの役割は、ブラウザに表示する画面の構造を定義することです。 Thymeleafは、そのHTMLに対して「動的な値」を埋め込むためのテンプレートエンジンです。そのため、URLの中に変数を含めたい場合も、Thymeleafの記述ルールに従う必要があります。

例えば、商品一覧画面から商品詳細画面へ遷移する場面を考えてみましょう。商品ごとに異なるIDをURLに含めることで、 Spring MVCのコントローラ側で正しい商品情報を表示できるようになります。


<a th:href="@{/product/detail/{id}(id=${productId})}">
    商品詳細を見る
</a>

この記述では、URLの「{id}」部分に、productIdという値を埋め込んでいます。なぜこの書き方になるのかというと、 ThymeleafではURLテンプレートとパラメータ指定を分けて記述する仕組みになっているためです。

この方法を使うことで、URLを文字列として直接組み立てる必要がなくなり、 Spring MVCのURL設計と画面側の記述がずれにくくなります。これが、Thymeleafを使ったSpring MVC 画面遷移が安全で分かりやすい理由です。

8. コントローラから値を渡し、画面に表示する流れ

次に、@ControllerとModelを使って、コントローラから画面へ値を渡す流れを確認します。 Spring MVCでは、この流れを理解することがとても重要です。

コントローラの役割は、URLに応じた処理を行い、画面に必要なデータをModelに詰めてThymeleafへ渡すことです。 Modelは「画面に渡す箱」のようなものだと考えると分かりやすいです。


@Controller
@RequestMapping("/product")
public class ProductController {

    @GetMapping("/detail/{productId}")
    public String detail(@PathVariable int productId, Model model) {
        model.addAttribute("productId", productId);
        return "productDetail";
    }
}

このコードでは、URLから受け取ったproductIdをModelに追加しています。なぜModelを使うのかというと、コントローラと画面を直接結び付けないためです。これにより、画面側は「渡された値を表示するだけ」という役割に集中できます。


<p>
    商品ID：<span th:text="${productId}"></span>
</p>

Thymeleafでは、th:textを使ってModelの値を画面に表示します。 HTMLとしての構造を保ったまま、動的な値だけを差し替えられる点が特徴です。

このように、URL → コントローラ → Model → Thymeleafという流れを理解すると、 Spring MVCの画面遷移全体が一本の線でつながって見えるようになります。

9. @PathVariableを使う際によくあるミスと注意点

@PathVariableはとても便利な仕組みですが、初心者がつまずきやすいポイントもいくつかあります。ここでは、よくあるミスと注意点を整理します。

一つ目の注意点は、URLの名前と引数名が一致していないケースです。 Spring MVCでは、基本的にURLテンプレートの名前とメソッド引数名が同じである必要があります。

二つ目は、URLパラメータに数値以外が渡された場合です。 intやIntegerを使っていると、数値以外が渡されたときにエラーになることがあります。これは型変換に失敗するためです。

三つ目は、画面側のThymeleafでURLを直接文字列結合してしまうことです。この方法は一見簡単に見えますが、 URL設計の変更に弱く、バグの原因になりやすいです。

そのため、Thymeleaf URL パラメータは、必ずth:hrefを使ってテンプレートとして定義するようにしましょう。これが、保守しやすいSpring MVCアプリを作るコツです。

10. 初心者が最初に覚えるべきポイント

ここまで、Spring MVCの@PathVariableとThymeleafの連携について解説してきました。最後に、初心者が最初に覚えるべきポイントを整理します。

URLパラメータは、URLの意味を分かりやすくするための仕組みである
@PathVariableを使うことで、URLの値をコントローラで受け取れる
Thymeleafではth:hrefを使ってURLを安全に生成する
コントローラから画面へはModelを使って値を渡す
URL設計と画面遷移をセットで考えることが重要

これらのポイントを意識することで、 Spring MVC PathVariableの使い方だけでなく、 Webアプリ全体の構造も理解しやすくなります。基本をしっかり押さえながら、少しずつ実装に慣れていきましょう。

Spring MVCのURLパラメータ（@PathVariable）とThymeleafの連携を初心者向けに徹底解説