详细分析Springmvc中的@ModelAttribute基本知识（附Demo）

码农研究僧2024-06-30 15:45

目录

  • 前言
  • [1. 注解用法](#1. 注解用法)
    • [1.1 方法参数](#1.1 方法参数)
    • [1.2 方法](#1.2 方法)
    • [1.3 类](#1.3 类)
  • [2. 注解场景](#2. 注解场景)
    • [2.1 表单参数](#2.1 表单参数)
    • [2.2 AJAX请求](#2.2 AJAX请求)
    • [2.3 文件上传](#2.3 文件上传)
  • [3. 实战](#3. 实战)
  • [4. 总结](#4. 总结)

前言

将请求参数绑定到模型对象上，或者在请求处理之前添加模型属性

可以在方法参数、方法或者类上使用

一般适用这几种场景：

  • 表单处理 ：通过 @ModelAttribute 将表单数据绑定到模型对象上
  • 预处理逻辑：在请求处理之前执行一些初始化操作，如设置常见模型属性
  • RESTful API ：结合 @RequestBody 处理 JSON 数据

对于Java的相关知识推荐阅读：java框架 零基础从入门到精通的学习路线 附开源项目面经等（超全）

1. 注解用法

1.1 方法参数

将表单参数（name 和 email）绑定到 User 对象上，并将这个对象作为模型属性传递给视图

后端结合User，对应这个User属性要写全，才能获取到对应属性

java 复制代码 
@Controller
public class UserController {

    @RequestMapping(value = "/user", method = RequestMethod.POST)
    public String addUser(@ModelAttribute User user, Model model) {
        // 处理业务逻辑
        model.addAttribute("user", user);
        return "userDetails";
    }
}

前端对应捕捉相关的表单值

html 复制代码 
<form action="/user" method="post">
    <input type="text" name="name" />
    <input type="text" name="email" />
    <button type="submit">Submit</button>
</form>

1.2 方法

控制器方法上使用 @ModelAttribute 注解，可以在每个请求处理方法调用之前执行一些预处理操作，如初始化模型数据

对应的后端示例如下：

java 复制代码 
@Controller
public class UserController {

    @ModelAttribute
    public void addAttributes(Model model) {
        model.addAttribute("message", "Welcome to the user page!");
    }

    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public String getUserForm(Model model) {
        // 模型中已经包含了 "message" 属性
        return "userForm";
    }
}

前端视图如下：

html 复制代码 
<!-- userForm.jsp -->
<html>
<body>
    <h1>${message}</h1>
    <form action="/user" method="post">
        <input type="text" name="name" />
        <input type="text" name="email" />
        <button type="submit">Submit</button>
    </form>
</body>
</html>

对应每次请求都会在控制器方法调用之前添加一个名为 "message" 的模型属性

1.3 类

在类上使用 @ModelAttribute 注解，可以为所有该类的请求处理方法添加共同的模型属性

对应后端写法如下：

java 复制代码 
@Controller
@SessionAttributes("user")
public class UserController {

    @ModelAttribute("user")
    public User createUser() {
        return new User();
    }

    @RequestMapping(value = "/user", method = RequestMethod.GET)
    public String getUserForm(@ModelAttribute("user") User user) {
        return "userForm";
    }

    @RequestMapping(value = "/user", method = RequestMethod.POST)
    public String submitUser(@ModelAttribute("user") User user) {
        // 处理业务逻辑
        return "userDetails";
    }
}

2. 注解场景

与上面的第一章有些重复，不过容易理解

2.1 表单参数

表单参数 ：处理来自前端 HTML 表单的数据，将表单字段绑定到 Java 对象上

（其Demo对应此章的1.1 ）

也可通过编辑用户信息，绑定到相关的模型对象

java 复制代码 
@Controller
public class UserController {

    @RequestMapping(value = "/user/edit", method = RequestMethod.GET)
    public String editUser(@ModelAttribute User user, @RequestParam("userId") Long userId, Model model) {
        // 通过 userId 获取用户信息并填充到 user 对象
        user = userService.findById(userId);
        model.addAttribute("user", user);
        return "editUserForm";
    }
}

2.2 AJAX请求

配合前端进行交互，此处写一个示例的Demo

使用 JavaScript（例如 jQuery 或者原生的 XMLHttpRequest）发送异步请求，后端通过 @RequestBody 结合 @ModelAttribute 解析 JSON 数据

js 复制代码 
$.ajax({
    url: '/user',
    type: 'POST',
    contentType: 'application/json',
    data: JSON.stringify({ name: 'John', email: 'john@example.com' }),
    success: function(response) {
        console.log(response);
    }
});

对应后端如下：

java 复制代码 
@Controller
public class UserController {

    @RequestMapping(value = "/user", method = RequestMethod.POST)
    @ResponseBody
    public User addUser(@RequestBody @ModelAttribute User user) {
        // 处理业务逻辑
        return user;
    }
}

2.3 文件上传

前端使用 <form> 标签并设置 enctype="multipart/form-data"，后端通过 @ModelAttribute 绑定文件数据

前端：

js 复制代码 
<form action="/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="file" />
    <button type="submit">Upload</button>
</form>

后端：

java 复制代码 
@Controller
public class FileUploadController {

    @RequestMapping(value = "/upload", method = RequestMethod.POST)
    public String handleFileUpload(@RequestParam("file") MultipartFile file) {
        // 处理文件上传逻辑
        return "fileUploadSuccess";
    }
}

3. 实战

通过实战前端交互加深印象

此处使用Vue3 + Java

对应的函数调用如下：

options中添加了file的对应属性，但是后续需要将id传输给后端

对应的JS如下：

js 复制代码 
// 上传文件
export const updateFile = (data: any) => {
  const formData = new FormData();
  formData.append('file', data.file);
  formData.append('appointmentId', data.id.toString());

  return request.upload({
    url: '/dangerous/appointment-commission/appointment-file/upload',
    data: formData
  });
}

其后端的写法如下：

java 复制代码 
@PostMapping("/appointment-file/upload")
@Operation(summary = "上传文件", description = "模式一：后端上传文件")
public CommonResult<String> uploadFile(@ModelAttribute FileUploadReqVO uploadReqVO,@RequestParam("appointmentId") Long appointmentId) throws Exception {
    MultipartFile file = uploadReqVO.getFile();
    String path = uploadReqVO.getPath();
    return success(appointmentCommissionService.createFile(file.getOriginalFilename(), path, IoUtil.readBytes(file.getInputStream()),appointmentId));
}

4. 总结

  • @RequestBody：数据来自请求体，通常是 JSON 格式
java 复制代码 
@Controller
public class UserController {

    @RequestMapping(value = "/api/user", method = RequestMethod.POST)
    @ResponseBody
    public User addUser(@RequestBody User user) {
        // 处理 JSON 请求体
        return user;
    }
}
  • @ModelAttribute：数据来自 URL 查询参数、表单参数，或其他请求参数
java 复制代码 
@Controller
public class UserController {

    @RequestMapping(value = "/form/user", method = RequestMethod.POST)
    public String addUser(@ModelAttribute User user) {
        // 处理表单参数
        return "userDetails";
    }
}

其他注解详情如下：

注解 说明
@ModelAttribute 适用于将多个请求参数绑定到复杂对象，或在处理请求之前初始化模型数据
@RequestParam 适用于获取单个或少量请求参数
@RequestBody 适用于处理 JSON 格式的请求体数据
@PathVariable 适用于从 RESTful 风格的 URL 中提取路径变量
@RequestHeader 适用于访问 HTTP 请求头信息
@CookieValue 适用于从请求中获取特定的 Cookie 值
相关推荐
前端组件开发8 分钟前
JeeSite V5.7.1 发布，Java快速开发平台，Spring Boot，Vue3，微服务
java·数据库·spring boot·微服务·oracle·开源
虫小宝15 分钟前
Java后端架构设计：从单体到微服务的演进
java·开发语言·微服务
华为云开发者联盟17 分钟前
以Java项目为例，实现Jenkins对接CCE Autopilot集群
java·容器·kubernetes
xintaiideas23 分钟前
熟练掌握 Java 设计模式，如工厂、代理、策略、责任链等设计模式，并善⽤设计原则构建可复⽤代码
java·开发语言·设计模式
且随疾风前行.25 分钟前
技术成神之路：设计模式（二）建造者模式
java·设计模式·建造者模式
懒人w1 小时前
百万数据量修改数据思路及方法
java·linux·windows
skywalk81631 小时前
Clojure学习：运行在 Java 虚拟机（JVM）上的动态Lisp编程语言
java·lisp·clojure
一碗谦谦粉1 小时前
Spring之spring的单例bean是线程安全的吗
java·spring
liuliuliuliuyujie1 小时前
学生管理系统
java
ItKevin爱java1 小时前
java八股文面试题
java·开发语言
热门推荐
01Coze扣子平台完整体验和实践（附国内和国际版对比）02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）03【经验分享】Ubuntu22.04安装微信(linux官方版)042025张宇考研数学，百度网盘视频课+36讲PDF讲义+真题05【立创EDA-PCB设计基础】6.布线铺铜实战及细节详解06yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）0751-2 万字长文，深度解读端到端自动驾驶的挑战和前沿08通达信神奇九转指标原理及选股公式，无未来函数，数字不消失09浏览器插件——ModHeader 的分享和学习10＜工控＞＜PLC＞汇川Easy521系列PLC与汇川SV630N伺服进行EtherCat通讯的相关配置及指令编写