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

新人

「Spring MVCでショッピングサイトを作っていると、商品をカートに入れても、ページを移動すると消えてしまいそうで不安になります。実際はどうやって管理しているんですか？」

先輩

「多くの場合は、セッションを使ってカートの中身を管理しているよ。ページを移動しても情報が残るのは、その仕組みのおかげなんだ。」

新人

「セッションってログイン情報を保存するもの、というイメージでした。カートにも使えるんですね。」

先輩

「そう。まずはショッピングカートの考え方と、なぜSpring MVC セッションを使うのかを整理してみよう。」

1. ショッピングカートとは何か（Webアプリの基本概念）

ショッピングカートとは、Webアプリケーション上で利用者が選択した商品を一時的に保存しておく仕組みです。実店舗で言えば、買い物かごに商品を入れて持ち歩く感覚に近いものです。

Webアプリでは、画面を表示するたびにサーバへリクエストが送られます。そのため、何も工夫をしなければ、ページを移動するごとに「どの商品を選んでいたか」という情報は失われてしまいます。これでは、ショッピングカートとして成り立ちません。

そこで必要になるのが、利用者ごとに「選んだ商品一覧」を保持しておく仕組みです。この役割を担うのがショッピングカートであり、 Spring MVCでよく扱われる代表的なユースケースの一つです。

初心者の方は、ショッピングカートを「ページを移動しても消えない、一時的な商品リスト」とイメージすると理解しやすくなります。 Spring MVC ショッピングカート基本を理解する第一歩は、この概念をしっかり押さえることです。


@Controller
public class CartController {

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

このようにコントローラで画面を表示するだけでは、カートの中身はまだ管理できていません。次に考えるべきなのが、その中身をどこに保存するかという点です。

2. なぜセッションを使ってカートを管理するのか

Spring MVCでショッピングカートを実装する際、よく使われるのがセッションです。セッションとは、利用者ごとにサーバ側で情報を保持する仕組みで、ページを移動しても同じ利用者として扱える特徴があります。

「なぜページを移動してもカートの中身が残るのか」という疑問は、多くの初心者が感じるポイントです。その答えは、カート情報が画面ではなく、サーバ側のセッションに保存されているからです。

各リクエストは独立していますが、同じセッションを通じてアクセスしている場合、サーバは「同じ利用者からの操作だ」と判断できます。そのため、セッションに保存したカート情報を別の画面でも参照できるのです。

Spring MVC セッションを使うメリットは、実装が比較的シンプルである点にあります。データベースを用意しなくても、基本的なショッピングカートを構築できるため、学習用や小規模な機能では特に扱いやすい方法です。


@Controller
public class AddCartController {

    @GetMapping("/add")
    public String add(HttpSession session) {
        session.setAttribute("item", "sampleItem");
        return "cart";
    }
}

この例では、商品情報をセッションに保存しています。画面を移動しても同じセッションが使われるため、カートの中身が保持される仕組みです。

もちろん、実際のショッピングカートでは複数の商品を扱ったり、数量を管理したりしますが、基本となる考え方は変わりません。「利用者ごとの状態をセッションに保存する」という点が、カート実装の土台になります。

Spring MVC セッションとショッピングカート基本の関係を理解すると、なぜログイン状態や購入途中の情報が自然に維持されているのかが見えてきます。これが、次のステップであるカートの具体的な中身管理へとつながっていきます。

3. セッションを使ったカート情報の持ち方

Spring MVC ショッピングカートを実装するうえで、次に理解しておきたいのが、「セッションの中にカート情報をどう持たせるか」という考え方です。セッションは、単に値を一つ保存するだけでなく、ある程度まとまったデータ構造を保持できます。

初心者の方は、セッションに保存されている状態をはっきりイメージできずに混乱しがちです。セッションの中には、利用者ごとに専用の領域があり、そこに「カート用の箱」が置かれていると考えると分かりやすくなります。

ショッピングカートでは、複数の商品を扱う必要があるため、単純な文字列ではなく、 List や Map といったコレクション型を使うことが一般的です。例えば、商品を順番に追加していくなら List、商品と数量を対応させたいなら Map、といった考え方になります。

ここで重要なのは、「セッションに保存したオブジェクトは、次のリクエストでも同じものが使われる」という点です。コントローラの処理自体は毎回新しく実行されますが、セッションに入っているデータは使い回されます。


@Controller
public class CartSessionController {

