Spring MVC系列之模型绑定(SpringBoot)(七)

前言

上一节我们在SpringBoot中启用了Spring MVC最终输出了HelloWorld,本节我们来讲讲Spring MVC中的模型绑定,这个名称来源于.NET或.NET Core,不知是否恰当,我们暂且这样理解吧。

@RequestParam VS  @PathVariable

 一看注解名称应该非常好理解,注解@RequestParam主要用来获取查询字符串参数,而注解@PathVaruable用于获取路由参数,下面我们来看如下一个例子:

    @ResponseBody
    @RequestMapping(value = "/demo1", method = RequestMethod.GET)
    public String demo1(@RequestParam(value = "param1", required = true, defaultValue = "jeffcky") String param1,
                        @RequestParam(value = "param2", required = false) String param2) {
        return param1 + "," + param2;
    }

 

如上我们获取查询字符串参数param1和param2,同时呢,我们要求参数param1必须提供,若为空,我们给定默认值为jeffcky,而参数param2可不提供,则为其默认值,比如如下:

我们知道无论是注解@RequestParam还是注解@PathVariable,都有属性required,若为false,则此参数无需提供,难道事实真的如此吗,我们看看如下示例:

    @ResponseBody
    @RequestMapping(value = "/demo3/{id}", method = RequestMethod.GET)
    public String demo3(@RequestParam(value = "id") String param1, @PathVariable(value = "id", required = false) String param2) {
        return param1 + "," + param2;
    }

我们设置了路由上的变量id为可选,当我们请求时我们也并未提供该参数,但是结果却是404,这也证明:注解@RequestParam获取查询字符串,而注解@PathVariable获取路由参数,虽然二者注解提供参数(required)可选,但是针对注解@PathVariable该参数无效,而且参数必须提供,否则返回404。

深入探讨注解@RequestParam

上述是我们针对路由和查询字符串注解的对比,接下来我们来看看对于查询字符串注解各种姿势,看看Spring是如何进行处理的呢,比如我们有两个根据注解@RequestParam的请求参数和方法一样,此时将会发生什么呢?,如下:

    @RequestMapping(value = "/user", method = RequestMethod.GET)
    @ResponseBody
    public String say() {
        return "hello world";
    }

    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public ModelAndView user() {
        User user = new User();
        user.setGender("M");
        ModelAndView modelAndView = new ModelAndView("user", "command", user);
        return modelAndView;
    }

很显然会启动程序后会抛出上述异常,意为不明确有两个相同的映射,那么要是我们将say方法的请求方法给去掉,此时将表明可此方法的请求不受限制,如此这样会报错吗?如若不报错,那么会首先匹配到哪个呢?

    @RequestMapping(value = "/user")
    @ResponseBody
    public String say() {
        return "hello world";
    }

    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public ModelAndView user() {
        User user = new User();
        user.setGender("M");
        ModelAndView modelAndView = new ModelAndView("user", "command", user);
        return modelAndView;
    }

由此我们可以知道:注解@RequestParam用于查询字符串,若请求参数一致, 但一个请求方法未指定(接收所有方法),一个指定对应请求方法,结果将匹配到指定对应的请求方法。那么要是我们想让其匹配到say方法,我们应该肿么办呢?注解@RequestParam的参数为数组,接下来我们将say方法进行如下修改即可(参数顺序可颠倒):

    @RequestMapping(value = {"/user", "*"})
    @ResponseBody
    public String say() {
        return "hello world";
    }

@ModelAttribute VS ModelMap VS ModelAndView

既然涉及到参数绑定,那么我们就得学习Spring MVC表单提交,顺着这个思路我们来学习Spring MVC表单相关内容,如上图其实我已经给大家展示了对应方法和视图,接下来我们来通过表单提交来讲讲三者的区别,为了有些童鞋可能需要亲自动手实践,这里我们先给出整个结构,如下:

我们创建如下进行表单提交的用户实体类

package com.demo.springboot.model;

public class User {
    private String firstName;
    private String lastName;
    private String gender;
    private String email;
    private String userName;
    private String password;

    public String getFirstName() {
        return firstName;
    }

    public void setFirstName(String firstName) {
        this.firstName = firstName;
    }

