从 01 开始 从 01 开始
首页
  • 📚 计算机基础

    • 计算机简史
    • 数字电路
    • 计算机组成原理
    • 操作系统
    • Linux
    • 计算机网络
    • 数据库
    • 编程工具
    • 装机
  • 🎨 前端

    • Node
  • JavaSE
  • Java 高级
  • JavaEE

    • 构建、依赖管理
    • Ant
    • Maven
    • 日志框架
    • Junit
    • JDBC
    • XML-JSON
  • JavaWeb

    • 服务器软件
    • 环境管理和配置管理-科普篇
    • Servlet
  • Spring

    • Spring基础
  • 主流框架

    • Redis
    • Mybatis
    • Lucene
    • Elasticsearch
    • RabbitMQ
    • MyCat
    • Lombok
  • SpringMVC

    • SpringMVC 基础
  • SpringBoot

    • SpringBoot 基础
  • Windows 使用技巧
  • 手机相关技巧
  • 最全面的输入法教程
  • 最全面的浏览器教程
  • Office
  • 图片类工具
  • 效率类工具
  • 最全面的 RSS 教程
  • 码字工具
  • 各大平台
  • 校招
  • 五险一金
  • 职场规划
  • 关于离职
  • 杂谈
  • 自媒体
  • 📖 读书

    • 读书工具
    • 走进科学
  • 🌍 英语

    • 从零开始学英语
    • 英语兔的相关视频
    • Larry 想做技术大佬的相关视频
  • 🏛️ 政治

    • 反腐
    • GFW
    • 404 内容
    • 审查与自我审查
    • 互联网
    • 战争
    • 读书笔记
  • 💰 经济

    • 关于税
    • 理财
  • 💪 健身

    • 睡眠
    • 皮肤
    • 口腔健康
    • 学会呼吸
    • 健身日志
  • 🏠 其他

    • 驾驶技能
    • 租房与买房
    • 厨艺
  • 电影

    • 电影推荐
  • 电视剧
  • 漫画

    • 漫画软件
    • 漫画推荐
  • 游戏

    • Steam
    • 三国杀
    • 求生之路
  • 小说
  • 关于本站
  • 关于博主
  • 打赏
  • 网站动态
  • 友人帐
  • 从零开始搭建博客
  • 搭建邮件服务器
  • 本站分享
  • 🌈 生活

    • 2022
    • 2023
    • 2024
    • 2025
  • 📇 文章索引

    • 文章分类
    • 文章归档

晓林

程序猿,自由职业者,博主,英语爱好者,健身达人
首页
  • 📚 计算机基础

    • 计算机简史
    • 数字电路
    • 计算机组成原理
    • 操作系统
    • Linux
    • 计算机网络
    • 数据库
    • 编程工具
    • 装机
  • 🎨 前端

    • Node
  • JavaSE
  • Java 高级
  • JavaEE

    • 构建、依赖管理
    • Ant
    • Maven
    • 日志框架
    • Junit
    • JDBC
    • XML-JSON
  • JavaWeb

    • 服务器软件
    • 环境管理和配置管理-科普篇
    • Servlet
  • Spring

    • Spring基础
  • 主流框架

    • Redis
    • Mybatis
    • Lucene
    • Elasticsearch
    • RabbitMQ
    • MyCat
    • Lombok
  • SpringMVC

    • SpringMVC 基础
  • SpringBoot

    • SpringBoot 基础
  • Windows 使用技巧
  • 手机相关技巧
  • 最全面的输入法教程
  • 最全面的浏览器教程
  • Office
  • 图片类工具
  • 效率类工具
  • 最全面的 RSS 教程
  • 码字工具
  • 各大平台
  • 校招
  • 五险一金
  • 职场规划
  • 关于离职
  • 杂谈
  • 自媒体
  • 📖 读书

    • 读书工具
    • 走进科学
  • 🌍 英语

    • 从零开始学英语
    • 英语兔的相关视频
    • Larry 想做技术大佬的相关视频
  • 🏛️ 政治

    • 反腐
    • GFW
    • 404 内容
    • 审查与自我审查
    • 互联网
    • 战争
    • 读书笔记
  • 💰 经济

    • 关于税
    • 理财
  • 💪 健身

    • 睡眠
    • 皮肤
    • 口腔健康
    • 学会呼吸
    • 健身日志
  • 🏠 其他

    • 驾驶技能
    • 租房与买房
    • 厨艺
  • 电影

    • 电影推荐
  • 电视剧
  • 漫画

    • 漫画软件
    • 漫画推荐
  • 游戏

    • Steam
    • 三国杀
    • 求生之路
  • 小说
  • 关于本站
  • 关于博主
  • 打赏
  • 网站动态
  • 友人帐
  • 从零开始搭建博客
  • 搭建邮件服务器
  • 本站分享
  • 🌈 生活

    • 2022
    • 2023
    • 2024
    • 2025
  • 📇 文章索引

    • 文章分类
    • 文章归档
  • JavaSE

  • JavaSenior

  • JavaEE

  • JavaWeb

  • Spring

  • 主流框架

  • SpringMVC

    • SpringMVC 基本概念
    • SpringMVC 入门案例
    • SpringMVC 中的组件介绍
    • RequestMapping 注解的作用
    • 请求参数的绑定
      • 绑定机制
      • 新建控制器
      • 绑定基本类型的参数
      • 绑定实体类型的参数
      • 绑定集合类型
      • 中文问题
      • 总结
    • 自定义类型转换器
    • 使用原生的 Servlet-API
    • SpringMVC 常用注解
    • 响应数据和结果视图
    • 文件上传
    • 文件上传之跨服务器
    • SpringMVC 的异常处理
    • SpringMVC 的拦截器
    • SSM 整合
  • SpringBoot

  • Java
  • SpringMVC
2023-05-15
目录

请求参数的绑定

# 40.请求参数的绑定

接下来我们讲讲如何绑定请求参数,这是非常重要的一个内容。

# 绑定机制

作为一个 web 框架,是一定能获取到前端传过来的参数,那么拿到的过程就叫参数绑定。机制如下:

  1. 表单提交的数据都是 k = v 格式的,例如: username = haha&password = 123
  2. SpringMVC 的参数绑定过程是把表单提交的请求参数,作为控制器中方法的参数进行绑定的
  3. 要求:提交表单的 name 和参数的名称是相同的

原理:通过反射方法的属性,然后赋值给方法的参数。这比起之前我们学习 Servlet 的时候,要在 Servlet 中手动获取参数并处理,方便太多。

支持的数据类型

  1. 基本数据类型和字符串类型
  2. 实体类型(JavaBean)
  3. 集合数据类型(List、Map 集合等) ‍

# 新建控制器

我们先新建一个控制器类

package com.peterjxl.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping(path = "/param")
public class ParamController {

    @RequestMapping(path = "/testParam")
    public String testParam() {
        System.out.println("testParam");
        return "success";
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

‍ 然后新建 JSP,用来测试该控制器类能正常访问:在 webapp 目录下新建 param.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
    <head>
        <title>演示参数绑定</title>
    </head>
    <body>
        <h1>演示参数绑定</h1>
        <a href="param/testParam">请求参数绑定</a>
    </body>
</html>
1
2
3
4
5
6
7
8
9
10

‍ 重启,访问 http://localhost: 8080/param/testParam (opens new window) 并点击超链接,可以看到能正常跳转,并且控制台有输出 testParam

‍

# 绑定基本类型的参数

我们在前端页面,传递一个参数:

<a href="param/testParam?username=peterjxl">请求参数绑定</a>
1

并且在控制器的方法上也加上,然后输出:

@RequestMapping(path = "/testParam")
public String testParam(String username) {
    System.out.println("testParam");
    System.out.println("username: " + username);
    return "success";
}
1
2
3
4
5
6

‍ 我们重启,并点击超链接,可以看到控制台有正常输出。

也可以传递多个参数,例如:

 <a href="param/testParam?username=peterjxl&password=123">请求参数绑定</a>
1

‍ 控制器也加上:

@RequestMapping(path = "/testParam")
public String testParam(String username, String password) {
    System.out.println("testParam");
    System.out.println("username: " + username);
    System.out.println("password: " + password);
    return "success";
}
1
2
3
4
5
6
7

# 绑定实体类型的参数

当我们的参数很多之后,逐个传参并处理有点麻烦,我们可以将参数封装到一个 JavaBean 对象中。 ‍

# 新建 JavaBean

package com.peterjxl.domain;
import java.io.Serializable;
public class Account implements Serializable {
  
    private String username;
    private String password;
    private Double money;
}
1
2
3
4
5
6
7
8

请自行生成 setter、getter 和 toString 方法 ‍

# 新建表单

然后我们在 param.jsp 中新建一个表单:注意参数名字要和 Account 中的一样

<form action="param/saveAccount" method="post">
    姓名:<input type="text" name="username" /> <br/>
    密码:<input type="text" name="password" /> <br/>
    金额:<input type="text" name="money" /> <br/>
    <input type="submit" value="提交" />
</form>
1
2
3
4
5
6

# 新增处理器方法

在 ParamController 中新建方法:

@RequestMapping(path = "/saveAccount")
public String saveAccount(Account account) {
    System.out.println("saveAccount");
    System.out.println(account);
    return "success";
}
1
2
3
4
5
6

‍

# 测试

然后我们重启,访问 http://localhost: 8080/param.jsp,填写和提交表单:

‍

后台输出结果:

Account{username='peterjxl', password='123', money=666.0}
1

‍ 注意:类型不能错。例如金额是数字类型,如果前端传了个英文字母,是会报错的

# 如果 JavaBean 中有引用类型

如果一个 JavaBean 类中包含其他的引用类型,那么表单的 name 属性需要编写成 对象.属性, 例如 address.name ‍ 我们新建一个实体类 User:

package com.peterjxl.domain;
import java.io.Serializable;
public class User implements Serializable {

    private String uname;
    private Integer age;
}
1
2
3
4
5
6
7

同理,生成 getter、setter 和 toString 方法。

修改 Account 类型,添加 User 类型的成员变量、setter 和 getter 方法,并在 toString 方法里也打印下 user 类型:

public class Account implements Serializable {
    private String username;
    private String password;
    private Double money;
    private User user;
}
1
2
3
4
5
6

我们新增一个表单:

<form action="param/saveAccount2" method="post">
    姓名:<input type="text" name="username" /> <br/>
    密码:<input type="text" name="password" /> <br/>
    金额:<input type="text" name="money" /> <br/>
    用户姓名:<input type="text" name="user.uname" /> <br/>
    用户年龄:<input type="text" name="user.age" /> <br/>
    <input type="submit" value="提交" />
</form>
1
2
3
4
5
6
7
8

新增控制器方法:

@RequestMapping(path = "/saveAccount2")
public String saveAccount2(Account account) {
    System.out.println("saveAccount");
    System.out.println(account);
    return "success";
}
1
2
3
4
5
6

‍ 运行结果:

‍

输出:

Account{username='peterjxl', password='123456', money=666.0, user=User{uname='ppp', age=66}}
1

# 绑定集合类型

我们在 Account 类型中添加如下成员变量,并生成对应的 setter、getter,在 toString 中打印这两个对象:

    private List<User> list;
    private Map<String, User> map;
1
2

我们新增一个表单:

<form action="param/saveAccount3" method="post">
    姓名:<input type="text" name="username" /> <br/>
    密码:<input type="text" name="password" /> <br/>
    金额:<input type="text" name="money" /> <br/>
    用户姓名:<input type="text" name="user.uname" /> <br/>
    用户年龄:<input type="text" name="user.age" /> <br/>

    list用户姓名:<input type="text" name="list[0].uname" /> <br/>
    list用户年龄:<input type="text" name="list[0].age" /> <br/>

    map用户姓名:<input type="text" name="map['one'].uname" /> <br/>
    map用户年龄:<input type="text" name="map['one'].age" /> <br/>
    <input type="submit" value="提交" />
</form>
1
2
3
4
5
6
7
8
9
10
11
12
13
14

‍

新增控制器方法:

@RequestMapping(path = "/saveAccount3")
public String saveAccount3(Account account) {
    System.out.println("saveAccount");
    System.out.println(account);
    return "success";
}
1
2
3
4
5
6

‍ 我们重启并测试:

‍

输出:

Account{username='ppp', password='ppp', money=111.0, user=User{uname='ppp', age=111}, list=[User{uname='listname', age=111}], map={one=User{uname='mapname', age=222}}}
1

# 中文问题

如果我们提交的表单内容中,有中文,那么获取到的会是乱码,这是因为编码问题。get 方式不会,post 方式会有该问题;例如我们随便填一个中文用户名:

Account{username='è??é??', password='123456', money=666.0, user=User{uname='ppp', age=66}}
1

我们之前学习 Servlet 的时候,都是在方法里,用 request 对象设置下编码;

但如果每个方法都这样设置,比较麻烦,SpringMVC 提供了一个过滤器,通过它来解决乱码问题。我们在 web.xml 中添加如下过滤器:

<!-- 配置解决中文乱码问题 -->
<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>

<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
1
2
3
4
5
6
7
8
9
10
11
12
13
14

‍ 注意,最好将 filter 放在前端控制器之前定义,因为 XML 的约束是这样的。我们重启并测试,此时就没有中文乱码问题了

# 总结

本文我们演示了如何绑定数据,有基本类型,引用类型和集合类型。

特别注意:类型不能错。例如金额是数字类型,如果前端传了个英文字母,是会报错的 ‍ 本项目已将源码上传到 GitHub (opens new window) 和 Gitee (opens new window) 上。并且创建了分支 demo3,读者可以通过切换分支来查看本文的示例代码。

上次更新: 2025/5/17 12:26:09
RequestMapping 注解的作用
自定义类型转换器

← RequestMapping 注解的作用 自定义类型转换器→

最近更新
01
语雀文档一键下载至本地教程
07-04
02
要成功,就不要低估环境对你的影响
07-03
03
血泪教训:电子设备要定期开机
07-02
更多文章>
Theme by Vdoing | Copyright © 2022-2025 | 粤 ICP 备 2022067627 号 -1 | 粤公网安备 44011302003646 号 | 点击查看十年之约
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式