SpringのModelAndViewクラスの使い方を完全ガイド！初心者でもわかるWebアプリ開発

SpringのModelAndView

先生と生徒の会話形式で理解しよう

生徒

「Springでビューとデータをまとめて扱えるクラスがあるって聞きました。それって何ですか？」

先生

「それはModelAndViewクラスのことですね。ビュー名とモデルデータをまとめて管理する便利なクラスです。」

生徒

「どうやって使うんですか？」

先生

「それでは、基本的な使い方から学んでいきましょう！」

1. ModelAndViewクラスとは？

ModelAndViewは、Spring MVCのorg.springframework.web.servletパッケージに含まれるクラスで、コントローラーからビュー名と画面に表示したいデータを「セット」で返すための入れ物のような存在です。

Webアプリでは、コントローラーが「どの画面（ビュー）を表示するか」と「その画面にどんな情報（モデル）を渡すか」を決めます。ModelAndViewは、この2つをまとめて扱うためのクラスで、画面遷移とデータ受け渡しを分かりやすく整理してくれます。

イメージとしては、「表示するHTMLファイル名」と「ユーザー名やメッセージなどの表示データ」がセットになった伝票のようなものです。コントローラーはこの伝票（ModelAndView）を返し、Springがその内容をもとにビューを表示します。

例えば、挨拶メッセージを1つだけ画面に表示したい場合、ModelAndViewを次のように使います。


// 画面名と表示データをまとめて準備するイメージ
ModelAndView mav = new ModelAndView("hello");      // hello.html という画面を表示したい
mav.addObject("message", "こんにちは、Webアプリ開発！"); // 画面に渡したいメッセージ

このように、ModelAndViewを使うと「どのビューに、どんなデータを渡すのか」がコード上で一目で分かるようになります。詳しい書き方や実際のコントローラーでの使い方は、次の章で順番に見ていきましょう。

2. ModelAndViewの基本的な使い方

ここでは、いちばん基本的な「1つの画面に1つのメッセージを表示する」パターンで、ModelAndViewの使い方を確認してみましょう。

流れとしてはとてもシンプルで、①どのURLにアクセスされたか、②どの画面（ビュー）を表示するか、③その画面にどんなデータを渡すか、という3つをコントローラーのメソッドで決めていきます。


import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class HelloController {

    @GetMapping("/hello")
    public ModelAndView hello() {
        ModelAndView mav = new ModelAndView("hello"); // 表示したいビュー名（hello.html）を指定
        mav.addObject("message", "こんにちは、Springの世界へ！"); // 画面に渡したいメッセージを追加
        return mav; // まとめた情報を返す
    }
}

このコードでは、ブラウザから/helloというURLにアクセスされたとき、helloというビュー名を持つ画面（通常はhello.html）を表示するように指定しています。また、addObjectメソッドでmessageという名前のデータを登録し、その値として「こんにちは、Springの世界へ！」という文字列を渡しています。

画面側では、このmessageという名前を使ってメッセージを取り出して表示します。どのURLにアクセスされたら、どの画面を開き、その画面にどんな文字列や値を渡すのか――それを1か所でまとめて書けるのがModelAndViewの基本的な使い方です。プログラミング未経験の方は、まず「URL→画面→表示データ」をひとまとめにして返している、というイメージだけつかんでおけば十分です。

3. ModelAndViewの主なメソッド

ModelAndViewには、ビューの指定や画面に渡すデータの追加など、Webアプリを作るうえで欠かせない基本的なメソッドが用意されています。ここでは、特によく使う3つを初心者向けにわかりやすく紹介します。

setViewName(String viewName): 「どの画面を表示するのか」を指定します。たとえばsetViewName("home")と書くと、home.htmlを表示するイメージです。
addObject(String attributeName, Object attributeValue): 画面に渡したいデータを1つ追加します。キー（変数名）と値をセットで登録する形です。
getModelMap(): 追加されたデータをまとめて確認できます。デバッグ時に便利なことがあります。

少しイメージしづらい場合は、次の簡単なサンプルを見ると理解しやすいでしょう。


ModelAndView mav = new ModelAndView();
mav.setViewName("info");                // info.html を表示したい
mav.addObject("title", "お知らせページ"); // 画面に渡すデータを追加
mav.addObject("count", 5);               // さらに別のデータを追加

