JSF2中Ajax事件和错误
JSF2的Ajax支持包含一个非常基本的功能以听取JSF2客户端处理代码中的事件和错误。它假设该功能会被部分开发员使用以监视事件,例如,当出现一个明显的Ajax请求时,图像会变成黄色,而没有这样的Ajax请求时则是黑色。本文将尝试解决JSF2中的Ajax事件和错误。
闲话少说,以下就是从Mojarra的Ajax样本中截取的一部分代码:
在出现Ajax调用的页面,我们会有以下域:
- < h3> Status:< /h3>
- < textarea id="statusArea" cols="40" rows="10" readonly="readonly" />
一个简单的文本区域,甚至都没有引入后端服务器数据模型。
然后,在我们的javascript中我们会看到这样的代码:
- var statusUpdate = function statusUpdate(data) {
- var statusArea = document.getElementById("statusArea");
- var text = statusArea.value;
- texttext = text + "Name: "+data.source.id;
- if (data.type === "event") {
- texttext = text +" Event: "+data.name+"\n";
- }
- else { // otherwise, it's an error
- texttext = text + " Error: "+data.name+"\n";
- }
- statusArea.value = text;
- };
- // Setup the statusUpdate function to hear all events on the page
- jsf.ajax.addOnEvent(statusUpdate);
- jsf.ajax.addOnError(statusUpdate);
运行代码的时候,你会看到一组数据流向页面其他地方出现的Ajax事件和错误一样通过文本区域。尝试样本代码可以看到更多。
到底发生了什么:首先,我们定义了一个JavaScript函数,将其设置为可变量,然后调用两个JSF Ajax 应用程序接口函数:assOnEvent和assOnError。这些函数使用statusUpdate函数作为其回调,作为第一个参数传送数据对象。
该数据对象,就事件而言,存在三个命名的事件:开始,完成以及成功。
◆开始――在请求被发送前就发生了。
◆完成――一旦请求完成,且还未调用javax.faces.response前发生。
◆成功――在响应方法结束后发生
这意味着对于一般的请求,这三项事件都会被调用,而如果出现某种错误,那么就只有开始和完成两项事件会被调用。而就错误而言,有四种可能的命名错误:
◆httpError――如果客户接收到任何HTTP状态不是200到299中间的任何数就会出现这一错误。
◆emptyResponse――当连接被放弃而没有出现任何响应的时候发生。
◆malformedXML――这意味着接收到的XML不能被正确地分析。
◆serverError――当错误在服务器上生成且被传送回客户端时出现这一错误。