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对象。

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


« 
» 
快速导航

Copyright © 2016 phpStudy | 豫ICP备2021030365号-3