下一步,设置XMLHttpRequest的头信息,以标志请求的内容为form-encoded。最后,将form-encoded数据作为请求体,并发送此请求。列表3中集中展示了这些步骤。
列表3:发送一个添加到购物车XMLHttpRequest
/*
* 通过产品编码,在购物车中添加一个条目
* itemCode – 需要添加条目的产品编码
*/
function addToCart(itemCode)
{
// 获取一个XMLHttpRequest实例
var req = newXMLHttpRequest();
// 设置用来从请求对象接收回调通知的句柄函数
var handlerFunction =
getReadyStateHandler(req, updateCart);
req.onreadystatechange =
handlerFunction;
// 打开一个联接到购物车servlet的
HTTP POST联接
// 第三个参数表示请求是异步的
req.open("POST", "cart.do", true);
// 指示请求体包含form数据
req.setRequestHeader("Content-Type",
"application/x-www-form-urlencoded");
// 发送标志需要添加到购物车
中条目的form-encoded数据
req.send("action=add&item="+itemCode);
}
结合以上内容,你可以了解到Ajax处理过程的第一部分—就是在客户端创建并发送HTTP请求。下一步是用来处理请求的Java Servlet代码。
Servlet请求处理
通过一个servlet来处理XMLHttpRequest与处理一个来自浏览器的普通的HTTP请求基本上相似。可以通过调用HttpServletRequest.getParameter()来获取由POST请求体传送过来的form-encoded数据。
Ajax请求也与普通的WEB请求样都成为此应用同一HttpSession会话进程的一部分。这对于购物车例子来说很有肜,因为我们可以通过会话将多个请求的状态都保存到同一个JavaBean购物车对象中,并可以序列化。
列表4是处理Ajax请求并更新购物车的简单servlet的代码片断。从用户会话中检索出一个Cart Bean,并按请求的参数更新它。
之后Cart Bean被序列化到XML,并被写回ServletRespone。注意,一定要将响应内容的类型设置为application/xml,否则,XMLHttpRequest将不能将响应内容解析为一个XML DOM。
列表4:处理Ajax请求的Servlet代码
public void doPost(HttpServletRequest req,
HttpServletResponse res)
throws Java.io.IOException
{
Cart cart = getCartFromSession(req);
String action = req.getParameter("action");
String item = req.getParameter("item");
if ((action != null)&&(item != null))
{
// 在购物车中添加或移除一个条目
if ("add".equals(action))
{
cart.addItem(item);
} else if ("remove".equals(action)) {
cart.removeItems(item);
}
}
// 将购物车状态序列化到XML
String cartXml = cart.toXml();
// 将XML写入response.
res.setContentType("application/xml");
res.getWriter().write(cartXml);
}
列表5展示了由Cart.toXml()方法生成的XML。注意到生成的cart元素的属性,是一个通过System.currentTimeMillis()生成的时间戳。
列表5:Cart对象序列化得到的XML
total="$171.95">
Hat
2
Chair
1
Dog
1
如果你观察一下下载站点提供的例子应用源码中的Cart.Java,你将会看到它通过简单地追加字符串来生成XML。对于本例子来说,它已经足够了,我将会在本系统文章的以后一期中介绍一些更好的方法。
现在你知道了CartServlet如何响应一个XMLHttpRequest。下一步是返回到客户端,如何用服务器响应来更新页面状态。
通过JavaScript来处理服务器响应
XMLHttpRequest的readyState属性是一个给出请求生命周期状态的数字值。它从表示“未初始化”的0变化到表示“完成”的4。每次readyState改变时,都会引发readystatechange事件,通过onreadystatechange属性配置回调处理函数将会被调用。
在列表3中,你已看到通过调用函数getReadyStateHandler()创建了一个处理函数,并被配置给onreadystatechange属性。getReadyStateHandler()使用了这样的事实:函数是JavaScript中的主要对象。
这意味着,函数可以作为参数被传递到其它函数,并且可以创建并返回其它函数。getReadystateHandler()要做是就是返回一个函数,来检查XMLHttpRequet是否已经完成处理,并传递XML服务器响应到由调用者指定的处理函数。列表6是getReadyStateHandler()的代码。
列表6:函数getReadyStateHandler()
/*
* Returns a function that waits for
the specified XMLHttpRequest
* to complete, then passes its XML
response to the given handler function.
* req - The XMLHttpRequest
whose state is changing
* responseXmlHandler -
Function to pass the XML response to
*/
function getReadyStateHandler(req,
responseXmlHandler) {
// 返回一个监听XMLHttpRequest实例的匿名函数
return function ()
{
// 如果请求的状态是“完成”
if (req.readyState == 4)
{
// 检查是否成功接收了服务器响应
if (req.status == 200)
{
// 将载有响应信息的XML传递到处理函数
responseXmlHandler(req.responseXML);
} else
{
// 有HTTP问题发生
alert("HTTP error: "+req.status);
}
}
}
}
HTTP状态码
在列表6中,XMLHttpRequest的status属性被测试用来确定请求是否成功完成。当处理简单的GET与POST请求,你可以认为只要不是200(OK)的状态就表示发生了错误。若服务器发送了一个重定向响应(例如,301或302),浏览器会透明地完成重定向并从新位置获取相应的资源;XMLHttpRequest不会看到重定向状态码。
同时,浏览器自动添加一个缓存控制:对于所有XMLHttpRequest都使用no-cache header,这样客户端代码就可以不用处理304(not-modified)响应。
关于getReadyStateHandler()
getReadyStateHandler()是相对比较复杂的一段代码,特别当你不能熟悉阅读JavaScript时。折中方案是在你的JavaScript库中包含此函数,你可以简单地处理Ajax服务器响应,而不用去注意XMLHttpRequest的内部细节。重要是你自己要理解在代码中如何使用getReadyStateHandler()。
在列表3中,你看到getReadyStateHandler()被这样调用:
handlerFunction=
getReadyStateHandler(req,updateCart)
由它返回的函数将会检查在req变量中的XMLHttpRequest是否已完成,并调用由updateCart指定的回调方法处理响应XML。
提取购物车数据
列表7中展示了updateCart()中的代码。此函数使用DOM来解析购物车XML文档,并更新WEB页面(参见列表1)来反映新的购物车内容。注意对用来提取数据的XML DOM的调用。
Cart元素上生成的属性,即序列化时生成的时间戳,通过检测它可以保证不会用老的数据来覆盖新的购物车数据。Ajax请求天生就是异步的,通过这个检测可以有效避免在过程外到达的服务器响应的干扰。
列表7:更新页面来反映出购物车XML文档内容
function updateCart(cartXML)
{
// 从文档中获取根元素“cart”
var cart =
cartXML.getElementsByTagName("cart")[0];
// 保证此文档是最新的
var generated =
cart.getAttribute("generated");
if (generated > lastCartUpdate)
{
lastCartUpdate = generated;
// 清除HTML列表,用来显示购物车内容
var contents =
document.getElementById("cart-contents");
contents.innerHTML = "";
// 在购物车内按条目循环
var items =
cart.getElementsByTagName("item");
for (var I = 0 ;
I < items.length ; I++)
{
var item = items[I];
// 从name与quantity元素中提取文本节点
var name = item.getElementsByTagName("name")
[0].firstChild.nodeValue;
var quantity = item.getElementsByTagName
("quantity")[0].firstChild.nodeValue;
// 为条目创建并添加到HTML列表中
var li = document.createElement("li");
li.appendChild
(document.createTextNode(name+" x "+quantity));
contents.appendChild(li);
}
}
// 更新购物车的金额累计
document.getElementById("total").innerHTML = cart.getAttribute("total");
}
到现在,关于Ajax处理过程的教程已经结束,也许你想让应用运行起来,并看看它的实际运作。这个例子非常简单,有非常大的改进的余地。比如,我在服务器端代码中包含了从购物车中移除条目的代码,但从客户端UI中没有访问的途径。作为一个练习,尝试在现有的JavaScript基础上实际这个功能。