このように、まず表示したいビュー名を設定し、続けて画面に表示したい情報をいくつでも追加できます。まるで画面に渡す荷物をひとつひとつ箱に入れていくようなイメージです。どのデータを渡したのかがコードで分かりやすく整理されるため、初心者でも扱いやすい構造になっています。

4. サンプル：複数データを渡す場合

実際のWebアプリでは、画面に名前だけでなく、年齢や説明文、メールアドレスなど、複数の情報をまとめて表示したい場面がよくあります。ModelAndViewでは、こうした複数データもaddObjectを繰り返すだけで簡単に追加できます。


@GetMapping("/details")
public ModelAndView details() {
    ModelAndView mav = new ModelAndView("details"); // details.html を表示したい
    mav.addObject("name", "John Doe");               // 名前データ
    mav.addObject("age", 30);                        // 年齢データ
    mav.addObject("email", "john.doe@example.com");  // メールアドレス
    return mav;
}

このコードは、ユーザーの基本情報をまとめて画面に渡すシンプルな例です。「箱（ModelAndView）の中にデータを順番に入れていく」と考えるとイメージしやすいでしょう。渡したデータは、ビュー側で${name}や${age}のように取り出して表示できます。複数項目を扱う場合でも仕組みは変わらないため、初心者でも迷わずに実装できるのが嬉しいポイントです。

5. ModelAndViewを使うメリット

なぜModelAndViewを使うべきなのでしょうか？その理由をいくつか挙げます：

ビュー名とデータを一緒に管理できるため、コードが簡潔になります。
複数のデータをまとめて渡す際に便利です。
コントローラーの戻り値としてそのまま使用できるため、処理が明確になります。

6. ModelAndViewの注意点

ModelAndViewを使用する際、以下の点に注意してください：

ビュー名は正確に記述する必要があります（例：テンプレートエンジンの設定に従う）。
データを正確に渡すために、addObjectの引数を確認してください。

7. ModelAndViewとRedirectの使い分け

ModelAndViewはビューへの通常遷移で使用されますが、リダイレクト処理をしたい場合には少し工夫が必要です。

リダイレクトにはsetViewName("redirect:/パス")を使用します。


@GetMapping("/redirectSample")
public ModelAndView redirectSample() {
    ModelAndView mav = new ModelAndView();
    mav.setViewName("redirect:/hello");
    return mav;
}

このように記述することで、/helloにリダイレクトされます。リダイレクト時はモデルデータが引き継がれない点に注意しましょう。

8. ModelAndViewとModelの違い

Springでは、ModelAndViewの他にもModelやModelMapを使ってデータを渡すことができます。これらの違いを理解しておくと、より柔軟なコーディングが可能になります。

ModelAndView：ビューとデータをまとめて返す。
Model：メソッド引数として使い、データのみを渡す。
ModelMap：Modelと似ており、Mapのように扱える。

初心者のうちはModelAndViewから始めて、徐々にModelやModelMapにも慣れていくのがおすすめです。

9. Thymeleafとの連携でModelAndViewを活用

Spring BootでビューにThymeleafを使っている場合、ModelAndViewで渡したデータはテンプレート内でそのまま利用できます。

以下の例では、コントローラーから渡されたmessageを表示するHTMLです：


<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>Hello Page</title>
</head>
<body>
    <h1 th:text="${message}">ここにメッセージが表示されます</h1>
</body>
</html>

Thymeleafを使えば、ModelAndViewで渡したオブジェクトを${変数名}で簡単にテンプレート内に表示できます。

まとめ

この記事では、Spring Frameworkで使用されるModelAndViewクラスについて詳しく学びました。このクラスは、ビュー名とモデルデータを一元管理できる便利なクラスで、コントローラーからHTMLビューにデータを渡す際に非常に役立ちます。

特に、初心者が陥りやすいポイントや注意点を解説しながら、基本的な使い方や便利なメソッドを具体的に紹介しました。これにより、実際のWebアプリケーション開発での活用イメージがつかめたはずです。