    @GetMapping("/initCart")
    public String initCart(HttpSession session) {
        List<String> cart = new ArrayList<>();
        session.setAttribute("cart", cart);
        return "cart";
    }
}

この例では、セッションの中に List を保存しています。これが「カート本体」だと考えると、以降のリクエストでこの List に商品を追加していく、という流れが見えてきます。

Spring MVC セッションカート実装の基本は、「一度作ったカート用のデータ構造を、セッションに保存して使い続ける」という発想にあります。

4. 商品をカートに追加する基本的な処理

セッションにカート情報を持たせたら、次は商品を追加する処理を考えます。ショッピングカート基本実装では、「セッションからカートを取り出す」「商品を追加する」「再びセッションに保存する」という流れが繰り返されます。

初心者がつまずきやすいポイントとして、リクエストごとにコントローラの処理は新しく始まる、という点があります。そのため、毎回 new でカートを作ってしまうと、せっかくの中身が消えてしまいます。

正しい考え方は、「まずセッションにカートがあるかを確認する」「なければ新しく作る」「あればそのまま使う」という順番です。これにより、ページを移動してもカートの中身が維持されます。


@Controller
public class AddItemController {

    @GetMapping("/addItem")
    public String addItem(HttpSession session) {
        List<String> cart = (List<String>) session.getAttribute("cart");
        if (cart == null) {
            cart = new ArrayList<>();
        }
        cart.add("sampleItem");
        session.setAttribute("cart", cart);
        return "cart";
    }
}

この処理では、セッションからカートを取り出し、商品を追加しています。もしセッションにまだカートがなければ、新しく作成してから保存しています。

このように、セッションを中心に考えることで、「なぜカートの中身が消えないのか」が自然に理解できるようになります。 Spring MVC ショッピングカート実装の基本的な形は、ここに集約されています。

5. カートの中身を画面に表示する考え方

商品をカートに追加できるようになったら、次はその中身を画面に表示する必要があります。ここでも考え方はシンプルで、セッションに保存されているカート情報を画面表示用に取り出すだけです。

Spring MVCでは、コントローラで取得したデータを画面に渡すことで表示を行います。カートの中身も例外ではなく、セッションから取り出した List や Map をそのまま画面に渡す形になります。

初心者が混乱しやすい点として、「セッションにあるデータ」と「画面に渡すデータ」は別物だと考えてしまうケースがあります。実際には、セッションにあるデータを参照して、画面用のデータとして使っているだけです。


@Controller
public class ViewCartController {

    @GetMapping("/viewCart")
    public String viewCart(HttpSession session, Model model) {
        List<String> cart = (List<String>) session.getAttribute("cart");
        model.addAttribute("cartItems", cart);
        return "cart";
    }
}

この例では、セッションからカートを取得し、画面に渡しています。画面側では、このデータを使って商品一覧を表示することになります。

Spring MVC セッションカート実装では、「データはセッションに保持する」「表示は画面に任せる」という役割分担が重要です。この考え方を押さえておくことで、次のステップである削除や数量変更といった処理もスムーズに理解できるようになります。

6. カートから商品を削除・クリアする処理の考え方

Spring MVC セッションショッピングカートの基本的な流れを理解したら、次に考えるべきなのが、「カートから商品を削除する」「カートを空にする」といった操作です。実際のショッピングサイトでは、間違えて入れた商品を削除したり、買い物をやり直したくなったりする場面がよくあります。

セッションを使ったカート管理では、削除やクリアの処理も、基本的な考え方は変わりません。まずセッションからカート情報を取得し、中身を操作したあと、再びセッションに保存します。「セッションの中のデータを書き換える」というイメージを持つと理解しやすくなります。

例えば、特定の商品を削除する場合は、 List から対象の商品を取り除きます。一方、カートをすべて空にする場合は、 List を空にするか、セッション自体からカート属性を削除します。


@Controller
public class RemoveItemController {

