剛進公司的時候接到第一個專案,常常會卡在「後端把資料丟出來了,前端卻收不到」這種環節。實際走過一輪之後發現,問題多半不在語法,而在雙方對資料格式的約定是否一致。以下把集合與類物件這兩種常見的 JSON 輸出方式,以及前端 Ajax 的接收寫法整理成一份筆記。
使用 json-lib 時,不論要輸出的是 List 集合還是單一物件,都可以透過 JSONArray.fromObject 轉成 JSON 結構,再交給 outJSONData 寫回 response:
// 情況一:集合(多筆資料) JsonConfig jsonConfig = new JsonConfig(); jsonConfig.setCycleDetectionStrategy(CycleDetectionStrategy.LENIENT); JSONArray json = JSONArray.fromObject(listPm, jsonConfig); outJSONData(json); // 情況二:單一類物件 Blog b = (Blog) bgdao.findBlog(Integer.parseInt(id)); b.setBbsCenterStr(new String(b.getBbsCenter())); JSONArray json2 = JSONArray.fromObject(b); outJSONData(json2);
這裡有兩個實務上很常出問題的點。
其一是循環引用。當物件之間雙向關聯(例如文章指向使用者、使用者又指向文章),序列化時會因為無限遞迴而炸掉。CycleDetectionStrategy.LENIENT 的作用就是遇到循環時放過它,讓序列化能走完;另一個常見選擇是 IGNORE,直接略過循環的屬性。
其二是編碼。中文欄位若沒有明確指定輸出編碼,前端拿到的很可能是一串亂碼。上面對 getBbsCenter() 再包一層 new String(...) 就是為了避開這類問題,不過更根本的做法是在 response 上統一設定 Content-Type: application/json;charset=UTF-8。
後端回的是陣列結構時,前端用 $.each 逐筆走訪、組出 HTML 片段,再塞回容器即可:
dataType: "json", success: function (data) { var crmHtml = ''; $.each(data, function (i, comment) { crmHtml += '<tr>' + '<td colspan="2" style="text-align: center;color: black;font-size: 18px;font-weight:bold;">' + comment.bbsTitle + '</td>' + '</tr>'; }); $('#bowenchakan').html(crmHtml); }搭配使用時,dataType: "json" 這行不能省。它會讓 jQuery 自動把回應字串 parse 成物件,省下手動 JSON.parse 的麻煩;若後端實際回的不是合法 JSON,這裡就會直接跳 error 而非 success。
另外提醒一個安全性問題:直接把後端欄位字串拼進 HTML,等於把 XSS 的門打開了。只要欄位內容可能來自使用者輸入,就該改用 .text() 設定文字,或先做轉義處理。
遇到「前端收不到資料」時,與其猜,不如照順序確認三件事:在瀏覽器開發工具的 Network 面板看回應內容是否為合法 JSON、看 Content-Type 是否正確、最後才是檢查欄位名稱有沒有拼錯。這三步走完,九成的問題都會現形。