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——当错误在服务器上生成且被传送回客户端时出现这一错误。
数据有效负载包括:
◆类型——事件或错误之一。
◆名称——Ajax事件和错误名称,如上所述。
◆源——触发事件的DOM要素。
◆对于那些称为serverError的错误,也存在一个errorName和errorMessage域,目的是为了发送并完成服务器错误。
◆附加的responseCode,responseXML和responseTxt,作为XMLHttpResponse对象。
因此,你什么时候需要使用这一功能呢?可能不会经常使用。但是由于它没有在任何其他其他留下记载,笔者希望能对其作出一些描述。
【编辑推荐】