SpringのModelAndViewクラスとaddObjectメソッドの使い方を完全ガイド！初心者でも安心
生徒
「Springでコントローラーからデータをビューに渡す方法を教えてください！」
先生
「SpringではModelAndViewクラスを使って、ビューとデータを一緒に管理することができます。」
生徒
「具体的にはどのように使うんですか？」
先生
「それでは、ModelAndViewクラスの基本とaddObjectメソッドの使い方を見ていきましょう！」
1. SpringのModelAndViewクラスとは？
SpringのModelAndViewクラスは、コントローラーから画面（ビュー）に渡したい情報をまとめて持っておくための「入れ物」のようなクラスです。画面のテンプレート名と、画面に表示したいデータ（モデル）を一つのオブジェクトとして管理できるので、初心者でも処理の流れを理解しやすくなります。
もう少しイメージしやすく言うと、「どの画面を表示するか」という情報と、「その画面にどんな内容を表示するか」という情報を、宅配便の箱に一緒に詰めて受け渡しするような感覚です。コントローラーは箱（ModelAndView）に中身を入れて返すだけなので、処理がシンプルになり、コードも読みやすく整理された形になります。
例えば、ユーザー情報を表示するページを考えてみましょう。ユーザー一覧を表示する画面では、「どのテンプレートを使うか」というビュー名と、「ユーザーの名前やID」といったデータをセットで用意する必要があります。ここでModelAndViewを使えば、次のようにビュー名だけ先に設定しておくことができます。
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("userView"); // 「userView」という画面を表示する指定
このように、まずはどの画面を表示するかをModelAndViewに登録し、その後で画面に表示したいデータを少しずつ追加していく、という使い方が基本になります。コントローラーからは最終的にこのModelAndViewを返すだけなので、「どの画面に」「どんなデータを渡したのか」が一目で分かる、初心者にも扱いやすいクラスです。
2. addObjectメソッドとは？
addObjectメソッドは、ModelAndViewに「画面に渡したいデータ」を入れるためのメソッドです。かんたんに言うと、「名前付きでデータを箱に入れる」ための機能で、Spring MVCで画面表示をするときによく使われます。
このメソッドは、最初の引数に「キー（名前）」、二つ目の引数に「実際の値」を渡します。ビュー側（テンプレート）では、キーの名前を使って値を取り出して表示します。HTMLのテンプレートエンジン（ThymeleafやJSPなど）から、「username」や「message」といった名前で参照されるイメージです。
ModelAndView modelAndView = new ModelAndView("userView");
modelAndView.addObject("username", "太郎");
modelAndView.addObject("message", "こんにちは");
上のサンプルでは、"userView"というビューに対して、"username"という名前で「太郎」、"message"という名前で「こんにちは」という文字列を渡しています。テンプレート側ではusernameやmessageというキーを使って値を表示できるので、「どの値がどの項目に対応しているのか」が分かりやすくなります。
同じModelAndViewに対してaddObjectを何回も呼び出せるため、「ユーザー名」「メッセージ」「日付」など、必要な情報を少しずつ追加していくことができます。プログラミング初心者の方でも、「名前を付けてデータを詰めておくメソッド」と覚えておくと理解しやすいでしょう。
3. 基本的な使い方
ここからは、実際にModelAndViewクラスとaddObjectメソッドを使って、コントローラーから画面にデータを渡す一連の流れを見ていきます。難しいことはしていないので、「こんな感じで書くんだな」というイメージをつかむつもりで眺めてみてください。
ポイントは「どの画面を表示するかを決める」「画面に渡したいデータをaddObjectで詰める」「最後にModelAndViewを返す」という三つのステップだけです。
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.servlet.ModelAndView;
@Controller
public class UserController {
@GetMapping("/user")
public ModelAndView user() {
// ① 空のModelAndViewを用意
ModelAndView modelAndView = new ModelAndView();
// ② 表示したい画面（ビュー）の名前を指定
modelAndView.setViewName("userView");
// ③ 画面に渡したいデータをaddObjectで追加
modelAndView.addObject("username", "太郎");
modelAndView.addObject("message", "こんにちは、Spring MVCの世界へ！");
// ④ 最後にModelAndViewを返す
return modelAndView;
}
}
このサンプルでは、@GetMapping("/user")によって「/userというURLにアクセスされたときに、このuserメソッドが呼び出される」というルールを定義しています。メソッドの中では、まずModelAndViewの入れ物を作り、setViewNameで「userViewという名前の画面を表示する」と指定しています。
そのあとで、addObjectを使って"username"と"message"という二つのキーに対して、「太郎」と「こんにちは、Spring MVCの世界へ！」という文字列を詰め込んでいます。ビュー側のテンプレートでは、このキー名を使って値を取り出して表示するだけなので、「コントローラーでデータを用意して、ビューで表示する」というWebアプリらしい流れを自然に表現できます。
最終的にreturn modelAndView;でModelAndViewを返すことで、「どの画面に」「どんなデータを渡すのか」がまとめてフレームワークに伝えられます。プログラミング未経験の方は、まずはこの形をひな形として覚えてしまい、文字列の部分だけ自分の好きなメッセージに書き換えて試してみると理解しやすくなります。
4. 実行結果の例
上記のコントローラーをビルドしてアプリケーションを起動し、ブラウザで/userにアクセスすると、先ほどaddObjectで詰めたデータがビューに渡され、画面に表示されます。ここでは、usernameとmessageをシンプルに出力した場合のイメージを確認してみましょう。
ユーザー名: 太郎
メッセージ: こんにちは、Spring MVCの世界へ！
実際のテンプレートでは、usernameやmessageというキー名を使って値を取り出し、HTMLの中に差し込んで表示しています。文字列の中身を変えれば表示される内容もすぐに変わるので、「コントローラーで用意した値が、そのまま画面のテキストになるんだな」という感覚がつかみやすいはずです。まずはこのような単純な画面表示から試してみて、Spring MVCとModelAndViewの動きを体で覚えていきましょう。
5. 応用編：複数のデータを追加する
addObjectメソッドは、一つのデータだけでなく、画面に必要な情報をいくつもまとめて追加することができます。実際のWebアプリでは、「タイトル」「件数」「メッセージ」など、複数の値を同時に表示したい場面が多いので、この使い方を覚えておくととても便利です。
たとえば、管理画面のダッシュボードをイメージしてみましょう。画面の上部にタイトル、その下に「ユーザー数」や「アクティブなセッション数」といった数字を表示したい場合、次のように複数のデータをaddObjectで詰め込むことができます。
@GetMapping("/dashboard")
public ModelAndView dashboard() {
ModelAndView modelAndView = new ModelAndView("dashboardView");
// 画面のタイトル
modelAndView.addObject("title", "ダッシュボード");
// 登録されているユーザー数
modelAndView.addObject("userCount", 120);
// 現在アクティブなセッション数
modelAndView.addObject("activeSessions", 35);
return modelAndView;
}
このコードでは、title、userCount、activeSessionsという三つのキーに、それぞれタイトル文字列と数値をセットしています。ビュー側のテンプレートでは、これらのキー名を使って値を取り出し、「画面タイトル」「ユーザー人数」「アクティブな利用状況」として好きなレイアウトで表示できます。
このように、addObjectを何度も呼び出すことで、「画面に必要な情報を一式まとめてModelAndViewに詰める」という書き方が自然にできるようになります。最初はサンプルの数字をそのまま使い、慣れてきたら実際のユーザー数やログイン中の人数など、アプリケーションの処理結果を渡すように発展させていくと理解が深まります。
6. よくある質問
Q: addObjectメソッドで追加するデータの型に制限はありますか？
A: 制限はありません。任意のJavaオブジェクトを渡すことができます。ただし、ビュー側で正しく扱うためには、そのデータをテンプレートエンジンで適切に処理する必要があります。
Q: ModelAndViewを使わずにデータを渡す方法はありますか？
A: はい、SpringではModelインターフェースやRedirectAttributesを使用する方法もあります。ただし、ModelAndViewはビュー名とデータをまとめて扱える点で便利です。
7. まとめ
SpringのModelAndViewクラスとaddObjectメソッドについて学んできました。ModelAndViewは、コントローラーからビュー名とデータを一緒に管理するための便利なクラスであり、addObjectメソッドを使用することで、ビューに渡すデータを簡単に設定できます。
特に、動的なビューの作成や、複数のデータを渡す必要がある場合に、このクラスとメソッドを利用することで、開発がより効率的になります。また、テンプレートエンジンとの組み合わせによって、データを柔軟にレンダリングできる点も大きな特徴です。
以下に、まとめとして簡単なコード例を記載します。
@GetMapping("/summary")
public ModelAndView summary() {
ModelAndView modelAndView = new ModelAndView("summaryView");
modelAndView.addObject("title", "Springの基本");
modelAndView.addObject("description", "ModelAndViewとaddObjectメソッドの活用例です。");
return modelAndView;
}
上記のコードでは、ビュー名としてsummaryViewを設定し、タイトルと説明をデータとして渡しています。この基本的な使い方を応用して、より複雑なアプリケーションにも対応できます。
生徒
「ModelAndViewクラスとaddObjectメソッドを使うことで、データを簡単にビューに渡せることがわかりました！」
先生
「その通りです。これらを使えば、コントローラーでのデータ管理が非常に効率的になりますね。」
生徒
「次は、テンプレートエンジンとの組み合わせを試してみたいです！」
先生
「ぜひ！ThymeleafやJSPを使えば、ビューの構築がさらに楽しくなりますよ。」
この記事を読んだ人からの質問
プログラミング初心者からのよくある疑問／質問を解決します
SpringのModelAndViewクラスはどのような場面で使いますか？
SpringのModelAndViewクラスは、コントローラーからビュー名とデータを同時に管理したいときに使います。特に、動的にデータをビューに渡す必要がある場合に便利です。
addObjectメソッドで複数のデータを渡すことはできますか？
はい、できます。addObjectメソッドを複数回呼び出して、異なるキーと値のペアを追加することで、複数のデータをビューに渡すことが可能です。
addObjectメソッドで渡すデータはどんな型でも良いですか？
はい、addObjectメソッドでは任意のJavaオブジェクトを渡すことができます。ただし、ビュー側で正しく処理されるように、テンプレートエンジンの対応を確認してください。
ModelAndViewクラスを使わずにデータを渡す方法はありますか？
はい、SpringではModelインターフェースやRedirectAttributesを使うことで、ModelAndViewを使用せずにデータを渡すことができます。
addObjectメソッドを使う場合、ビュー名を動的に変更できますか？
はい、setViewNameメソッドを併用すれば、条件に応じてビュー名を動的に変更しながらaddObjectでデータを渡すことが可能です。
Springのテンプレートエンジンには何がありますか？
Springでよく使用されるテンプレートエンジンには、Thymeleaf、JSP、Freemarker、Velocityなどがあります。初心者にはThymeleafがわかりやすいでしょう。
Spring MVCでビューに渡すデータの管理方法は？
ModelAndViewクラスを使う方法が一般的ですが、シンプルなケースではModelインターフェースを使うこともできます。状況に応じて使い分けましょう。
Spring BootでもModelAndViewは使えますか？
はい、Spring BootでもModelAndViewクラスは使用可能です。Spring BootはMVCの設定を簡素化するため、すぐに利用できます。
ビュー名に間違いがある場合、どうなりますか？
指定されたビュー名が存在しない場合、Springはエラーをスローします。テンプレートエンジンの設定とビュー名が一致していることを確認してください。
テンプレートエンジンとModelAndViewの連携例を教えてください。
テンプレートエンジンでの連携では、addObjectでデータを渡し、テンプレート内でそのデータを変数として使用します。例えば、Thymeleafでは${variableName}の形式でデータを表示できます。
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つの革新スキル
なぜSpringが選ばれるのか？Controller・Service・Repositoryの役割分担を明確にし、保守性の高い「プロの設計」を習得します。
複雑なSQLを書かずにデータを自在に操る。商用システムでのデータ操作をシンプルに、かつ安全に実装する勘所を学びます。
通常のWeb画面構築に加え、将来的にスマホアプリ等と連携するための「JSONレスポンス」の仕組みなど、Restの基礎概念も合わせて伝授します。
※本講座は、Javaの基本を終え、即戦力エンジニアを目指す社会人のための「ハイクラス・フレームワーク実践セミナー」です。スタースクールがあなたのキャリアアップを全力でリードします。
累計120万PV超の技術メディアが監修。理論の丸暗記ではない、
実務10年PLが実践する「一生モノの設計力」を、60分の濃縮セミナーで伝授します。
