メソッドパラメーターに付与する@ModelAttributeは本当に必要？

Question

Spring MVCを勉強していて不明点があったので質問させて頂きました。

メソッドパラメーターに付与する@ModelAttributeの説明として、書籍には下記のイメージと記載がありました。

public String getSignup(Model model, @ModelAttribute SignupForm form)
↓　同様な振舞い
model.addAttribute("signupForm", form);    //あくまでイメージと注記

デバッガを使ってコントローラメソッドの開始冒頭でストップしmodelの中身を確認すると、確かに"signupForm"が登録されていました（メソッド冒頭なので、この時点では"SignupForm"のフィールドは全てnull）。

試しに、"SignupForm"に付与された@ModelAttributeを削除して再実行してみたら同じ結果となりました。

public String getSignup(Model model, SignupForm form)
↓　それでも同様な振舞い？
model.addAttribute("signupForm", form);

これを見て混乱してきたのですが、メソッドパラメーターに付与する@ModelAttributeは本当に必要なのでしょうか？
必要だとしたら、どこに効いてきているのでしょうか？

もしかしたら基本的な質問の可能性もあり恐縮ですが、回答いただけるとありがたいです。
よろしくお願いします。

Answer 1

この辺りはフレームワークが利便性のために多様な書き方を許していて、著者が説明を端折ったり理解していなかったりで入門書籍では曖昧なことになっていることが多いです。

公式リファレンスの次の箇所に説明があります。

• 1.3.3. Handler Methods > Method Arguments

  @ModelAttribute
  (前略)
  See “Any other argument” at the end of this table.

  Any other argument
  If a method argument is not matched to any of the earlier values in this table and it is a simple type (as determined by BeanUtils#isSimpleProperty, it is resolved as a @RequestParam. Otherwise, it is resolved as a @ModelAttribute.

上記の説明の通り、 SignupForm のような独自定義型は、アノテーションを付けても付けなくても ModelAttribute として解釈されます。

Comments

[yokota101010]

回答ありがとうございます。理解できました。