    public String getLastName() {
        return lastName;
    }

    public String getGender() {
        return gender;
    }

    public void setGender(String gender) {
        this.gender = gender;
    }

    public void setLastName(String lastName) {
        this.lastName = lastName;
    }

    public String getEmail() {
        return email;
    }

    public void setEmail(String email) {
        this.email = email;
    }

    public String getUserName() {
        return userName;
    }

    public void setUserName(String userName) {
        this.userName = userName;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

接下来我们需要在控制器文件目录下创建UserController控制器,然后呢,我们返回用户视图,如下方法:

    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public ModelAndView user() {
        User user = new User();
        user.setGender("M");
        ModelAndView modelAndView = new ModelAndView("user", "command", user);
        return modelAndView;
    }

在前面内容我们通过字符串的形式返回的视图,然后加上通过配置文件中视图存放位置和加上后缀查找视图,但是利用ModelAndView才是最友好的方式,通过其名称添加模型和返回视图应该就很清楚了,就像.NET MVC中的View方法一样,我们可以返回模型数据,同时指定视图名称是一个道理。上述我们设置了性别的默认值为字符串M,我们暂且先说到这里,待会还要回过头再次进行讲解的,接下来我们去创建user.jsp,如下:

<%@ page language="java" contentType="text/html;" pageEncoding="utf-8" %>
<%@ taglib uri="http://www.springframework.org/tags/form" prefix="form" %>
<html>

<head>
    <title>Spring MVC Form</title>
    <link href="/static/css/bootstrap.min.css" rel="stylesheet">
    <link href="/static/css/bootstrap-theme.min.css" rel="stylesheet">
</head>

<body>
<div class="container">
    <div class="col-md-offset-2 col-md-7">
        <h2 class="text-center">Spring MVC 5 Form</h2>
        <div class="panel panel-info">
            <div class="panel-heading">
                <div class="panel-title">Sign Up</div>
            </div>
            <div class="panel-body">
                <form:form action="addUser" class="form-horizontal"
                           method="post" modelAttribute="user">

                    <div class="form-group">
                        <label for="firstName" class="col-md-3 control-label">First
                            Name</label>
                        <div class="col-md-9">
                            <form:input path="firstName" class="form-control"/>
                        </div>
                    </div>
                    <div class="form-group">
                        <label for="lastName" class="col-md-3 control-label">Last
                            Name</label>
                        <div class="col-md-9">
                            <form:input path="lastName" class="form-control"/>
                        </div>
                    </div>
                    <div class="form-group">
                        <form:label path="gender" class="col-md-3 control-label">gender</form:label>
                        <div class="col-md-9">
                            <form:radiobutton path="gender" value="M" label="Male"/>
                            <form:radiobutton path="gender" value="F" label="Female"/>
                        </div>
                    </div>
                    <div class="form-group">
                        <label for="userName" class="col-md-3 control-label">User
                            Name </label>
                        <div class="col-md-9">
                            <form:input path="userName" class="form-control"/>
                        </div>
                    </div>

                    <div class="form-group">
                        <label for="password" class="col-md-3 control-label">Password</label>
                        <div class="col-md-9">
                            <form:password path="password" class="form-control"/>
                        </div>
                    </div>
                    <div class="form-group">
                        <label for="email" class="col-md-3 control-label">Email</label>
                        <div class="col-md-9">
                            <form:input path="email" class="form-control"/>
                        </div>
                    </div>
                    <div class="form-group">
                        <div class="col-md-offset-3 col-md-9">
                            <form:button class="btn btn-primary">Submit</form:button>
                        </div>
                    </div>

                </form:form>
            </div>
        </div>
    </div>
</div>
<script type="text/javascript" src="/static/js/jquery.min.js"></script>
<script type="text/javascript" src="/static/js/bootstrap.min.js"></script>
</body>
</html>

首先我们必须在其顶部添加如下这一行表明我们要使用spring framework框架中的表单,且前缀为form:

<%@ taglib uri="http://www.springframework.org/tags/form" prefix="form" %>

在spring framework框架中对于表单中各个标签的使用通过冒号隔开,如下:

<form:input path="firstName"/>
<form:input path="lastName"/>

最终在浏览器中将渲染成HTML标签,还是非常简单,这里我们只是稍微过一下,没有太多复杂的东西,我们只要知道规则即可

<input name="firstName" type="text" value=""/>
<input name="lastName" type="text" value=""/>

我们在后台方法中返回模型即user,最终利用spring框架将模型上的属性绑定到表单标签上,那么接下来我们提交表单后,我们在后台怎么获取到模型数据呢,其实我们在spring框架的表单标签上定义了属性modelAttribute,如下:

接下来我们在后台接收表单中的数据,如下:

    @RequestMapping(value = "/addUser", method = RequestMethod.POST)
    public String addUser(@ModelAttribute("user") User user,
                          ModelMap model) {
        model.addAttribute("firstName", user.getFirstName());
        model.addAttribute("lastName", user.getLastName());
        model.addAttribute("email", user.getEmail());
        model.addAttribute("userName", user.getUserName());
        model.addAttribute("password", user.getPassword());
        return "users";
    }

在后台我们同样通过注解@ModelAttribute("user")与表单上定义的属性modelAttribute="user"匹配,从而获取数据,最终将获取到的数据添加到ModelMap中,并返回视图users.jsp中,如下:

<%@ page language="java" contentType="text/html;" pageEncoding="utf-8" %>
<%@taglib uri = "http://www.springframework.org/tags/form" prefix = "form"%>
<html>

<head>
    <title>Spring MVC Form Handling</title>
</head>

<body>
<h2>Submitted User Information</h2>
<table>
    <tr>
        <td>firstName</td>
        <td>${firstName}</td>
    </tr>
    <tr>
        <td>lastName</td>
        <td>${lastName}</td>
    </tr>
    <tr>
        <td>Email</td>
        <td>${email}</td>
    </tr>
    <tr>
        <td>userName</td>
        <td>${userName}</td>
    </tr>
    <tr>
        <td>Password</td>
        <td>${password}</td>
    </tr>
    <tr>
    </tr>
</table>
</body>
</html>

当我们启动程序时发现报错了,根据我们一路的解释,似乎没有任何毛病,这是何缘故, 上述异常大概是表明特性user出了问题,其实原因出在后台获取用户视图上,如下这一行上:

ModelAndView modelAndView = new ModelAndView("user", "command", user);

如上构造函数中的第一个参数代表要渲染的视图名称,而第三个参数是在视图中要绑定的模型,那么第二个参数是个什么鬼呢?一般情况下这个值都会默认设置成command,据查资料这个字符串在spring框架是一个常量,那么它的作用是什么呢?我个人猜测如果默认设置成该值,那么就代表注解@ModelAttribute的参数值就是实体类名称,比如我们实体类为User,那么默认ModelAttribute参数名就是user,我们无需在上述表单上指定modelAttribute的值,即使指定为user也会抛出上述异常。如果在表单上显式定义了modelAttribute的值,那么在实例化模型视图类时,第二个参数必须与其值相等,我们将上述command修改为user即可解决问题,不信的话,你可以试试。同时在接收表单提交的参数时,经过测试,后台的注解@ModelAttribute可去除参数名称也可绑定。最终根据我们填写表单的内容和渲染结果,如下:

 

上述我们是通过ModelAndView返回模型和视图,这只是实现方式之一,其他实现将又会引来问题,接下来我们直接返回该模型,此时将以该模型名称作为作为表单上属性modelAttribute的名称,此时必须显式设置modelAttribute="user",如下:

    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public User user() {
        User user = new User();
        user.setGender("M");
        user.setFavorites(new String[]{"乒乓球", "羽毛球", "台球"});
        return user;
    }

如若在上述表单上没有显式设置modelAttribute="user"且值不能为其他值,否则将抛出如下异常:

 

若我们想将上述表单上的属性modelAttribute的值user,设置为其他值,比如modelAttribute="User",此时必须在该视图对应方法上通过注解@ModelAttribute显式设置名称为User,否则同样将抛出上述异常,如下:

    @ModelAttribute("User")
    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public User user() {
        User user = new User();
        user.setGender("M");
        user.setFavorites(new String[]{"乒乓球", "羽毛球", "台球"});
        return user;
    }

到此为止我们学习到了ModelAndView用来设置模型和视图名称,而注解@ModelAttribute则是控制器和视图绑定数据的桥梁,该注解既可作为方法参数接收视图模型数据,也可修饰控制器方法将模型数据绑定到视图。ModelMap则是映射模型数据,当然也支持集合和合并特性等等。我们再来演示通过对方法进行注解@ModelAttribute,然后绑定到视图中,在User类中我们再定义一个属性country,如下:

    private String country;
 
    public String getCountry() {
        return country;
    }

    public void setCountry(String country) {
        this.country = country;
    }

在控制器中通过注解@ModelAttribute定义国家元数据,并绑定到视图上,如下:

    @ModelAttribute("countryList")
    public Map<String, String> getCountryList() {
        Map<String, String> countryList = new HashMap<>();
        countryList.put("CHI", "中国");
        countryList.put("CH", "英国");
        countryList.put("SG", "新加坡");
        return countryList;
    }
<div class="form-group">
   <label for="country" class="col-md-3 control-label">Country</label>
        <div class="col-md-9">
            <form:select path = "country">
                 <form:option value = "无" label = "请选择"/>
                 <form:options items = "${countryList}" />
            </form:select>
         </div>
 </div>

在视图中我们通过$符号渲染数据,当然我么也可以在视图中写Java代码,这和.NET或.NET Core中的Razor视图一样,只不过在JSP中通过<%  代码 %>来写代码,我们同样也来演示下,在User中再定义一个数组,如下:

    private String[] favorites;

    public  String[] getFavorites(){
        return favorites;
    }

    public void setFavorites(String[] favorites) {
        this.favorites = favorites;
    }

在获取user.jsp视图对应后台方法中,我们设置上述定义的爱好列表默认值,如下:

user.setFavorites(new String[]{"乒乓球", "羽毛球", "台球"});

同时在控制器中我们定义爱好列表,然后绑定到视图中,对默认设置的爱好列表通过checkbox进行选中

    @ModelAttribute("favorites")
    public Object[] getfavoriteList() {
        List<String> favorites = new ArrayList<>();
        favorites.add("足球");
        favorites.add("乒乓球");
        favorites.add("羽毛球");
        favorites.add("台球");
        return favorites.toArray();
    }

再在user.jsp视图中,添加对爱好列表数据的绑定和选中,如下:

<div class="form-group">
    <label for="favorites" class="col-md-3 control-label">Favorites</label>
       <div class="col-md-9">
          <form:checkboxes class="f" items = "${favorites}" path = "favorites" />
       </div>
 </div>

然后在获取提交表单的方法中,获取上述我们添加的城市和选中的爱好列表,如下:

最后在渲染提交表单的视图users.jsp中,当获取爱好列表时,此时通过代码的形式进行渲染,如下:

 <tr>
        <td>Country</td>
        <td>${country}</td>
    </tr>
    <tr>
        <td>
            <% String[] favorites = (String[])request.getAttribute("favorites");
                for(String favorite: favorites) {
                    out.println(favorite);
                }
            %>
        </td>
    </tr>

 

总结 

本节我们详细分析了在Spring MVC中对于参数的绑定,最需要注意的是在模型绑定到视图中的问题,这里我们下个结论: 若通过ModelAndView设置模型和视图时,若此时第二个参数为command,则表单上的属性modelAttribute默认值为模型名称,此时若显式设置值为模型名称将抛出异常,若显式设置该属性的值不为模型名称,此时需要将command设置与其一样,否则将抛出异常。若直接返回模型时,此时表单上的属性modelAttribute的值必须显式设置为模型名称,否则将抛出异常,若表单上的属性modelAttribute值不为模型名称时,此时必须在该视图对应方法上显式设置注解@ModelAttribute其名称与其一致,否则将抛出异常。其他的地方我们只需要了解对应使用规则没有什么难点,好了,本节的内容我们到此为止,下一节我们陆续开始于数据库打交道,感谢您的阅读,我们下节见。

posted @ 2020-01-09 23:14  Jeffcky  阅读(1634)  评论(2编辑  收藏  举报