本文主要比較三種實作 Ajax 的方式,並歸納字串轉 JSON 的常見做法,作為後續學習的起點。
準備工作:
1. prototype.js
2. jquery-1.3.2.min.js
3. json2.js
後台處理程式(Servlet),訪問路徑 servlet/testAjax:
Java 程式碼
package ajax.servlet;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
* Ajax 範例後台處理程式
* @author bing
* @version 2011-07-07
*/
public class TestAjaxServlet extends HttpServlet {
public void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
PrintWriter out = response.getWriter();
String name = request.getParameter("name");
String age = request.getParameter("age");
out.print("{\"name\":\"" + name + "\",\"age\":" + age + "}");
out.flush();
out.close();
}
public void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
doGet(request, response);
}
}
TestAjaxServlet 接收 name 與 age 兩個參數,並回傳一段以 JSON 格式撰寫的字串。
前台參數輸入介面(HTML):
<div id="show">顯示區域</div>
<div id="parameters">
name:<input id="name" name="name" type="text" /><br />
age:<input id="age" name="age" type="text" /><br />
</div>
一、以 prototype 實作
<script type="text/javascript" src="prototype.js"></script>
<script type="text/javascript">
function prototypeAjax() {
var url = "servlet/testAjax"; // 請求 URL
var params = Form.serialize("parameters"); // 提交的表單
var myAjax = new Ajax.Request(url, {
method: "post", // 請求方式
parameters: params, // 參數
onComplete: pressResponse, // 回應函式
asynchronous: true
});
$("show").innerHTML = "正在處理中...";
}
function pressResponse(request) {
var obj = request.responseText; // 以文字方式接收
$("show").innerHTML = obj;
var objJson = request.responseText.evalJSON(); // 將接收的文字解析為 JSON 格式
$("show").innerHTML += "name=" + objJson['name'] + " age=" + objJson['age'];
}
</script>
<input id="submit" type="button" value="提交" onclick="prototypeAjax()" /><br />
在 prototype 的 Ajax 實作中,使用 evalJSON 方法將字串轉換成 JSON 物件。
二、以 jQuery 實作
<script type="text/javascript" src="jquery-1.3.2.min.js"></script>
<script type="text/javascript" src="json2.js"></script>
<input id="submit" type="button" value="提交" /><br />
<script type="text/javascript">
function jqueryAjax() {
var user = { "name": "", "age": "" };
user.name = $("#name").val();
user.age = $("#age").val();
var time = new Date();
$.ajax({
url: "servlet/testAjax?time=" + time,
data: "name=" + user.name + "&age=" + user.age,
datatype: "json", // 請求頁面返回的資料型別
type: "GET",
contentType: "application/json", // 注意此處 contentType 需與請求頁面一致
success: function (data) {
var dataJson = JSON.parse(data); // 使用 json2.js 的 parse 方法轉換
$("#show").html("data=" + data + " name=" + dataJson.name + " age=" + dataJson.age);
},
error: function (XMLHttpRequest, textStatus, errorThrown) {
$("#show").html("error");
}
});
}
$("#submit").bind("click", jqueryAjax); // 綁定提交按鈕
</script>
剛接觸 jQuery 時,在 JSON 處理上借助了 json2.js。
三、以 XMLHttpRequest 實作
<script type="text/javascript">
var xmlhttp;
function XMLHttpRequestAjax() {
// 取得資料
var name = document.getElementById("name").value;
var age = document.getElementById("age").value;
// 取得 XMLHttpRequest 物件
if (window.XMLHttpRequest) {
xmlhttp = new XMLHttpRequest();
} else if (window.ActiveXObject) {
var activxName = ["MSXML2.XMLHTTP", "Microsoft.XMLHTTP"];
for (var i = 0; i < activexName.length; i++) {
try {
xmlhttp = new ActiveXObject(activexName[i]);
break;
} catch (e) {}
}
}
xmlhttp.onreadystatechange = callback; // 回呼函式
var time = new Date(); // 在 url 後加上時間,使每次請求都不一樣
var url = "servlet/testAjax?name=" + name + "&age=" + age + "&time=" + time;
xmlhttp.open("GET", url, true); // 以 get 方式發送請求
xmlhttp.send(null); // 參數已在 url 中,此處不需再傳
}
function callback() {
if (xmlhttp.readyState == 4) {
if (xmlhttp.status == 200) {
var responseText = xmlhttp.responseText; // 以文字方式接收回應
var userdiv = document.getElementById("show");
var responseTextJson = JSON.parse(responseText); // 使用 json2.js 的 parse 方法轉換
userdiv.innerHTML = responseText + " name=" + responseTextJson.name + " age=" + responseTextJson.age;
}
}
}
</script>
<input id="submit" type="button" value="提交" onclick="XMLHttpRequestAjax()" /><br />
PS:字串轉 JSON 的三種方式
在採用 Ajax 的專案開發過程中,經常需要將 JSON 格式的字串返回前端,再由前端解析成 JS 物件。ECMA-262(E3)並未將 JSON 概念納入標準,直到 ECMA-262(E5)才正式引入,包含全域的 JSON 物件與 Date 的 toJSON 方法。
1. eval 方式解析(最早的解析方式)
function strToJson(str) {
var json = eval('(' + str + ')');
return json;
}
別忘了字串兩側的小括號。
2. new Function 形式(較為特殊)
function strToJson(str) {
var json = (new Function("return " + str))();
return json;
}
在 IE6/7 中,當字串含有換行(\n)時,new Function 無法解析,但 eval 卻可以。
3. 使用全域的 JSON 物件
function strToJson(str) {
return JSON.parse(str);
}
目前 IE8(S)、Firefox 3.5+、Chrome 4、Safari 4、Opera 10 皆已支援此方法。
使用 JSON.parse 需嚴格遵守 JSON 規範,例如屬性名稱都必須用引號包起來:
var str = '{name:"jack"}';
var obj = JSON.parse(str); // --> parse error
由於 name 沒有以引號包起,使用 JSON.parse 時在所有瀏覽器中皆會拋出異常、解析失敗;而前兩種方式則不受影響。