当前位置：首页 > news >正文

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

news 2025/12/21 20:04:59

前言

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

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

一般适用这几种场景：

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

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

1. 注解用法

1.1 方法参数

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

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

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

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

<form action="/user" method="post"><input type="text" name="name" /><input type="text" name="email" /><button type="submit">Submit</button>
</form>

1.2 方法

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

对应的后端示例如下：

@Controller
public class UserController {@ModelAttributepublic 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";}
}

前端视图如下：

<!-- 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 注解，可以为所有该类的请求处理方法添加共同的模型属性

对应后端写法如下：

@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）
在这里插入图片描述

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

@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 数据

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

对应后端如下：

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

2.3 文件上传

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

前端：

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

后端：

@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如下：

// 上传文件
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});
}

其后端的写法如下：

@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 格式

@Controller
public class UserController {@RequestMapping(value = "/api/user", method = RequestMethod.POST)@ResponseBodypublic User addUser(@RequestBody User user) {// 处理 JSON 请求体return user;}
}

@ModelAttribute：数据来自 URL 查询参数、表单参数，或其他请求参数

@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 值

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

目录前言1. 注解用法1.1 方法参数1.2 方法1.3 类 2. 注解场景2.1 表单参数2.2 AJAX请求2.3 文件上传 3. 实战4. 总结前言将请求参数绑定到模型对象上，或者在请求处理之前添加模型属性可以在方法参数、方法或者类上使用一般适用这几种场景： 表单…...

编程日记 2024/6/27 7:44:12

和利时SIS安全系统模块SGM210 SGM210-A02

和利时SIS安全系统模块SGM210 SGM210-A02 阀门定位器：（福克斯波罗, YTC，山武） PLC：（西门子，施耐德，ABB,AB,三菱，欧姆龙） 泵阀：（力士…...

编程日记 2024/6/27 7:43:11

浔川3样AI产品即将上线！——浔川总社部

浔川3样AI产品即将上线！ 浔川AI翻译v3.0 即将上线！ 浔川画板v5.1 即将上线！ 浔川AI五子棋v1.4 即将上线！ 整体通告详见：浔川AI五子棋（改进（完整）版1.3）——浔川python社…...

编程日记 2024/6/27 7:41:09

小阿轩yx-MySQL索引、事务

小阿轩yx-MySQL索引、事务 MySQL 索引介绍是一个排序的列表，存储着索引的值和包含这个值的数据所在行的物理地址数据很多时，索引可以大大加快查询的速度使用索引后可以不用扫描全表来定位某行的数据而是先通过索引表找到该行数据对应的物理地址然后访…...

编程日记 2024/6/27 7:40:08

搞定求职难题：工作岗位列表+简历制作工具 | 开源专题 No.75

SimplifyJobs/New-Grad-Positions Stars: 8.5k License: NOASSERTION 这个项目是一个用于分享和跟踪美国、加拿大或远程职位的软件工作机会列表。该项目的核心优势和关键特点如下： 自动更新新岗位信息便捷地提交问题进行贡献提供一键申请选项 BartoszJarocki/cv…...

编程日记 2024/6/27 7:38:06

JavaWeb——MySQL数据库：约束

目录 1. 约束 1.1 概念： 1.2 分类： 1.3 使用： 1.4 外键约束; 1.5 总结数据库：数据库都有约束，数据库设计，多表查询，事物这四方面的知识； 我们先按这个顺序进行学习&#xff…...

编程日记 2024/6/27 7:37:04

JS（JavaScript）入门指南（DOM、事件处理、BOM、数据校验）

天行健，君子以自强不息；地势坤，君子以厚德载物。每个人都有惰性，但不断学习是好好生活的根本，共勉！文章均为学习整理笔记，分享记录为主，如有错误请指正，共同学习进步。玉阶生白露，夜久侵罗袜。却下水晶帘，玲珑望秋月。 ——《玉阶怨》文章目录一、DOM操作1. D…...

编程日记 2024/6/27 7:36:03

江协科技51单片机学习- p16 矩阵键盘

🚀write in front🚀 🔎大家好，我是黄桃罐头，希望你看完之后，能对你有所帮助，不足请指正！共同学习交流 🎁欢迎各位→点赞👍 收藏⭐️ 留言📝…...

编程日记 2024/6/27 7:34:01

grpc学习golang版（四、多服务示例）

系列文章目录第一章 grpc基本概念与安装第二章 grpc入门示例第三章 proto文件数据类型第四章多服务示例文章目录一、前言二、定义proto文件三、编写server服务端四、编写Client客户端五、测试六、示例代码一、前言多服务，即一个rpc提供多个服务给外界调用…...

编程日记 2024/6/27 7:33:00

我们进入到cd /usr/lib/下然后创建一个jdk17的文件夹 mkdir jdk17 进入到jdk17目录下下载jdk17包上传到Linux 解压jar包 tar -zxvf jdk-17_linux-x64_bin.tar.gz压解完毕后配置环境变量 vim/etc/profilei 修改 esc 退出 :wq保存 export JAVA_HOME/usr/lib/jdk17/jdk-1…...

编程日记 2024/6/27 7:31:58

Java家教系统小程序APP公众号h5源码

让学习更高效，更便捷 🌟 引言：家教新选择，小程序来助力在快节奏的现代生活中，家长们越来越注重孩子的教育问题。然而，如何为孩子找到一位合适的家教老师，成为了许多家长头疼的问题。现在&…...

编程日记 2024/6/27 7:30:57

PHP入门

一、环境搭建无脑： 小皮面板(phpstudy) - 让天下没有难配的服务器环境！phpStudy官网2019正式推出phpStudy V8.0版本PHP集成环境，支持Windows与Linux系统，支持WEB面板操作管理，一键网站开发环境搭建配置，…...

编程日记 2024/6/27 7:29:55

docker ce的使用介绍

docker docker17.03以后 docker ce，社区免费版，vscode的docker插件使用的该版本（默认windows只支持windows容器，linux支持linux容器）docker ee，企业版本 docker17.03以前 docker toolbox，基于…...

编程日记 2024/6/27 7:24:50

SpringCloud Alibaba Sentinel 流量控制之流控模式实践总结

官网文档：https://sentinelguard.io/zh-cn/docs/flow-control.html wiki地址：https://github.com/alibaba/Sentinel/wiki/%E6%B5%81%E9%87%8F%E6%8E%A7%E5%88%B6 本文版本：spring-cloud-starter-alibaba：2.2.0.RELEASE 如下图所…...

编程日记 2024/6/27 7:23:49

【高考志愿】电子科学与技术

高考志愿选择电子科学与技术专业，无疑是向着科技创新的前沿迈出坚定步伐的明智之选。这一专业以其深厚的理论基础、前沿的技术应用和广泛的就业前景，吸引了众多有志于投身科技领域的学子。首先，电子科学与技术专业所涵盖的内容丰富而深入。它…...

编程日记 2024/6/27 7:22:48

2024.06.26【读书笔记】|医疗科技创新流程（前言）【AI增强版】

目录《BIODESIGN》第二版前言详细总结前言概述新增重要内容价值导向 (Value Orientation)全球视角 (Global Perspectives)更好的教学和学习方法 (Better Ways to Teach and Learn)全新视频集合 (New Videos)扩展的“实地”案例研究 (Expanded “From the Field” Case Studies…...

编程日记 2024/6/27 7:20:46

kubernetes Job yaml文件解析

一、yaml文件示例 apiVersion: batch/v1 kind: Job metadata:name: test-jobnamespace: mtactor spec:completions: 3parallelism: 1backoffLimit: 5activeDeadlineSeconds: 100template:spec:containers:- name: test-jobimage: centoscommand: ["echo","test…...

编程日记 2024/6/27 7:19:45

php goto解密脚本源码

php goto解密脚本源码源码下载：https://download.csdn.net/download/m0_66047725/89426171 更多资源下载：关注我。...

编程日记 2024/6/27 7:17:43

2023: 芒种集•序言

2023: 芒种集•序言 2023: 芒种集•序言从西南旅游回来，一直忙着整理游记“2024：追寻红色足迹”，之后又应初建平索要刘桂蓉遗作“我们一起走过”，于是把“别了，老屋”和诗作“二月”一并合编，把我写的悼念…...

编程日记 2024/6/27 7:15:41

Camera定制修改

需求： Android13 MtkCamera右上角的前后摄切换点击范围小导致经常点击无反应，需增大view宽度跟踪代码可找到对应资源文件：vendor\mediatek\proprietary\packages\apps\Camera2\feature\setting\cameraswitcher\res\ 根据vendor\mediatek\…...

编程日记 2024/6/27 7:13:38

【Linux】shell脚本忽略错误继续执行

在 shell 脚本中，可以使用 set -e 命令来设置脚本在遇到错误时退出执行。如果你希望脚本忽略错误并继续执行，可以在脚本开头添加 set e 命令来取消该设置。举例1 #!/bin/bash# 取消 set -e 的设置 set e# 执行命令，并忽略错误 rm somefile…...

编程新知 2025/9/11 15:27:32

【JavaEE】-- HTTP

1. HTTP是什么？ HTTP（全称为"超文本传输协议"）是一种应用非常广泛的应用层协议，HTTP是基于TCP协议的一种应用层协议。应用层协议：是计算机网络协议栈中最高层的协议，它定义了运行在不同主机上…...

编程新知 2025/12/21 4:25:33

以下是对华为 HarmonyOS NETX 5属性动画（ArkTS）文档的结构化整理，通过层级标题、表格和代码块提升可读性：

一、属性动画概述NETX 作用：实现组件通用属性的渐变过渡效果，提升用户体验。支持属性：width、height、backgroundColor、opacity、scale、rotate、translate等。注意事项： 布局类属性（如宽高）变化时&#…...

编程新知 2025/12/18 10:57:53

家政维修平台实战20：权限设计

目录 1 获取工人信息2 搭建工人入口3 权限判断总结目前我们已经搭建好了基础的用户体系，主要是分成几个表，用户表我们是记录用户的基础信息，包括手机、昵称、头像。而工人和员工各有各的表。那么就有一个问题，不同的角色&#xf…...

编程新知 2025/12/14 1:11:38

c#开发AI模型对话

AI模型前面已经介绍了一般AI模型本地部署，直接调用现成的模型数据。这里主要讲述讲接口集成到我们自己的程序中使用方式。微软提供了ML.NET来开发和使用AI模型，但是目前国内可能使用不多，至少实践例子很少看见。开发训练模型就不介绍了&am…...

编程新知 2025/12/17 4:32:25

IT供电系统绝缘监测及故障定位解决方案

随着新能源的快速发展，光伏电站、储能系统及充电设备已广泛应用于现代能源网络。在光伏领域，IT供电系统凭借其持续供电性好、安全性高等优势成为光伏首选，但在长期运行中，例如老化、潮湿、隐裂、机械损伤等问题会影响光伏板绝缘层…...

编程新知 2025/12/15 2:28:05

Selenium常用函数介绍

目录一，元素定位 1.1 cssSeector 1.2 xpath 二，操作测试对象三，窗口 3.1 案例 3.2 窗口切换 3.3 窗口大小 3.4 屏幕截图 3.5 关闭窗口四，弹窗五，等待六，导航七，文件上传 …...

编程新知 2025/12/21 0:12:12

搭建DNS域名解析服务器(正向解析资源文件)

正向解析资源文件 1）准备工作服务端及客户端都关闭安全软件 [rootlocalhost ~]# systemctl stop firewalld [rootlocalhost ~]# setenforce 0 2）服务端安装软件：bind 1.配置yum源 [rootlocalhost ~]# cat /etc/yum.repos.d/base.repo [Base…...

编程新知 2025/12/21 14:17:46