混乱の理由は、使用方法が2つあるからでした。
つまり書く場所によって意味が異なります。
(もしかしたら私が気づいてない同じ意味合いがあるのかもしれない)
2つの使用方法
使用方法が大きく2つあります。
- パラーメータ内にアノテーションがある場合
- メソッドのアノテーションの場合
の2つです。
パラーメータ内にアノテーションがある場合
@RequestMapping(...)
public xxx handlePersonRequest(@ModelAttribute Person person, xxx){
^^^^^^^^^^^^^^^
...
}
となっているのが、「パラーメータ内にアノテーションがある場合」です。
主な用途としてはリクエスト
でやってきたフォーム
からのデータを受け取るときに使うこととなります。
「person
変数にフォーム
の値を詰めてね」といったような意味合いになります。
(補足)厳密にはGETリクエストのようにデータが渡ってこない場合は new Person()
の状態の空のオブジェクトが生成されるようだ
メソッドのアノテーションの場合
@ModelAttribute
public Person createPerson(){
return new Person();
}
となっているのが、「メソッドのアノテーションの場合」の場合です。
@Controller
内の@RequestMapping
のメソッドの実行前にこのメソッドが呼ばれます。
「createPersonメソッド
がPerson
オブジェクトを返すので、@RequestMapping
内のメソッドでいい感じに使ってくれ」
というような意味合いになります。
この生成されたオブジェクトはModel
に自動的に付与されているので、ビュー(Thymeleaf等)
側で使用できます。
参考
- https://stackoverflow.com/a/14616749/1979953
- Springで画面の入力値を受け取る - Qiita
- @ModelAttribute を使う
- 15. Web MVC framework
蛇足
最初に書いた「(もしかしたら私が気づいてない同じ意味合いがあるのかもしれない)」の自分なりの理解としては、
「パラーメータ内にアノテーションがある場合」「メソッドのアノテーションの場合」どちらも、@ModelAttribute
はコントローラ内のメソッドが走る前に処理されるという部分で同じである。
- 「パラーメータ内にアノテーションがある場合」は内部的にメソッドが走る前に
フォーム
の値が詰め込まれる - 「メソッドのアノテーションの場合」は内部的にメソッドが走る前に
アノテーションが付いたメソッドの返り値
が詰め込まれる