Spring - @ModelAttribute注解的使用

Posted W_王菇凉的D_戴同学

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Spring - @ModelAttribute注解的使用相关的知识,希望对你有一定的参考价值。

@ModelAttribute注解的使用

在SpringMVC的Controller中使用@ModelAttribute时,其位置包括下面三种:

  • 应用在方法上
  • 应用在方法的参数上
  • 应用在方法上,并且方法也使用了@RequestMapping

应用在方法上

首先说明一下,被@ModelAttribute注解的方法会在Controller每个方法执行之前都执行,因此对于一个Controller中包含多个URL的时候,要谨慎使用。

1)使用@ModelAttribute注解无返回值的方法

@Controller
@RequestMapping(value = "/modelattribute")
public class ModelAttributeController {

    @ModelAttribute
    public void myModel(@RequestParam(required = false) String abc, Model model) {
        model.addAttribute("attributeName", abc);
    }

    @RequestMapping(value = "/method")
    public String method() {
        return "method";
    }
}

 

这个例子,在请求/modelattribute/method?abc=aaa后,会先执行myModel方法,然后接着执行method方法,参数abc的值被放到Model中后,接着被带到method方法中。

当返回视图/modelattribute/method时,Model会被带到页面上,当然你在使用@RequestParam的时候可以使用required来指定参数是否是必须的。

如果把myModelmethod合二为一,代码如下,这也是我们最常用的方法:

@RequestMapping(value = "/method")
public String method(@RequestParam(required = false) String abc, Model model) {
    model.addAttribute("attributeName", abc);
    return "method";
}

2)使用@ModelAttribute注解带有返回值的方法

@ModelAttribute
public String myModel(@RequestParam(required = false) String abc) {
    return abc;
}

@ModelAttribute
public Student myModel(@RequestParam(required = false) String abc) {
    Student student = new Student(abc);
    return student;
}

@ModelAttribute
public int myModel(@RequestParam(required = false) int number) {
    return number;
}

 

对于这种情况,返回值对象会被默认放到隐含的Model中,在Model中的key返回值首字母小写value为返回的值。

上面3种情况等同于:

model.addAttribute("string", abc);
model.addAttribute("int", number);
model.addAttribute("student", student);

在jsp页面使用${int}表达式时会报错:javax.el.ELException: Failed to parse the expression [${int}]
解决办法:
在tomcat的配置文件conf/catalina.properties添加配置org.apache.el.parser.SKIP_IDENTIFIER_CHECK=true

如果只能这样,未免太局限了,我们很难接受keystringintfloat等等这样的。

想自定义其实很简单,只需要给@ModelAttribute添加value属性即可,如下:

@ModelAttribute(value = "num")
public int myModel(@RequestParam(required = false) int number) {
    return number;
}

这样就相当于model.addAttribute("num", number);

使用@ModelAttribute注解的参数

@Controller
@RequestMapping(value = "/modelattribute")
public class ModelAttributeParamController {

    @ModelAttribute(value = "attributeName")
    public String myModel(@RequestParam(required = false) String abc) {
        return abc;
    }

    @ModelAttribute
    public void myModel3(Model model) {
        model.addAttribute("name", "zong");
        model.addAttribute("age", 20);
    }

    @RequestMapping(value = "/param")
    public String param(@ModelAttribute("attributeName") String str,
                       @ModelAttribute("name") String str2,
                       @ModelAttribute("age") int str3) {
        return "param";
    }
}

 

从代码中可以看出,使用@ModelAttribute注解的参数,意思是从前面的Model中提取对应名称的属性。

这里提及一下@SessionAttributes的使用:

  • 如果在类上面使用了@SessionAttributes("attributeName")注解,而本类中恰巧存在attributeName,则会将attributeName放入到session作用域。
  • 如果在类上面使用了@SessionAttributes("attributeName")注解,SpringMVC会在执行方法之前,自动从session中读取keyattributeName的值,并注入到Model中。所以我们在方法的参数中使用ModelAttribute("attributeName")就会正常的从Model读取这个值,也就相当于获取了session中的值。
  • 使用了@SessionAttributes之后,Spring无法知道什么时候要清掉@SessionAttributes存进去的数据,如果要明确告知,也就是在方法中传入SessionStatus对象参数,并调用status.setComplete就可以了。

应用在方法上,并且方法上也使用了@RequestMapping

@Controller
@RequestMapping(value = "/modelattribute")
public class ModelAttributeController {

    @RequestMapping(value = "/test")
    @ModelAttribute("name")
    public String test(@RequestParam(required = false) String name) {
        return name;
    }
}

 

这种情况下,返回值String(或者其他对象)就不再是视图了,而是放入到Model中的值,此时对应的页面就是@RequestMapping的值test
如果类上有@RequestMapping,则视图路径还要加上类的@RequestMapping的值,本例中视图路径为modelattribute/test.jsp

 

以上是关于Spring - @ModelAttribute注解的使用的主要内容,如果未能解决你的问题,请参考以下文章

Spring MVC @ModelAttribute 方法

spring 中@ModelAttribute、model.addAttribute 有啥区别?

Spring的@ModelAttribute注解

(转)spring学习之@ModelAttribute运用详解

Spring:绑定对象有和没有@ModelAttribute

spring mvc@ModelAttribute与@SessionAttributes的执行流程