DIV CSS 佈局教程網

用 jQuery 收發 XML 資料的伺服器端實作(Java 版)
編輯:JQuery特效代碼     

AJAX 早期最主流的資料交換格式是 XML。本文以「帳號可用性檢查」為例,示範 jQuery 如何送出請求、伺服器端如何組出 XML 回應,以及前端如何解析並更新頁面。

執行效果如下:

伺服器端 Servlet

package com.ljq.test;

import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.ServletException;
import java.io.IOException;
import java.io.PrintWriter;

/**
 * 利用 jQuery 接受和處理 xml 數據
 * @author jiqinlin
 */
@SuppressWarnings("serial")
public class AjaxXmlServer extends HttpServlet {
  protected void doGet(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {
    try {
      // 修改一:回應的 Content-Type 必須是 text/xml
      response.setContentType("text/xml;charset=utf-8");
      PrintWriter out = response.getWriter();

      // 1. 取參數
      String old = request.getParameter("name").trim();

      // 修改二:回傳的資料需要組裝成 xml 格式
      StringBuilder builder = new StringBuilder();
      builder.append("<message>");

      // 2. 檢查參數是否有效
      if (old == null || "".equals(old)) {
        builder.append("用戶名不能為空").append("</message>");
      } else {
        // 3. 校驗操作
        String name = old;
        if (name.equals("linjiqin")) {
          builder.append("用戶名[").append(name)
                 .append("]已經存在,請使用其他用戶名").append("</message>");
        } else {
          builder.append("用戶名[").append(name)
                 .append("]尚未存在,可以使用該用戶名注冊").append("</message>");
        }
        out.println(builder.toString());
        System.out.println(builder.toString());
      }
    } catch (Exception e) {
      e.printStackTrace();
    }
  }

  protected void doPost(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {
    doGet(request, response);
  }
}

程式碼裡標了兩處「修改」,這兩點正是最容易出錯的地方:Content-Type 必須明確設為 text/xml,否則 jQuery 不會把它當 XML 解析;回應內容必須是格式正確的 XML,標籤要成對、要有單一根節點。範例用 <message> 包住整段訊息就是為了滿足後者。

web.xml 設定

<servlet>
  <servlet-name>AjaxXmlServer</servlet-name>
  <servlet-class>com.ljq.test.AjaxXmlServer</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>AjaxXmlServer</servlet-name>
  <url-pattern>/servlet/ajaxXmlServer</url-pattern>
</servlet-mapping>

請求頁面

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"https://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<script type="text/javascript" src="https://localhost:8083/jqueryprj/js/jquery-1.3.1.js"></script>
<script type="text/javascript" src="https://localhost:8083/jqueryprj/js/verifyjqueryxml.js"></script>
</head>
<body>
  <input type="text" id="userName" />
  <input type="button" value="校驗" onclick="verify()"/>
  <div id="result"></div>
</body>
</html>

前端 JavaScript

function verify(){
  var userName = $("#userName").val();
  $.ajax({
    type: "POST",                        // http 請求方式
    url: "servlet/ajaxXmlServer",        // 伺服器端 url
    data: "name=" + userName,            // 送給伺服器的資料
    dataType: "xml",                     // 告訴 jQuery 回傳的格式
    success: callback                    // 成功後的回呼
  });
}

// 回呼函式
function callback(data) {
  var jqueryObj = $(data);        // 把 XML 包裝成 jQuery 物件
  var message   = jqueryObj.children();   // 取得 message 節點
  var text      = message.text();         // 取出文字內容
  $("#result").html(text);                // 動態顯示在頁面上
}

解析的關鍵:把 XML 當 DOM 來查

這段程式碼最值得學習的是 $(data) 這一步。當 dataType 設為 "xml" 時,jQuery 會把回應文字解析成 XML 文件,而 $(data) 則把它包裝成 jQuery 物件。此後你就能用 children()、find()、text()、attr() 等熟悉的方法操作它,就像操作 HTML 一樣。

若 XML 結構較複雜,例如:

<result>
  <code>0</code>
  <message>操作成功</message>
</result>

就可以寫成 var code = $(data).find("code").text(); 逐個取出。

今日的替代方案

XML 作為資料交換格式,在 2010 年代後已大幅被 JSON 取代——體積更小、解析更快、不必處理命名空間與 CDATA。若重新實作這個功能,前端只要把 dataType 改為 "json",後端輸出 {"exists":true,"message":"..."},程式碼會短很多:

$.getJSON("servlet/ajaxXmlServer", { name: userName }, function (res) {
  $("#result").text(res.message);
});

不過理解 XML 仍有其價值:SOAP、RSS、SVG、部分企業系統的既有介面都還在用,遇到時不會手忙腳亂。

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