萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 解析 JSON 格式資料:從 Servlet 回傳到前端渲染完整流程

JSON 結構速覽

  • 物件:{"key": "value"} — 無序鍵值對集合
  • 陣列:["value1", "value2"] — 有序值列表
  • 巢狀結構:物件包含陣列、陣列包含物件,任意層級組合

完整專案架構

專案結構:
├── index.jsp          # 前端頁面
├── js/
│   ├── jquery-1.3.2.js
│   └── login.js       # jQuery 解析邏輯
├── com/
│   ├── wk/
│   │   ├── Person.java
│   │   └── Address.java
│   └── servlet/
│       └── PersonServlet.java

後端 Java Bean 定義

// Person.java
public class Person {
    private String firstName;
    private String lastName;
    private Address address;
    // getter/setter 略...
}

// Address.java
public class Address {
    private int id;
    private String detail;
    // getter/setter 略...
}

Servlet 組裝 JSON 字串回傳

@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<>();
    // 建立測試資料...
    persons.add(new Person("瓜", "傻", new Address(1, "河北省")));
    persons.add(new Person("蛋", "笨", new Address(2, "江西省")));
    persons.add(new Person("癡", "白", new Address(1, "湖南省")));
    
    // 手動拼接 JSON 字串(不推薦,易出錯)
    StringBuffer bf = new StringBuffer();
    bf.append("{\"person\":[");
    for (Person person : persons) {
        bf.append("{\"firstname\":\"").append(person.getFirstName())
          .append("\",\"lastname\":\"").append(person.getLastName())
          .append("\",\"address\":{\"id\":").append(person.getAddress().getId())
          .append(",\"detail\":\"").append(person.getAddress().getDetail()).append("\"}}");
    }
    // 移除最後逗號
    if (bf.length() > 0) bf.deleteCharAt(bf.length() - 1);
    bf.append("]}");
    
    out.println(bf.toString());
}

⚠️ 強烈建議:使用 Jackson/Gson 等 JSON 庫序列化,避免手動拼接導致格式錯誤、XSS 風險、特殊字元未轉義等問題。

前端 jQuery 解析與渲染

$(document).ready(function() {
    // 表格樣式初始化
    $("table").css({"border-color": "lightblue", "border-style": "solid"});
    $("#head").css("background-color", "lightblue");
    
    $.ajax({
        url: "Json",           // Servlet 路徑
        type: "post",
        dataType: "json",      // 關鍵:自動解析 JSON 回傳 JavaScript 物件
        timeout: 20000,
        success: function(data) {
            // data 為解析後的 JS 物件:{ person: [ {...}, {...}, {...} ] }
            var persons = data.person;
            
            for (var i = 0; i < persons.length; i++) {
                var p = persons[i];
                var rowId = i; // 對應 tr0, tr1, tr2
                
                $("#td0").eq(rowId).text(p.lastname);
                $("#td1").eq(rowId).text(p.firstname);
                $("#td2").eq(rowId).text(p.address.detail);
            }
        },
        error: function(xhr, status, error) {
            console.error("AJAX 錯誤:", status, error);
            alert("資料載入失敗");
        }
    });
});

HTML 表格結構

<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">
        <td id="td0"></td><td id="td1"></td><td id="td2"></td>
    </tr>
    <tr id="tr2">
        <td id="td0"></td><td id="td1"></td><td id="td2"></td>
    </tr>
</table>

注意:HTML 中重複使用相同 id(td0、td1、td2)是不合法的。建議改用 class 或資料屬性 data-col。

改進版:合法 HTML + 正確渲染

<table id="personTable">
    <thead>
        <tr><th>姓氏</th><th>名字</th><th>地址</th></tr>
    </thead>
    <tbody></tbody>
</table>

<script>
success: function(data) {
    var $tbody = $('#personTable tbody');
    $tbody.empty(); // 清空舊資料
    
    $.each(data.person, function(i, p) {
        var row = '<tr>'
            + '<td>' + escapeHtml(p.lastname) + '</td>'
            + '<td>' + escapeHtml(p.firstname) + '</td>'
            + '<td>' + escapeHtml(p.address.detail) + '</td>'
            + '</tr>';
        $tbody.append(row);
    });
}

// 簡易 HTML 轉義防 XSS
function escapeHtml(text) {
    var map = {'&': '&', '<': '<', '>': '>', '"': '"', "'": '''};
    return text.replace(/[&<>"']/g, function(m) { return map[m]; });
}

JSON 回傳範例(標準格式)

{
  "person": [
    {
      "firstname": "瓜",
      "lastname": "傻",
      "address": { "id": 1, "detail": "河北省" }
    },
    {
      "firstname": "蛋",
      "lastname": "笨",
      "address": { "id": 2, "detail": "江西省" }
    },
    {
      "firstname": "癡",
      "lastname": "白",
      "address": { "id": 1, "detail": "湖南省" }
    }
  ]
}

現代化建議

  1. 後端:Spring Boot @RestController + Jackson 自動序列化
  2. 前端:fetch() + response.json() 替代 $.ajax
  3. 模板:使用 Template Literals 或 Vue/React 等框架綁定資料
  4. 錯誤處理:統一 API 回應格式 {success: true, data: ..., error: ...}

總結

jQuery dataType: "json" 會自動將回應解析為 JS 物件,配合 $.each() 遍歷渲染。核心重點在於:後端正確序列化 JSON、前端正確選取元素填充、注意 HTML 合法性與 XSS 防護。

copyright © 萬盛學電腦網 all rights reserved