前言
開發這麼多年，肯定還有不少小夥伴搞不清各種類型的參數是如何傳遞的，很多同學都是拿來即用，複製粘貼一把擼，遇到問題還是一臉懵逼。
姿勢
學習參數傳遞的正確姿勢，先說怎麼做，再說為什麼，本質上還是複製粘貼一把擼，問題是你想問不想問為什麼！
傳遞
用戶登錄
前端代碼：
<code>var param = {
"username": "admin",
"password": "admin"
}
$.ajax({
url: "/sys/login",
data: param,
type: "post",
dataType: "json",
success: function(data) {
}
});
/<code>後端代碼：
<code>@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("登錄成功");
}
}
/<code>
當然，你也可以這麼實現，@RequestParam(value="username", required=true) ，required 默認為 true，如果前臺不傳遞此參數，後臺會報錯。如果設置為 false，如果不傳，默認為 null。
<code>/**
* 登錄
* 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("登錄成功");
}
/<code>
用戶註冊
前端代碼，提交方式與登錄基本保持一致。
後端代碼：
用一個對象來接收前臺參數，一般後端有對應的實體類。
<code>/**
* 註冊
* https://blog.52itstyle.vip
*/
@PostMapping("/register")
public Result register(SysUser user){
logger.info("{}，用戶註冊",user.getUsername());
//業務邏輯
return Result.ok("註冊成功");
}
/<code>
多參數無實體一
前端代碼：
<code>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) {
}
});
/<code>後端實現：
<code>/**
* 多參數
* https://blog.52itstyle.vip
*/
@PostMapping("/multiParameter")
public Result register(@RequestBody Map<string> map){
logger.info("多參數傳遞:{},{}",map.get("title"),map.get("content"));
//業務邏輯
return Result.ok("接收多參數成功");
}
/<string>/<code>
多參數無實體二
前端代碼：
<code>var param = {
"title": "爪哇筆記",
"content": "一個有趣的公眾號",
"author": "小柒2012"
}
$.ajax({
url: "/sys/multiParameter",
data: param,
type: "post",
dataType: "json",
success: function(data) {
}
});
/<code>後端實現：
<code>/**
* 多參數
* https://blog.52itstyle.vip
*/
@PostMapping("/multiParameter")
public Result register(@RequestParam Map<string> map){
logger.info("多參數傳遞:{},{}",map.get("title"),map.get("content"));
//業務邏輯
return Result.ok("接收多參數成功");
}
/<string>/<code>
傳遞數組
前端代碼：
<code>var param = {
"ids": [1, 2, 3]
}
$.ajax({
url: "/sys/array",
data: param,
type: "post",
dataType: "json",
success: function(data) {
}
});
/<code> 後端實現：
<code>/**
* 數組
* https://blog.52itstyle.vip
*/
@PostMapping("array")
public Result array(@RequestParam(value = "ids[]") Integer[] ids) {
logger.info("數據{}", Arrays.asList(ids));
//業務邏輯
return Result.ok();
}
/<code>
傳遞集合
前端代碼與傳遞數組保持一致。
後端實現：
<code>/**
* 集合
* https://blog.52itstyle.vip
*/
@PostMapping("array")
public Result array(@RequestParam(value = "ids[]") List<integer> ids) {
logger.info("數據{}", ids.toString());
//業務邏輯
return Result.ok();
}
/<integer>/<code>
傳遞集合實體對象
比如，後端想接收一個實體對象集合 List<sysuser>
前端代碼：
<code>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) {
}
});
/<code>
後端代碼：
<code>/**
* 爪哇筆記
* 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();
}
/<sysuser>/<code>
傳遞集合實體對象一對多
比如，一個用戶有多個角色 List<sysrole> roleList/<sysrole>
前端代碼：
<code>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) {
}
});
/<code>
後端實現：
<code>/**
* 爪哇筆記
* 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();
}
/<sysrole>/<sysuser>/<code>
炒雞複雜
傳輸對象有實體，有集合，有各種類型的數據，這時候最簡單的方式就是傳遞 Key-Value 結構的 JSON 字符串，後臺 Map 類型接收，然後通過FastJson的 JSON.parseObject() 和 JSON.parseArray() 方法轉化為對應的實體或者集合。
<code> 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);
/<rule>/<code>RESTful 風格
比如，訪問某篇文章：
<code>/**
* 爪哇筆記
* https://blog.52itstyle.vip
*/
@GetMapping("article/{id}")
public void article(@PathVariable("id") String id) {
logger.info("文章{}",id);
//業務邏輯
}
/<code>
原則
記住一下幾點：
- @RequestBody註解，必須與 contentType 類型application/json配合使用。
- @RequestParam註解，必須與 contentType 類型application/x-www-form-urlencoded配合使用，其為默認類型。
- JSON.stringify() 把對象類型轉換為字符串類型，一般配合 @RequestBody註解和contentType 類型application/json使用。
擴展
在以上只涉及了兩種 contentType 類型，其實還有兩種常見的類型：
multipart/form-data
一般用於表單文件上傳，必須讓 form 的 enctype 等於這個值。
<code>
/<code>
text/xml
做過微信支付的小夥伴一定會知道，微信就喜歡用這種方式，去年還發生過 XXE 漏洞，在解析XML文檔時，解析器通過 ENTITY 擴展的功能，讀取本地受保護的文件，並且使用擴展功能將受保護的文件發送到遠程地址。
分享到:
閱讀更多 Java小馬哥 的文章
