讲师中心 微信公众号
AI工具推荐 视频效率加速

Spring MVC 变量绑定:解析前端表单数组如何自动转化为后端 List 集合

落婷君_8045

落婷君_8045

发布时间:2026-05-15 15:14:26

|

960人浏览过

|

来源于php中文网

原创

Spring MVC可自动将前端表单数组绑定为List,关键在于命名规范(如items[0].id)与后端接收方式(推荐@ModelAttribute包装类),需Item有无参构造、字段名严格匹配、合理初始化List。

spring mvc 变量绑定:解析前端表单数组如何自动转化为后端 list 集合

Spring MVC 能自动将前端提交的表单数组(如 name="items[0].id"、name="items[1].name")绑定为后端的 List<item></item>,关键在于命名规范 + 合理的接收方式。

前端表单命名必须符合索引格式

Spring MVC 依赖参数名中的方括号索引识别集合结构。支持以下两种常见写法:

  • 显式索引:如 <input name="items[0].id" value="1">、<input name="items[0].name" value="苹果">、<input name="items[1].id" value="2"> —— 索引连续或不连续均可,Spring 会按序创建 List 元素
  • 无索引但同名前缀(需配合初始化):如 <input name="items.id" value="1">、<input name="items.name" value="苹果"> 多组重复 —— 此时需在 Controller 中提前初始化空 List,否则可能绑定失败或忽略后续项

后端接收需用 @ModelAttribute 或直接方法参数

推荐使用 @ModelAttribute 注解的包装对象,更清晰且支持校验:

public class OrderForm {
    private List<Item> items = new ArrayList<>(); // 建议初始化
    // getter/setter
}

Controller 方法中直接接收:

立即学习“前端免费学习笔记(深入)”;

创意前端视觉设计
创意前端视觉设计

在创建或重塑需要独特视觉方向、应避免通用 AI 生成审美的网站、落地页、仪表盘、UI 组件、海报或应用时使用。

下载
@PostMapping("/order")
public String submit(@ModelAttribute OrderForm form) {
    List<Item> items = form.getItems(); // 自动填充完成
    return "success";
}

也可直接接收 List(较少用,缺乏上下文封装):

@PostMapping("/items")
public String saveItems(@ModelAttribute("items") List<Item> items) { ... }

注意边界情况与常见问题

绑定失败往往不是框架问题,而是细节疏漏:

  • Item 类必须有无参构造函数,否则实例化失败,抛 InstantiationException
  • 字段名需严格匹配:前端 items[0].itemName 对应 Java 的 item.setNameName(...)(即 setter 名为 setItemName),大小写敏感
  • 空值/缺失索引处理:若提交 items[0] 和 items[2],Spring 会创建长度为 3 的 List,索引 1 处为 null(除非配置 webDataBinder.setIgnoreInvalidFields(true))
  • 类型转换异常:如字符串转数字失败,默认返回 0 或抛异常,可加 @InitBinder 自定义 Converter 或使用 @NumberFormat 注解

进阶:支持动态增删的表单建议

前端 JS 动态添加行时,确保新字段名索引递增且不跳号(如新增第 3 行用 items[2].xxx),或改用「无索引 + 初始化」方式更鲁棒:

在 Controller 中手动初始化:

@GetMapping("/edit")
public String edit(Model model) {
    OrderForm form = new OrderForm();
    form.setItems(Arrays.asList(new Item(), new Item())); // 预置两条
    model.addAttribute("form", form);
    return "order-edit";
}

这样即使前端只填了部分字段,List 长度固定,避免因索引缺失导致绑定截断。

热门AI工具

更多
VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2723

2023.08.11

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6870

2024.03.19

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

6346

2024.03.19

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2723

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5923

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6870

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6638

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

943

2024.05.22

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

40

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn