JSF2: Ajax事件和错误

JSF2的Ajax支持包含一个非常基本的功能以听取JSF客户端处理代码中的事件和错误。它假设该功能会被部分开发员使用以监视事件，例如，当出现一个明显的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;

text = text + "Name: "+data.source.id;

if (data.type === "event") {

text = text +" Event: "+data.name+"\n";

} else { // otherwise, it's an error

text = 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函数作为其回调，作为第一个参数传送数据对象。
　　该数据对象，连同函数本身都在JSF2说明的14.4章节进行了定义。就事件而言，存在三个命名的事件：开始，完成以及成功。

·开始——在请求被发送前就发生了。

·完成——一旦请求完成，且还未调用javax.faces.response前发生。

·成功——在响应方法结束后发生

这意味着对于一般的请求，这三项事件都会被调用，而如果出现某种错误，那么就只有开始和完成两项事件会被调用。而就错误而言，有四种可能的命名错误：

·httpError——如果客户接收到任何HTTP状态不是200到299中间的任何数就会出现这一错误。

·emptyResponse——当连接被放弃而没有出现任何响应的时候发生。

·malformedXML——这意味着接收到的XML不能被正确地分析。

·serverError——当错误在服务器上生成且被传送回客户端时出现这一错误。

数据有效负载包括：

·类型——事件或错误之一。

·名称——错误或事件名称，如上所述。

·源——触发事件的DOM要素。

·对于那些称为serverError的错误，也存在一个errorName和errorMessage域，目的是为了发送并完成服务器错误。

·附加的responseCode，responseXML和responseTxt，作为XMLHttpResponse对象。

因此，你什么时候需要使用这一功能呢?可能不会经常使用。但是由于它没有在任何其他其他留下记载，笔者希望能对其作出一些描述。