SpringBoot 设置传入参数非必要的操作

 更新时间:2021年02月27日 15:45:58   作者:Moon Lignt Shadow  
这篇文章主要介绍了SpringBoot 设置传入参数非必要的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧

我就废话不多说了,大家还是直接看代码吧~

设置参数是否为必要参数

@RequestParam(required = false) 

补充:SpringBoot 开发案例之参数传递的正确姿势

前言

开发这么多年,肯定还有不少小伙伴搞不清各种类型的参数是如何传递的,很多同学都是拿来即用,复制粘贴一把撸,遇到问题还是一脸懵逼。

姿势

学习参数传递的正确姿势,先说怎么做,再说为什么,本质上还是复制粘贴一把撸,问题是你想问不想问为什么!

传递

用户登录

前端代码:

var param = {
 "username": "admin",
 "password": "admin"
}
$.ajax({
 url: "/sys/login",
 data: param,
 type: "post",
 dataType: "json",
 success: function(data) {
 }
});

后端代码:

@RestController
@RequestMapping("/sys")
public class LoginController {
 private static final Logger logger = LoggerFactory.getLogger(LoginController.class);
 /**
  * 登录
  */
 @PostMapping("/login")
 public Result login(String username, String password){
  logger.info("用户登录"+username);
  //业务逻辑
  return Result.ok("登录成功");
 }
}

当然,你也可以这么实现,@RequestParam(value="username", required=true) ,required 默认为 true,如果前台不传递此参数,后台会报错。如果设置为 false,如果不传,默认为 null。

/**
 * 登录
 * https://blog.52itstyle.vip
 */
@PostMapping("/login")
public Result login(@RequestParam(value="username", required=true) String username,
     @RequestParam(value="password", required=true) String password){
 logger.info("用户登录"+username);
 //业务逻辑
 return Result.ok("登录成功");
}

用户注册

前端代码,提交方式与登录基本保持一致。

后端代码:

用一个对象来接收前台参数,一般后端有对应的实体类。

/**
 * 注册
 * https://blog.52itstyle.vip
 */
@PostMapping("/register")
public Result register(SysUser user){
 logger.info("{},用户注册",user.getUsername());
 //业务逻辑
 return Result.ok("注册成功");
}

多参数无实体一

前端代码:

var param = {
 "title": "爪哇笔记",
 "content": "一个有趣的公众号",
 "author": "小柒2012"
}
param = JSON.stringify(param);
$.ajax({
 url: "/sys/multiParameter",
 data: param,
 type: "post",
 contentType: "application/json",
 dataType: "json",
 success: function(data) {
 }
});

后端实现:

/**
 * 多参数
 * https://blog.52itstyle.vip
 */
@PostMapping("/multiParameter")
public Result register(@RequestBody Map<String,Object> map){
 logger.info("多参数传递:{},{}",map.get("title"),map.get("content"));
 //业务逻辑
 return Result.ok("接收多参数成功");
}

多参数无实体二

前端代码:

var param = {
 "title": "爪哇笔记",
 "content": "一个有趣的公众号",
 "author": "小柒2012"
}
$.ajax({
 url: "/sys/multiParameter",
 data: param,
 type: "post",
 dataType: "json",
 success: function(data) {
 }
});

后端实现:

/**
 * 多参数
 * https://blog.52itstyle.vip
 */
@PostMapping("/multiParameter")
public Result register(@RequestParam Map<String,Object> map){
 logger.info("多参数传递:{},{}",map.get("title"),map.get("content"));
 //业务逻辑
 return Result.ok("接收多参数成功");
}

传递数组

前端代码:

var param = {
 "ids": [1, 2, 3]
}
$.ajax({
 url: "/sys/array",
 data: param,
 type: "post",
 dataType: "json",
 success: function(data) {
 }
});

后端实现:

/**
 * 数组
 * https://blog.52itstyle.vip
 */
@PostMapping("array")
public Result array(@RequestParam(value = "ids[]") Integer[] ids) {
 logger.info("数据{}", Arrays.asList(ids));
 //业务逻辑
 return Result.ok();
}

传递集合

前端代码与传递数组保持一致。

后端实现:

/**
 * 集合
 * https://blog.52itstyle.vip
 */
@PostMapping("array")
public Result array(@RequestParam(value = "ids[]") List<Integer> ids) {
 logger.info("数据{}", ids.toString());
 //业务逻辑
 return Result.ok();
}

传递集合实体对象

比如,后端想接收一个实体对象集合 List<SysUser>

前端代码:

var list = [];
list.push({
 "username": "小柒2012",
 "mobile": "17762288888"
});
list.push({
 "username": "小柒2013",
 "mobile": "17762289999"
});
$.ajax({
 url: "/sys/listUser",
 data: JSON.stringify(list),
 type: "post",
 contentType: "application/json",
 dataType: "json",
 success: function(data) {
 }
});

后端代码:

/**
 * 爪哇笔记
 * https://blog.52itstyle.vip
 */
@PostMapping("listUser")
public Result listUser(@RequestBody List<SysUser> list) {
 logger.info("数据{}", list.size());
 list.forEach(user->{
  //输出实体对象
  System.out.println(user.getUsername());
 });
 //业务逻辑
 return Result.ok();
}

传递集合实体对象一对多

比如,一个用户有多个角色 List<SysRole> roleList

前端代码:

var roleList = [];
roleList.push({
 "roleSign": "admin",
 "roleName": "管理员"
});
roleList.push({
 "roleSign": "user",
 "roleName": "普通用户"
});
var list = [];
var user = {
 "username": "小柒2012",
 "mobile": "17762288888"
};
user.roleList = roleList;
list.push(user);
$.ajax({
 url: "/sys/listUserRole",
 data: JSON.stringify(list),
 type: "post",
 contentType: "application/json",
 dataType: "json",
 success: function(data) {
 }
});

后端实现:

/**
 * 爪哇笔记
 * https://blog.52itstyle.vip
 */
@PostMapping("listUserRole")
public Result listUserRole(@RequestBody List<SysUser> list) {
 logger.info("数据{}", list.size());
 list.forEach(user->{
  List<SysRole> roleList = user.getRoleList();
  roleList.forEach(role->{
   System.out.println(role.getRoleName());
  });
 });
 return Result.ok();
}

炒鸡复杂

传输对象有实体,有集合,有各种类型的数据,这时候最简单的方式就是传递 Key-Value 结构的 JSON 字符串,后台 Map 类型接收,然后通过FastJson的 JSON.parseObject() 和 JSON.parseArray() 方法转化为对应的实体或者集合。

 String user = parseMap.get("user").toString();
 SysUser sysUser = JSON.parseObject(user,SysUser.class);
 String contractClause = parseMap.get("rules").toString();
 List<Rule> ruleList = JSON.parseArray(contractClause,Rule.class);

RESTful 风格

比如,访问某篇文章:

/**
 * 爪哇笔记
 * https://blog.52itstyle.vip
 */
@GetMapping("article/{id}")
public void article(@PathVariable("id") String id) {
 logger.info("文章{}",id);
 //业务逻辑
}

原则

记住一下几点:

@RequestBody注解,必须与 contentType 类型application/json配合使用。

@RequestParam注解,必须与 contentType 类型application/x-www-form-urlencoded配合使用,其为默认类型。

JSON.stringify() 把对象类型转换为字符串类型,一般配合 @RequestBody注解和contentType 类型application/json使用。

扩展

在以上只涉及了两种 contentType 类型,其实还有两种常见的类型:

multipart/form-data

一般用于表单文件上传,必须让 form 的 enctype 等于这个值。

<form action="/upload" method="post" enctype="multipart/form-data">
 <input type="text" name="description" value="爪哇笔记,一个神奇的公众号">
 <input type="file" name="myFile">
 <button type="submit">Submit</button>
</form>

text/xml

做过微信支付的小伙伴一定会知道,微信就喜欢用这种方式,去年还发生过 XXE 漏洞,在解析XML文档时,解析器通过 ENTITY 扩展的功能,读取本地受保护的文件,并且使用扩展功能将受保护的文件发送到远程地址。

小结

不敢说是最完整的传参方案,但绝对敢保证是最正确的,因为所有的传参方式都经过 360° 官方检验。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。如有错误或未考虑完全的地方,望不吝赐教。

相关文章

  • Request与Session的存值取值操作

    Request与Session的存值取值操作

    这篇文章主要介绍了Request与Session的存值取值操作,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-07-07
  • javaWeb如何实现随机图片验证码详解

    javaWeb如何实现随机图片验证码详解

    这篇文章主要给大家介绍了关于javaWeb如何实现随机图片验证码的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-03-03
  • java 格式化输出数字的方法

    java 格式化输出数字的方法

    在实际工作中,常常需要设定数字的输出格式,如以百分比的形式输出,或者设定小数位数等,现稍微总结如下
    2014-01-01
  • 生产者消费者模型ThreadLocal原理及实例详解

    生产者消费者模型ThreadLocal原理及实例详解

    这篇文章主要介绍了生产者消费者模型ThreadLocal原理及实例详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-09-09
  • Java如何正确的使用wait-notify方法你知道吗

    Java如何正确的使用wait-notify方法你知道吗

    这篇文章主要为大家详细介绍了Java如何正确的使用wait-notify方法,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下,希望能够给你带来帮助
    2022-03-03
  • Springboot整合Netty实现RPC服务器的示例代码

    Springboot整合Netty实现RPC服务器的示例代码

    这篇文章主要介绍了Springboot整合Netty实现RPC服务器的示例代码,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-01-01
  • 基于Redisson实现注解式分布式锁的示例代码

    基于Redisson实现注解式分布式锁的示例代码

    这篇文章主要为大家详细介绍了如何基于Redisson实现注解式分布式锁,文中的示例代码讲解详细,具有一定的参考价值,需要的可以了解一下
    2023-07-07
  • java web FTPClient实现上传文件到指定服务器

    java web FTPClient实现上传文件到指定服务器

    这篇文章主要为大家详细介绍了java web FTPClient实现上传文件到指定服务器,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2018-06-06
  • 浅谈Maven resrouce下filtering作用

    浅谈Maven resrouce下filtering作用

    Filtering是Maven Resources Plugin的一个功能,本文主要介绍了浅谈Maven resrouce下filtering作用,具有一定的参考价值,感兴趣的可以了解一下
    2024-03-03
  • 创建好SpringBoot项目后但是找不到Maven的解决方法

    创建好SpringBoot项目后但是找不到Maven的解决方法

    在使用IDEA专业版创建好SpringBoot项目后,发现上方导航栏的运行按钮是灰色的,而且左侧导航栏的pom.xml的图标颜色也不是正常的,点开右侧导航栏的Maven后,发现Maven找不到,所以本文介绍了创建好SpringBoot项目后但是找不到Maven的解决方法,需要的朋友可以参考下
    2024-10-10

最新评论