実践的な例として、複数データを渡す方法やaddObjectメソッドの活用例も取り上げました。これらを理解することで、より効率的にSpringの機能を使いこなすことができるでしょう。

最後に、コードの簡潔さや保守性を高めるために、ModelAndViewを積極的に活用することをおすすめします。

先生と生徒の振り返り会話

生徒

「今日学んだModelAndViewクラス、すごく便利ですね！ビュー名とデータをまとめて管理できるなんて、効率的だと思いました。」

先生

「その通りです。特に、複数のデータをビューに渡すときや、テンプレートエンジンを使用する場合に威力を発揮します。」

生徒

「コード例を見て、簡単に使えそうだと思いました。ただ、注意点の部分も気をつけないといけないですね。」

先生

「その点を意識しておけば、Springを使った開発がますますスムーズになりますよ。これからも繰り返し練習して、慣れていきましょう！」

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

質問1: Springの`ModelAndView`クラスは何に使うのですか？

回答: `ModelAndView`クラスは、コントローラーからビュー（HTMLファイル）にデータを渡すために使います。ビュー名とデータを一緒に管理することで、Webアプリケーションの開発を簡潔に行うことができます。

質問2: `ModelAndView`クラスを使うメリットは何ですか？

回答: 主なメリットは、ビュー名とモデルデータをまとめて管理できることです。コードがシンプルになり、複数データの管理やテンプレートエンジンとの連携がスムーズになります。

質問3: `setViewName`メソッドは具体的に何をするのですか？

回答: `setViewName`メソッドは、表示するビューの名前を指定します。たとえば、「hello」という名前を設定すれば、Springは`hello.html`というテンプレートを探してレンダリングします。

質問4: `addObject`メソッドの使い方がよく分かりません。

回答: `addObject`メソッドは、ビューに渡すデータを追加するために使います。第一引数にはデータの名前、第二引数にはデータそのものを指定します。たとえば、`addObject("message", "こんにちは")`とすると、ビューで`message`として使用できます。

質問5: `ModelAndView`を使う際の注意点は何ですか？

回答: ビュー名を正確に指定することと、`addObject`でデータ名を間違えないようにすることです。また、テンプレートエンジン（例: Thymeleaf）によるビュー解決の設定にも注意が必要です。

質問6: `ModelAndView`の代わりに他の方法も使えますか？

回答: はい、`Model`や`Map`を使う方法もあります。ただし、`ModelAndView`はビュー名とデータを一括で管理できるため、特にシンプルな構造が求められる場合に便利です。

質問7: サンプルコードの`@GetMapping`はどのような役割がありますか？

回答: `@GetMapping`は、HTTPのGETリクエストを受け取るためのアノテーションです。これにより、指定されたURLにアクセスした際に対応するメソッドが実行されます。

質問8: 複数のデータをビューに渡すにはどうすればいいですか？

回答: `addObject`メソッドを繰り返し使用することで、複数のデータを簡単に渡せます。たとえば、名前や年齢、メールアドレスなどを個別に追加できます。

質問9: Springでの`ModelAndView`の使用例をもう少し知りたいです。

回答: たとえば、データベースから取得したデータをHTMLテーブルに表示する場合にも`ModelAndView`が使えます。ビュー名を設定し、取得したデータを`addObject`で渡すことで簡単に実現できます。

質問10: ビュー名に拡張子（.htmlなど）を含める必要はありますか？

回答: 通常、テンプレートエンジンが設定されていれば拡張子を省略できます。ただし、プロジェクトの設定によっては明示的に拡張子を指定する必要がある場合もあります。

生成AIを基礎から学びたい方へ

ChatGPTなどの生成AIをこれから学びたい方に向けて、AIスキルアカデミーの口コミ・評判、料金、無料セミナーの内容を詳しくまとめています。

AIスキルアカデミーの口コミ・評判を詳しく見る

スタースクール：社会人向け実務教育プロジェクト

【職業訓練講師が直接指導】

社会人向けSpring Boot実務セミナー｜職業訓練講師が教えるWebシステム構築の極意

Java入門からSpring Boot実務まで。現場で絶賛される「設計の型」を最短距離で習得。

技術記事の内容を、自分の「スキル」へ変える。

