SpringMVC 实现 RESTful POST 添加功能：从表单到控制器

目标与准备

我们的目标是实现一个用户界面，允许用户输入员工信息（姓名、邮箱、性别）并保存到系统数据库中。后端需遵循 RESTful 规范，使用 POST /employee 路径处理数据创建请求。准备工作包括现有的 EmployeeController 和用于存储数据的 DAO 层接口。

第1步：配置视图跳转路径

当用户点击列表页的“添加”按钮时，需要跳转到一个空白的新增页面。由于该操作仅涉及视图跳转而无业务逻辑，可以在 Spring MVC 配置文件中直接定义映射：

<mvc:view-controller path="/toAdd" view-name="employee_add"/>

上述配置表明，访问 /toAdd 路径时，将直接渲染名为 employee_add 的视图（即 HTML 模板）。这样避免了为简单跳转编写额外的 Controller 方法。

第2步：设计前端表单页面

新建 employee_add.html 文件，使用 Thymeleaf 语法构建表单。关键点在于设置表单的 action 属性和 method 属性：

• Action: 设置为 @{/employee}，对应后端处理添加的逻辑地址。
• Method: 必须显式指定为 post。不同于删除操作可能需要隐藏字段伪装 DELETE 请求，标准的 RESTful 添加直接使用 HTTP POST 协议即可。

表单代码示例：

<form th:action="@{/employee}" method="post">
    lastName:<input type="text" name="lastName"><br>
    email:<input type="text" name="email"><br>
    gender:
    <input type="radio" name="gender" value="1"> Male
    <input type="radio" name="gender" value="0"> Female<br>
    <input type="submit" value="添加"><br>
</form>

注意 input 标签的 name 属性需与后端 Employee 实体类的字段名一致，以便 Spring MVC 自动封装参数。

第3步：实现后端控制逻辑

在 EmployeeController 中创建一个专门处理 POST 请求的方法。该方法接收自动封装好的 Employee 对象，调用 DAO 层保存数据，并返回重定向指令：

@RequestMapping(value = "/employee", method = RequestMethod.POST)
public String addEmployee(Employee employee) {
    // 调用持久层保存数据
    employeeDao.save(employee);
    // 重定向到列表页，防止表单重复提交
    return "redirect:/employee";
}

关键说明：

• 使用实体类作为方法参数时，Spring MVC 会根据请求中的表单字段自动进行绑定。
• 返回 redirect:/employee 是为了遵循 PRG（Post/Redirect/Get）模式。如果直接返回视图名称，用户在刷新页面时可能会再次触发 POST 请求，导致数据重复添加。

验证与结果

完成上述配置后，重新启动应用并访问员工列表页。点击【添加】按钮进入新增界面，填入测试数据并提交。

成功后页面将自动跳回列表页，此时可以看到新添加的员工数据已正确显示。这证明 POST 请求已被正确接收、解析并持久化，整个 RESTful 添加流程运行正常。

总结

实现 SpringMVC RESTful 风格的添加功能，核心在于正确配置视图跳转、构建符合 REST 规范的 POST 表单，并在控制器中利用实体类自动绑定特性简化开发。务必记得使用重定向来避免重复提交问题。以上就是 SpringMVC 实战案例 RESTful 实现添加功能的详细内容，更多关于 SpringMVC RESTful 添加的资料请关注本站其它相关文章！