Spring MVC中的表单入门教程

最新推荐文章于 2021-07-05 18:31:53 发布

余一

最新推荐文章于 2021-07-05 18:31:53 发布

阅读量273

点赞数 1

分类专栏： Spring 文章标签： Spring form

原文链接：https://www.baeldung.com/spring-mvc-form-tutorial

版权

Spring 专栏收录该内容

10 篇文章 0 订阅

订阅专栏

原文链接: https://www.baeldung.com/spring-mvc-form-tutorial
上次修改时间：2019年7月20日
作者 Eugen Paraschiv
在这里插入图片描述

1.概述

在本文中，我们将讨论Spring表单和与控制器的数据绑定。另外，我们将看看Spring MVC中的主要注释之一，即@ModelAttribute。

当然，Spring MVC是一个复杂的主题，您需要了解很多东西才能充分利用它，因此请务必在此处更深入地研究框架。

2.模型

首先, 让我们定义一个简单的实体，该实体将显示并绑定到表单：

public class Employee {
    private String name;
    private long id;
    private String contactNumber;
 
    // standard getters and setters
}

这将是我们的表单支持对象。

3.视图

下一步–让我们定义实际的表单，当然也要定义包含它的HTML文件。我们将使用一个页面来创建/注册新员工：

<%@ taglib prefix="form" uri="http://www.springframework.org/tags/form"%>
<html>
    <head>
    </head>
    <body>
        <h3>Welcome, Enter The Employee Details</h3>
        <form:form method="POST"
          action="/spring-mvc-xml/addEmployee" modelAttribute="employee">
             <table>
                <tr>
                    <td><form:label path="name">Name</form:label></td>
                    <td><form:input path="name"/></td>
                </tr>
                <tr>
                    <td><form:label path="id">Id</form:label></td>
                    <td><form:input path="id"/></td>
                </tr>
                <tr>
                    <td><form:label path="contactNumber">
                      Contact Number</form:label></td>
                    <td><form:input path="contactNumber"/></td>
                </tr>
                <tr>
                    <td><input type="submit" value="Submit"/></td>
                </tr>
            </table>
        </form:form>
    </body>
</html>

首先，请注意，我们在JSP页面中包含了一个标记库，即taglib 表单，以帮助定义表单。
下一步, <form：form>标记在这里起重要作用；它与常规HTLM 标记非常相似，但是modelAttribute属性是键，用于指定支持此表单的模型对象的名称：

<form:form method="POST"
  action="/SpringMVCFormExample/addEmployee" modelAttribute="employee">

稍后将在控制器中与@ModelAttribute对应。
接下来, 每个输入字段都使用Spring Form 标签库中的另一个有用的标签– form：prefix。这些字段中的每个字段都指定一个路径属性 –该属性必须对应于模型属性的获取器/设置器（在本例中为Employee类）。加载页面时，Spring将填充输入字段，Spring将调用绑定到输入字段的每个字段的getter。提交表单后，将调用setter以将表单的值保存到对象。

最终, 提交表单后，将调用控制器中的POST处理程序，并将表单自动绑定到我们传入的employee参数。

4.控制器

现在，让我们看一下将要处理后端的Controller：

@Controller
public class EmployeeController {
 
    @RequestMapping(value = "/employee", method = RequestMethod.GET)
    public ModelAndView showForm() {
        return new ModelAndView("employeeHome", "employee", new Employee());
    }
 
    @RequestMapping(value = "/addEmployee", method = RequestMethod.POST)
    public String submit(@Valid @ModelAttribute("employee")Employee employee, 
      BindingResult result, ModelMap model) {
        if (result.hasErrors()) {
            return "error";
        }
        model.addAttribute("name", employee.getName());
        model.addAttribute("contactNumber", employee.getContactNumber());
        model.addAttribute("id", employee.getId());
        return "employeeView";
    }
}

控制器定义了两个简单的操作: 通过表单的提交，用于在表单中显示数据的GET和用于创建操作的POST。
还要注意，如果未将名为“ employee”的对象添加到模型中，则当我们尝试访问JSP时，Spring会报错，因为JSP将会设置把表单绑定到“ employee”模型属性：

java.lang.IllegalStateException: 
  Neither BindingResult nor plain target object 
    for bean name 'employee' available as request attribute
  at o.s.w.s.s.BindStatus.<init>(BindStatus.java:141)

要访问表单支持对象，我们需要通过@ModelAttribute注入它。
一个@ModelAttribute 上的方法参数指示参数将从模型中检索。如果模型中不存在该参数，则将首先实例化该参数，然后将其添加到模型中。

5.处理绑定错误

默认情况下，当请求绑定期间发生错误时，Spring MVC会引发异常。通常这不是我们想要的，相反，我们应该向用户显示这些错误。我们将通过在控制器方法中添加一个作为参数来使用BindingResult：

public String submit(
  @Valid @ModelAttribute("employee") Employee employee,
  BindingResult result,
  ModelMap model)

BindingResult参数需要放在表单支持对象之后, 其中方法参数的顺序很重要这是个罕见的情况。否则，我们将遇到以下异常：

java.lang.IllegalStateException: 
  Errors/BindingResult argument declared without preceding model attribute. 
    Check your handler method signature!

现在, 不再抛出异常；相反，错误将在注册BindingResult传递到submit方法。此时，我们可以通过多种方式处理这些错误, 例如，可以取消该操作

@RequestMapping(value = "/addEmployee", method = RequestMethod.POST)
public String submit(@Valid @ModelAttribute("employee")Employee employee, 
  BindingResult result,  ModelMap model) {
    if (result.hasErrors()) {
        return "error";
    }
     
    //Do Something
    return "employeeView";
}

请注意，如果结果包含错误，我们如何将另一个视图返回给用户，以便正确显示这些错误。让我们看一下该视图– error.jsp：

<html>
    <head>
    </head>
 
    <body>
        <h3>Please enter the correct details</h3>
        <table>
            <tr>
                <td><a href="employee">Retry</a></td>
            </tr>
        </table>
    </body>
 
</html>

6.展示员工

最后，除了创建新员工之外，我们还可以简单地显示一个员工, 快速查看该代码：

<body>
    <h2>Submitted Employee Information</h2>
    <table>
        <tr>
            <td>Name :</td>
            <td>${name}</td>
        </tr>
        <tr>
            <td>ID :</td>
            <td>${id}</td>
        </tr>
        <tr>
            <td>Contact Number :</td>
            <td>${contactNumber}</td>
        </tr>
    </table>
</body>

JSP页面只是使用EL表达式来显示模型中Employee对象的属性值。

7.测试应用程序

该简单应用程序可以部署在例如Tomcat服务器中，并可以在本地访问：
http://localhost:8080/spring-mvc-xml/employee
这是包含主要表单的视图
提交操作之前：

Spring MVC表单示例–提交

提交后，将显示数据：

Spring MVC表单示例–视图

以上就是一个使用Spring MVC和验证的简单表单的工作示例。

项目地址: https://github.com/eugenp/tutorials/tree/master/spring-mvc-forms-jsp

余一

关注

1
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
Spring MVC中的表单入门教程

原文链接: https://www.baeldung.com/spring-mvc-form-tutorial上次修改时间：2019年7月20日作者 Eugen Paraschiv1.概述在本文中，我们将讨论Spring表单和与控制器的数据绑定。另外，我们将看看Spring MVC中的主要注释之一，即@ModelAttribute。当然，Spring MVC是一个复杂的主题，您需要了解...
复制链接

扫一扫

专栏目录