DIV CSS 佈局教程網

jQuery 解析 JSON 數據填充表格:從後端到前端的完整實例
編輯:JavaScript綜合知識     

用 AJAX 拉取後端 JSON 並渲染到表格,是最典型的數據交互場景。這個 demo 完整串起了後端組裝 JSON、前端異步請求、jQuery 遍歷填充三個環節,值得作為範式來理解。

一、JSON 格式基礎

JSON(JavaScript Object Notation)是一種輕量級數據交換格式,易於人閱讀和編寫,同時也易於機器解析和生成。它採用完全獨立於語言的文本格式,但沿用了 C 語言家族的習慣約定(C、C++、C#、Java、JavaScript、Perl、Python 等),這些特性讓它成為理想的數據交換語言。

JSON 建構於兩種結構:

  • 「名稱/值」對的集合——在/dl> 各語言中被理解為對象(object)、記錄(record)、結構(struct)、字典(dictionary)、哈希表(hash table)、有鍵列表(keyed list)或關聯數組(associative array)
  • 值的有序列表——在大多數語言中被理解為數組(array)

這些都是常見的數據結構,事實上大部分現代語言都以某種形式支持它們,這使得一種數據格式能在基於這些結構的語言之間自由交換。

語法上,對象以 { 開始、} 結束;每個名稱後跟一個冒號;名稱/值對之間用逗號分隔。

二、頁面結構

<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 省略
}

四、Servlet 組裝 JSON

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);

讓序列化庫負責轉義與格式,才不會在邊界數據上翻車。

五、jQuery 解析並填充表格

$(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 的價值在於展示完整鏈路,但代碼質量停留在教學示例層面。真正可複用的經驗是:

  1. 後端用序列化庫生成 JSON,不要手拼字符串
  2. 前端用 text() 填充文本,避免 XSS
  3. id 必須唯一,遍歷填充用 class 或 eq() 定位
  4. 行數動態生成,不寫死
  5. 禁用 eval(),讓 dataType 完成解析
  6. 每個 AJAX 請求都要有失敗處理
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved