DIV CSS 佈局教程網

jQuery 如何接收後台返回的 List 集合數據
編輯:JQuery入門技巧     

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 拼接的轉義,以及空數據的兜底提示。這四點做到,這個功能就不會在測試階段反覆返工。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved