Spring MVC的常用注解（学习笔记）

在Spring MVC简介(学习笔记)一文中稍微提到了@Controller及@RequestMaaping这两个注解。
其中使用了@Controller可以不用通过继承的方法来创建控制器。而使用@RequestMapping则是可以将原本需要在Spring MVC配置文件中写的映射信息转移到Controller的类中来。

 public class HelloController implements Controller{
    ...
    ModelAndView handleRequest(HTtpServletReqeust request,HttpServletResponse response) throws Exceptiona{
        ...
    }
}

Spring2.5版本以后新增了基于注解的控制器。

@Controller
@RequestMapping(value="/user")
public class UserController{
    ...
    @RequestMapping(value="/register")
    public ModelAndView register(){
        ...
    }

    @RequestMapping(value="/login")
    public ModelAndView login(){
        ...
    }
}

这时候可以分别映射到：
http: //localhost:8080/user/register和
http: //localhost:8080/user/login这两个请求。
RequestMapping注解用于映射URL请求，value属性表示虚拟路径，但在实际的开发中，还有其他的要求。例如如果要求request中包含某些指定的header指定，才对请求进行处理，那么就可以利用headers属性。而使用method属性来指定仅仅处理哪些HTTP请求方式。
并且在请求方法中，可以有不同类型的参数，如下面代码所示，可以使用HttpServletRequest做参数，也可以使用HttpSession作为参数(还支持很多其他类型的参数)。而不使用注解时，handleRequest方法都是使用HttpServletRequest和HttpServletResponse作为参数。

public String login(HttpServletRequest request){...}
public String login(HttpSession session){...}

不使用注解时，handleRequest必须返回一个ModelAndView对象，而使用注解后，方法返回的可以是ModelAndView、String、Map、void等不同的类型。

@ModelAttribute注解与Model和ModelMap

在《两个登录案例的区别》中案例1讲述如何通过session实现用户的登录：LoginServlet接受来自JSP页面的参数，如果验证通过就创建user对象，并保存到Session对象的user属性中。在Spring MVC中，也有对应的@SessionAttributes注解，但这里介绍的是@ModelAttribute注解，它使用Model和ModelMap来存储数据模型。并且在调用处理方法前创建模型对象。

@Controller
public class UserController{
    ...
    @ModelAttribute
    public void userModel(String loginname,String password,Model model){
        //创建User对象存储jsp页面传入的参数
        ...
        //将USer对象添加到Model当中
        model.addAttribute("user",user);
    }
    @RequestMapping(value="/login")
    public String login(Model model){
        User user = (USer) model.asMap().get("user");
        ...
    }
}

这里的Model其实起到类似session的作用（指保存数据方面）。当然这里也有个问题就是Servlet中session的数据是可以共用的，这里不知可不可以。
@Modelattribute注解会在Controller每个方法执行前被调用，所以如果一个Controller映射到多个URL的时候要谨慎使用。
@ModelAttribute属性有多种使用方法。按照现在的理解，如果@ModelAttribute后面跟了一个String属性，例如：

@ModelAttribute("loginname")
public String UserModel(..){
    ...
    return ...;
}

表示注解的value为loginname，也就是说model有一个loginname的属性，而该属性的值就是UserModel()函数的返回值。跳转到显示页面以后，就能够在JSP页面中通过requestScope中访问到该属性。（EL表达式为${requestScope.loginname}）。
也可以将@ModelAttribute("loginname")放在@RequestMaaping指定的方法中，这样loginname属性的值就是该方法的返回值。也就是说@ModelAttribute和@RequestMaaping可以共用一个方法。

如果@ModelAttribute后面没有跟一个注解的value字符串。有可能是因为Model需要添加多个属性。这样的话可以在具体的方法中通过addAttribute()方法为Model添加多个属性：

@ModelAttribute
public void UserModel1(..,Model model){
    ...
    model.addAttribute("loginname",..);
    ...
    model.addAttribute("password",..);
}

可以看到，这里方法返回的是void类型。并且在方法中需要传入一个Model类型的参数。除此以外，还可以通过该注释返回一个对象。

@Controller
public class ModelAttributeController{
    public User find(..){
        ..
        return user;
    }
    @ModelAttribute
    public void UserModel1(..){
        return find(..);            
    }

    @RequestMapping(value="/login")
    public String login(){
        ...
    }
}

这里@ModelAttribute后面同样没有跟一个注解的value字符串，所以这里其实没有指定Model的属性名称，属性名称通过返回类型隐含表示，由于返回的是User类型，所以属性名称就是“user”。该属性名称返回的也是一个user对象。也不需要在方法体中传入Model对象。

参数绑定注解

@RequestParam @PathVariable @RequestHeader
@CookieValue @SessionAttributes

这里其实很容易联想到EL表达式。在《EL表达式与JSP标签（学习笔记）》一文中，提到EL表达式中隐式对象param、paramValues、header、headerValues、cookie都是针对request而言的，也就是说这五个隐式对象都是为了获取请求信息的方便。而在这里的这几个注解也是起到类似的作用。但是关键差别在于EL表达式是用在JSP页面中的，而这里的参数绑定注解则是用于Controller（也就是相当于以前的Servlet）。也就是说，现在不仅在JSP页面中获取请求信息方便，连在Controller这个业务控制器中获取请求信息也变得很便捷。

@RequestMapping(value="/register",method=RequestMethod.POST)
Public String register(
    @RequestParam("loginname") String loginname,
    @RequestParam("password") String password,
    @RequestParam("username") String password,
    ){...}

这里就相当于一步到位，将Request请求中的参数直接传递作为register(）方法中的参数。@PathVariable则是用于获得请求URL中的动态参数。其他的一些参数暂时不做讨论。在后面实战的过程中再深入了解。

Spring MVC的常用注解（学习笔记）

@ModelAttribute注解与Model和ModelMap

参数绑定注解

@ModelAttribute注解与`Model`和`ModelMap`