Spring MVC 裡用 @ResponseBody 返回一個 List,前端 jQuery 該怎麼接?其實和接收普通對象沒有區別,關鍵在於後端要正確序列化,前端要記得聲明 dataType。
@RequestMapping(params = "getUser")
@ResponseBody
public List<User> getUser() {
List<User> list = new ArrayList<>();
return list;
}
@ResponseBody 會讓 Spring 通過消息轉換器把返回對象序列化成 JSON。要讓這一步生效,項目裡需要配置 Jackson(或其他 JSON 庫),Spring Boot 默認已經集成。
$.ajax({
type: 'POST',
url: '${pageContext.request.contextPath}/sys/user?getUser',
dataType: 'json',
success: function (data) {
jQuery.each(data, function (i, item) {
alert(item.id);
});
}
});
data 就是一個 JS 數組,用 $.each 遍歷,item 即每個 User 對象。
1. 後端返回的是不是真的數組
如果直接在方法的返回結果上再包一層,比如返回 {"code":0,"data":[...]},那前端的遍歷路徑也要跟著變成 data.data 或 data.list。約定好結構比事後猜更省事。
2. 忘記寫 dataType: 'json'
不寫也能工作,但 jQuery 會根據響應的 Content-Type 猜測類型。如果後端沒設置 Content-Type: application/json,data 就會是一個字符串,此時 $.each 遍歷出來的是一個個字符。加上 dataType: 'json' 可以讓 jQuery 顯式解析,避免這個坑。
3. 用 $.each 還是 JS 原生方法
success: function (data) {
// jQuery 寫法
$.each(data, function (i, item) {
console.log(item.id);
});
// 原生寫法,更直觀
data.forEach(function (item) {
console.log(item.id);
});
// 提取某一列成數組
var ids = data.map(function (item) { return item.id; });
}
4. 渲染到表格時拼接 HTML 的風險
很多同學拿到 List 之後直接字符串拼接 table 的 innerHTML:
var html = '';
$.each(data, function (i, item) {
html += '<tr><td>' + item.name + '</td></tr>';
});
$('#table tbody').html(html);
如果 item.name 裡含有 <script> 之類的內容,這裡就是一個 XSS 入口。更安全的做法是用 jQuery 逐個創建元素並用 .text() 賦值,或者使用模板引擎並確保開啟轉義。
5. 空集合的處理
後端返回空 List 時,前端拿到的是 [] 而不是 null,遍歷不會報錯但也不會有任何內容。用戶看到的是一片空白,體驗上不如給個「暫無數據」的提示:
success: function (data) {
if (!data || data.length === 0) {
$('#table tbody').html('<tr><td colspan="4">暫無數據</td></tr>');
return;
}
// 渲染數據
}
總結起來,接收 List 這件事本身很簡單——就是一個 JSON 數組。真正需要留心的是 dataType 聲明、返回結構約定、HTML 拼接的轉義,以及空數據的兜底提示。這四點做到,這個功能就不會在測試階段反覆返工。