前端 Ajax 與後端 Spring MVC 控制器之間的資料交換,實務上可以歸納成五種寫法。以下範例前端使用 dhtmlxGrid,後端使用 fastjson。
把參數掛在 URL 後面,例如 /auth/getUser?userid=6。
對應的控制器方法寫成 getUser(String userid) 即可,Spring MVC 會依參數名稱自動對應。這種方法也可以額外接受 HttpSession、HttpServletRequest、HttpServletResponse、Model、ModelAndView 等容器物件。
前台:
ajaxPost("/base/user/exchangeSort", { "id": rid, "otherid": otherid }, function (data, status) {
// xxxxxx
});
後台:
public String exchangeSort(String id, String otherid) { ... }
前台直接把物件丟過去,jQuery 會攤平成 query string:
var org = { id: id };
ajaxPost("/base/org/getOrgById", org, function (data, textStatus) {
// xxxx
});
後台用同類型的物件接收,Spring 會自動完成屬性綁定:
public Org getOrgById(Org org) { ... }
當物件有巢狀結構(例如含外鍵的 dept),用 JSON.stringify() 序列化成字串再傳,後端用 fastjson 反序列化:
var user = { id: rowId };
var data = ajaxPost("/base/user/findById", { "userObj": JSON.stringify(user) }, null);
或者動態組出物件再送出:
var user = {};
user["id"] = id;
user["name"] = $("#name").val();
user["dept"] = {}; // 外鍵物件
user["dept"]["id"] = $("#deptid").val();
ajaxPost("/base/user/addUser", { "userObj": JSON.stringify(user) }, function (data) {
// xxxx
});
後台:
@RequestMapping("/findById")
@ResponseBody
public UserInfo findById(String userObj) {
// 使用 fastJSON 反序列化
UserInfo user = JSON.parseObject(userObj, UserInfo.class);
user = (UserInfo) userService.findById(UserInfo.class, user.getId());
return user;
}
整批列資料(例如表格逐列編輯後一次儲存)也一樣用序列化處理。前端遍歷 grid 每一列,組出物件陣列:
var objList = new Array();
grid.forEachRow(function (rId) {
var index = grid.getRowIndex(rId);
var obj = {};
obj["id"] = rId;
obj["user"] = {};
obj["user"]["id"] = $("#userId").val();
// 不建議用寫死的欄位索引
// obj["kinShip"] = grid.cells(rId, 1).getValue();
obj["kinShip"] = grid.cells(rId, grid.getColIndexById("columnName")).getValue();
obj["name"] = grid.cells(rId, grid.getColIndexById("name")).getValue();
if (grid.cells(rId, 3).getValue() != null && grid.cells(rId, 3).getValue() != "") {
var str = grid.cells(rId, 3).getValue().split("-");
var day = parseFloat(str[2]);
var month = parseFloat(str[1]) - 1; // JS 月份從 0 起算
var year = parseInt(str[0]);
var date = new Date();
date.setFullYear(year, month, day);
obj["birth"] = date;
} else {
obj["birth"] = "";
}
obj["politicalStatus"] = grid.cells(rId, 4).getValue();
obj["workUnit"] = grid.cells(rId, 5).getValue();
obj["isContact"] = grid.cells(rId, 6).isChecked() ? "1" : "0";
obj["phone"] = grid.cells(rId, 7).getValue();
obj["remark"] = grid.cells(rId, 8).getValue();
obj["sort"] = index;
objList.push(obj);
});
ajaxPost("/base/user/addUpdateUserHomeList", {
"userHomeList": JSON.stringify(objList),
"userId": $("#userId").val()
}, function (data, status) {
// xxxxx
});
後台用 JSON.parseArray() 還原成 List:
@RequestMapping("/addUpdateUserHomeList")
@ResponseBody
public String addUpdateUserHomeList(String userHomeList, String userId) {
List<UserHome> userHomes = JSON.parseArray(userHomeList, UserHome.class);
if (userHomes != null && userHomes.size() > 0) {
try {
userService.addUpdateUserHomeList(userHomes, userId);
} catch (Exception e) {
e.printStackTrace();
}
}
return "200";
}
把重複的錯誤處理集中到一處,是这五種方式都能共用的基礎:
function ajaxPost(url, dataParam, callback) {
var retData = null;
$.ajax({
type: "post",
url: url,
data: dataParam,
dataType: "json",
success: function (data, status) {
retData = data;
if (callback != null && callback != "" && callback != undefined) {
callback(data, status);
}
},
error: function (err, err1, err2) {
alertMsg.error("調用方法發生異常:" + JSON.stringify(err)
+ " err1 " + JSON.stringify(err1)
+ " err2: " + JSON.stringify(err2));
}
});
return retData;
}
要留意的是,return retData 在函式結束時必定是 null,因為非同步請求還沒回來。真的需要回傳值時,請一律走 callback 或 Promise/async-await,不要依賴這個 return。
以上就是 Spring MVC 前後端五種 Ajax 互動方法的整理,希望能給大家一個參考。