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° 官方檢驗。
以上為個人經驗,希望能給大傢一個參考,也希望大傢多多支持WalkonNet。如有錯誤或未考慮完全的地方,望不吝賜教。
推薦閱讀:
- SpringMvc接受請求參數的幾種情況演示
- SpringBoot使用AOP記錄接口操作日志詳解
- springboot RESTful以及參數註解的使用方式
- Java 實戰范例之員工管理系統的實現
- SpringBoot獲取前臺參數的六種方式以及統一響應