職業訓練講師が最短攻略！社会人向けSpring Bootによる「商用Webシステム構築」の実践。

モダンJava開発の事実上の標準Spring Boot。本セミナーでは、その圧倒的利便性の核にある「DI（依存性の注入）」を完全解剖。「設定より規約」を体現した効率的なアーキテクチャ設計を学び、ThymeleafやSpring Data JPAを組み合わせた、現場で必須となるWebシステムの作り方を60分で濃縮体験します。

60分集中・Spring Boot実務ワークショップ

【つくるもの】
商用利用の基礎となる「会員管理システム」を構築。画面遷移に伴うデータ受渡しから、Spring Data JPAによるDB連携、バリデーション実装まで、Webアプリの「正解の型」をスタースクール流の最短距離で作り上げます。

【開発環境】
Spring Initializrを使用。LombokやSpring Boot DevToolsを駆使し、実務10年PLが実践する「コードを1行でも減らし、開発効率を極限まで高める」プロのセットアップを直接伝授します。

この60分で得られる3つの革新スキル

1. MVCモデルとDIコンテナの完全理解

なぜSpringが選ばれるのか？Controller・Service・Repositoryの役割分担を明確にし、保守性の高い「プロの設計」を習得します。

2. Spring Data JPAによる高速DBアクセス

複雑なSQLを書かずにデータを自在に操る。商用システムでのデータ操作をシンプルに、かつ安全に実装する勘所を学びます。

3. モダンなデータ連携（API化）への布石

通常のWeb画面構築に加え、将来的にスマホアプリ等と連携するための「JSONレスポンス」の仕組みなど、Restの基礎概念も合わせて伝授します。

※本講座は、Javaの基本を終え、即戦力エンジニアを目指す社会人のための「ハイクラス・フレームワーク実践セミナー」です。スタースクールがあなたのキャリアアップを全力でリードします。

社会人向けJava実務セミナーの詳細を見る

職業訓練講師による徹底指導

累計120万PV超の技術メディアが監修。理論の丸暗記ではない、
実務10年PLが実践する「一生モノの設計力」を、60分の濃縮セミナーで伝授します。

SpringのModelAndViewクラスの使い方を完全ガイド！初心者でもわかるWebアプリ開発

1. ModelAndViewクラスとは？

2. ModelAndViewの基本的な使い方

3. ModelAndViewの主なメソッド

4. サンプル：複数データを渡す場合

5. ModelAndViewを使うメリット

6. ModelAndViewの注意点

7. ModelAndViewとRedirectの使い分け

8. ModelAndViewとModelの違い

9. Thymeleafとの連携でModelAndViewを活用

まとめ

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

質問1: SpringのModelAndViewクラスは何に使うのですか？

回答: ModelAndViewクラスは、コントローラーからビュー（HTMLファイル）にデータを渡すために使います。ビュー名とデータを一緒に管理することで、Webアプリケーションの開発を簡潔に行うことができます。

質問2: ModelAndViewクラスを使うメリットは何ですか？

回答: 主なメリットは、ビュー名とモデルデータをまとめて管理できることです。コードがシンプルになり、複数データの管理やテンプレートエンジンとの連携がスムーズになります。

質問3: setViewNameメソッドは具体的に何をするのですか？

回答: setViewNameメソッドは、表示するビューの名前を指定します。たとえば、「hello」という名前を設定すれば、Springはhello.htmlというテンプレートを探してレンダリングします。

質問4: addObjectメソッドの使い方がよく分かりません。

質問5: ModelAndViewを使う際の注意点は何ですか？

回答: ビュー名を正確に指定することと、addObjectでデータ名を間違えないようにすることです。また、テンプレートエンジン（例: Thymeleaf）によるビュー解決の設定にも注意が必要です。

質問6: ModelAndViewの代わりに他の方法も使えますか？

回答: はい、ModelやMapを使う方法もあります。ただし、ModelAndViewはビュー名とデータを一括で管理できるため、特にシンプルな構造が求められる場合に便利です。

質問7: サンプルコードの@GetMappingはどのような役割がありますか？

回答: @GetMappingは、HTTPのGETリクエストを受け取るためのアノテーションです。これにより、指定されたURLにアクセスした際に対応するメソッドが実行されます。