用 AJAX 拉取後端 JSON 並渲染到表格,是最典型的數據交互場景。這個 demo 完整串起了後端組裝 JSON、前端異步請求、jQuery 遍歷填充三個環節,值得作為範式來理解。
JSON(JavaScript Object Notation)是一種輕量級數據交換格式,易於人閱讀和編寫,同時也易於機器解析和生成。它採用完全獨立於語言的文本格式,但沿用了 C 語言家族的習慣約定(C、C++、C#、Java、JavaScript、Perl、Python 等),這些特性讓它成為理想的數據交換語言。
JSON 建構於兩種結構:
這些都是常見的數據結構,事實上大部分現代語言都以某種形式支持它們,這使得一種數據格式能在基於這些結構的語言之間自由交換。
語法上,對象以 { 開始、} 結束;每個名稱後跟一個冒號;名稱/值對之間用逗號分隔。
<table>
<tr id="head">
<td>lastname</td>
<td>firstname</td>
<td>address</td>
</tr>
<tr id="tr0">
<td id="td0"></td>
<td id="td1"></td>
<td id="td2"></td>
</tr>
<tr id="tr1">...</tr>
<tr id="tr2">...</tr>
</table>
示例預先寫好了三行空行,等數據回來再填充。
定義兩個 JavaBean 來體現嵌套結構:
package com.wk;
public class Person {
private String firstName;
private String lastName;
private Address address; // 嵌套對象
// getter / setter 省略
}
package com.wk;
public class Address {
private int id;
private String detail;
// getter / setter 省略
}
public class PersonServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
resp.setContentType("text/html;charset=utf-8");
PrintWriter out = resp.getWriter();
List<Person> persons = new ArrayList<Person>();
Person p1 = new Person();
Address a1 = new Address();
a1.setId(1);
a1.setDetail("河北省");
p1.setFirstName("瓜");
p1.setLastName("傻");
p1.setAddress(a1);
persons.add(p1);
// p2、p3 同理省略
StringBuffer bf = new StringBuffer();
bf.append("{\"person\":[");
for (Person person : persons) {
bf.append("{\"firstname\":\"")
.append(person.getFirstName()).append("\",\"")
.append("lastname\":\"")
.append(person.getLastName()).append("\",\"")
.append("address\":")
.append("{\"id\":\"")
.append(person.getAddress().getId()).append("\",\"")
.append("detail\":\"")
.append(person.getAddress().getDetail())
.append("\"}}\,");
}
// 去掉最後一個多餘的逗號
int length = bf.length();
String newStr = bf.substring(0, length - 1);
bf = new StringBuffer();
bf.append(newStr);
bf.append("]}");
out.println(bf);
}
}
這段拼接方式不可取。手工拼字符串生成 JSON 有幾個嚴重問題:字符串中的引號、反斜線、換行會破壞格式;數據為 null 時會輸出 "null" 字面量;「去掉最後一個逗號」這種技巧一旦列表為空就會數組越界。正確做法是使用成熟庫:
// 使用 Jackson
ObjectMapper mapper = new ObjectMapper();
List<Person> persons = buildPersons();
resp.setContentType("application/json;charset=utf-8");
mapper.writeValue(resp.getWriter(), persons);
讓序列化庫負責轉義與格式,才不會在邊界數據上翻車。
$(document).ready(function() {
// 簡單的樣式美化
$("table")
.css("border-color", "lightblue")
.css("border-style", "solid");
$("#head").css("background-color", "lightblue");
$.ajax({
url : "Json", // 後台處理程序
type : "post", // 請求方式
dataType : "json", // 期望返回的數據格式
timeout : 20000, // 超時時間(毫秒)
success : function(dataObj) {
// 遍歷 person 數組,逐行填充
$(dataObj.person).each(function(i, per) {
$("#tr" + i).find("#td0").html(per.lastname);
$("#tr" + i).find("#td1").html(per.firstname);
$("#tr" + i).find("#td2").html(per.address.detail);
});
}
});
});
dataType: "json" 告訴 jQuery 自動把返回的字符串解析為對象,所以 dataObj.person 可以直接當數組遍歷。.each() 的第二個參數是當前項,第一個是索引,用它拼接行 id 是個巧思。
不要用 eval()。原代碼寫了 var member = eval(dataObj);。既然已經設了 dataType: 'json',dataObj 就是對象了,再 eval 一次毫無意義,而且 eval 會執行任意代碼,是明確的安全風險。
用 text() 代替 html()。填充後端數據時用 html() 會把內容當 HTML 解析,如果數據中含有 <script> 就是 XSS 漏洞。純文本場景請用:
$("#tr" + i).find("td").eq(0).text(per.lastname);
id 必須唯一。示例中三行都用了 id="td0"、id="td1"、id="td2",這是重複 id,文檔無效。$() 用 id 選擇器時只會返回第一個匹配項,所以示例看似能跑,實際上後兩行永遠填不進去。應該改用 class 或 eq():
var $row = $("#sample tbody tr").eq(i);
$row.find("td").eq(0).text(per.lastname);
$row.find("td").eq(1).text(per.firstname);
$row.find("td").eq(2).text(per.address.detail);
行數寫死不可取。示例預先準備三行,數據多於三條就溢出,少於三條就留空行。應該動態生成:
var $tbody = $("#sample tbody");
$tbody.empty();
$.getJSON("/api/persons")
.done(function(list){
list.forEach(function(per){
$tbody.append(
$("<tr>").append(
$("<td>").text(per.lastname),
$("<td>").text(per.firstName),
$("<td>").text(per.address.detail)
)
);
});
})
.fail(function(){
alert('加載失敗,請刷新重試');
});
加上 error 處理。原代碼只有 success,網絡超時或服務端報錯時用戶只會看到一片空白,完全不知道發生了什麼。任何 AJAX 請求都應該有失敗分支。
這個 demo 的價值在於展示完整鏈路,但代碼質量停留在教學示例層面。真正可複用的經驗是:
text() 填充文本,避免 XSSeq() 定位eval(),讓 dataType 完成解析