SpringMVC 请求参数接收详解｜单个参数、多参数、对象参数、@RequestParam参数重命名

目录前言一、项目准备1.1 Person实体类1.2 RequestController控制器二、接收单个参数 r1()三、基本类型与包装类型大坑 r2()Boolean参数 r3()四、接收多个参数 r4()五、使用Java对象(Person)接收参数 r5()六、RequestParam 参数重命名 r6()场景RequestParam注解源码关键属性RequestParam小结七、常见报错汇总八、总结拓展阅读PDF知识点回顾前言SpringMVC是基于Servlet API构建的Web框架在SpringBoot项目中勾选Spring Web依赖底层就是SpringMVC框架。 Web开发中最核心的环节浏览器/Postman发送请求后端接收请求参数执行业务逻辑返回响应结果。本文结合课堂实战代码讲解SpringMVC接收url查询参数的几种常见方式接收单个普通参数基本类型 vs 包装类型踩坑接收多个参数使用实体类(Pojo)接收参数RequestParam参数重命名、设置非必传参数测试工具Postman或者浏览器地址栏直接拼接参数测试一、项目准备创建SpringBoot项目勾选Spring Web依赖。 两个核心类Person.java实体类、RequestController.java控制器。1.1 Person实体类package com.bit.spingmvcdemo.RequestController; public class Person { private String name; private Integer gender; private int age; private String email; public Person() { } public Person(String name, Integer gender, int age) { this.name name; this.gender gender; this.age age; } public String getName() { return name; } public void setName(String name) { this.name name; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age age; } public Integer getGender() { return gender; } public void setGender(Integer gender) { this.gender gender; } public String getEmail() { return email; } public void setEmail(String email) { this.email email; } Override public String toString() { return Person{ name name \ , age age , gender gender , email email \ }; } }1.2 RequestController控制器package com.bit.spingmvcdemo.RequestController; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; RestController RequestMapping(/request) public class RequestController { // 1.接收单个字符串参数 RequestMapping(/r1) public String r1(String s1){ return 接受到参数: s1; } // 2.接收包装类型参数 RequestMapping(/r2) public String r2(Integer age){ if (agenull){ return 参数不能为null; } return 接受到参数: age; } // 3.布尔类型参数 RequestMapping(/r3) public String r3(Boolean flag){ return 接受到参数: flag; } //4.接收多个参数 RequestMapping(/r4) public String r4(String name, Integer age){ return String.format(接受到参数: 姓名[%s], age[%d], name, age); } //5.对象接收参数 RequestMapping(/r5) public String r5(Person person){ return 接受到参数: person; } //6.RequestParam参数重命名设置非必传 RequestMapping(/r6) public String r6(RequestParam(value sa, required false) String name){ return 接受到参数: name; } }知识点RestController Controller ResponseBody该类所有方法返回值直接作为http响应数据不会去找视图页面。二、接收单个参数 r1()代码RequestMapping(/r1) public String r1(String s1){ return 接受到参数: s1; }访问地址http://127.0.0.1:8080/request/r1?s1helloworld规则请求参数key和方法形参名字保持一致SpringMVC自动赋值如果不传s1参数s1值为null不会报错。三、基本类型与包装类型大坑 r2()RequestMapping(/r2) public String r2(Integer age){ if (agenull){ return 参数不能为null; } return 接受到参数: age; }访问http://127.0.0.1:8080/request/r2?age18⚠️重点踩坑如果形参写int age基本数据类型请求不传age直接报500内部服务器错误。基本类型不能接收null。如果形参写Integer age包装类不传参数时age null程序不会崩溃。企业开发建议接收前端参数尽量使用包装类型Integer、Boolean不要使用int、boolean基本类型。Boolean参数 r3()RequestMapping(/r3) public String r3(Boolean flag){ return 接受到参数: flag; }传参?flagtrue/?flagfalse不传参得到null。四、接收多个参数 r4()RequestMapping(/r4) public String r4(String name, Integer age){ return String.format(接受到参数: 姓名[%s], age[%d], name, age); }访问http://127.0.0.1:8080/request/r4?namezhangsanage20规则url使用分割多个参数。参数顺序无关只匹配参数名称?age20namezhangsan同样可以拿到数据。某个参数不传对应变量为null包装类。五、使用Java对象(Person)接收参数 r5()RequestMapping(/r5) public String r5(Person person){ return 接受到参数: person; }访问地址http://127.0.0.1:8080/request/r5?name张三gender1age22emailtestqq.com核心规则请求参数的key必须和Person实体类的成员变量名完全一致。SpringMVC底层调用setter方法给属性赋值实体类必须有无参构造方法。某个参数不传引用类型赋值null基本类型int age会赋默认值0。注意这里是接收url查询参数、form表单参数不是接收JSON接收JSON需要加RequestBody注解。六、RequestParam 参数重命名 r6()场景前端传的参数名字和后端方法参数名字不一致例如前端参数名叫sa后端变量叫name此时使用RequestParam注解做映射。RequestMapping(/r6) public String r6(RequestParam(value sa, required false) String name){ return 接受到参数: name; }访问http://127.0.0.1:8080/request/r6?satestdataRequestParam注解源码关键属性public interface RequestParam { String value() default ; //前端参数名称 boolean required() default true; //是否必传默认true不传直接400报错 String defaultValue() default ; //默认值 }required true默认参数必须传递否则返回400 Bad Request。required false参数非必传不传时变量等于null。坑点如果不加requiredfalse访问/request/r6不带sa参数直接400错误。RequestParam小结写法参数是否必传作用RequestParam(sa) String name✅必传将前端sa映射到后端nameRequestParam(valuesa,requiredfalse) String name❌非必传映射允许不传参String name❌非必传参数名必须完全一致七、常见报错汇总500 内部错误Optionat int parameter ageis present but cannot be translated into a null value原因使用int基本类型接收前端不传参数。解决改为包装类型Integer age。400 Bad RequestMissingServletRequestParameterException原因RequestParam默认requiredtrue但是请求没有携带对应参数。 解决设置requiredfalse或者前端必须传递该参数。对象接收参数属性全部null排查①参数名和实体类属性名不一致②实体类没有无参构造③没有setter方法。八、总结接收简单参数方法形参名与请求参数名保持一致自动注入。参数类型优先包装类Integer/Boolean避开基本类型null赋值异常。参数多的时候直接封装POJO实体类接收减少方法形参。前后端参数名不一致用RequestParam(valuexxx)做映射requiredfalse设置非必传。RequestParam默认必传不传直接400开发很容易踩坑。