    @GetMapping("/removeItem")
    public String removeItem(HttpSession session) {
        List<String> cart = (List<String>) session.getAttribute("cart");
        if (cart != null && !cart.isEmpty()) {
            cart.remove(0);
        }
        session.setAttribute("cart", cart);
        return "cart";
    }
}

この例では、カートの先頭にある商品を削除しています。実際には、商品識別子を使って削除対象を指定することが多いですが、基本構造としては同じです。


@Controller
public class ClearCartController {

    @GetMapping("/clearCart")
    public String clearCart(HttpSession session) {
        session.removeAttribute("cart");
        return "cart";
    }
}

このように、セッションからカート属性を削除すると、次回アクセス時にはカートが存在しない状態になります。これが、「カートをクリアする」という操作の正体です。

7. セッションを使ったカート実装での注意点

Spring MVC セッションショッピングカートは、実装が分かりやすく、初心者にも扱いやすい方法ですが、いくつか注意すべき点もあります。まず理解しておきたいのが、「セッションが切れるとカートが空になる」という挙動です。

セッションは永久に存在するものではありません。一定時間操作が行われなかった場合や、ブラウザを閉じたあとに有効期限が切れた場合、サーバ側ではセッションが破棄されます。その結果、セッションに保存されていたカート情報も同時に失われます。

これが、「なぜセッションが切れるとカートが空になるのか」の理由です。カートの中身は画面やブラウザではなく、サーバ側のセッションに保存されているため、セッションがなくなれば参照できなくなるのです。

また、実務でよく話題になるのが、セッション肥大化の問題です。セッションに大量のデータを詰め込みすぎると、サーバのメモリを圧迫し、アプリケーション全体の性能に影響が出ます。カートには必要最小限の情報だけを保存する、という意識が重要です。

さらに、同一ユーザーが複数タブで操作した場合や、連続したリクエストが同時に処理された場合など、セッションの同時アクセスにも注意が必要です。初心者の段階では深く考える必要はありませんが、「セッションは共有されている」という前提を知っておくと、後々の理解がスムーズになります。

8. 次に学ぶべきショッピングカートとセッション設計

ここまでで、 Spring MVC セッションショッピングカートの基礎的な実装と考え方を学んできました。セッションを使うことで、ページを移動しても状態を維持できる仕組みが、ショッピングカートを支えていることが分かったはずです。

ただし、セッションだけに頼ったカート実装には限界があります。セッションが切れればデータは失われ、別の端末からは同じカートを利用できません。実際のサービスでは、データベースと連携してカート情報を永続化する設計が必要になります。

また、ログイン機能と組み合わせることで、「ログインユーザーごとのカート管理」という次のステップに進むことができます。ここでは、セッションとユーザー情報をどう結び付けるか、という設計の考え方が重要になります。

さらに発展的な内容として、認証やアクセス制御を扱う仕組みを学ぶことで、より安全なショッピングカートを構築できます。 Spring MVCの基礎を理解したあとは、 Spring Securityなどの仕組みに触れていくと、実務に近い設計が見えてくるようになります。

今回学んだカート実装注意点やセッション管理の考え方は、そのまま次の学習テーマにつながります。小さな仕組みを一つずつ理解しながら、より実践的なWebアプリ開発へ進んでいきましょう。

Spring MVCでセッションを使ったショッピングカートの基礎実装をやさしく解説