ASP.NET 2.0 Ajax程序:处理异步调用中的异常
|
在传统的Web应用程序中,处理异常相对来说比较简单即使开发者不作任何处理,浏览器也会默认地将收到的异常信息显示在浏览器中。而对于Ajax应用程序来说,事情却并不那么简单。Ajax程序“异步”的天性加上其后台运行的行为,让用户乃至开发者都很难判断某次对服务器的调用是否顺利完成,浏览器自然也对Ajax程序运行时发生的异常无能为力。 因此,在ASP.NET AJAX异步通信层的实现中,自然也内建了对异步调用时异常的处理方法 在调用成功的回调函数callbackFunction的后面,我们还可以提供另一个调用失败的回调函数。这样,客户端调用Web Service代理的语法就变为: [NameSpace].[ClassName].[MethodName](param1, param2,..., onSucceeded, onFailed)注意其中粗体部分新添加的onFailed回调函数,该函数将在本次异步通信出现异常时由ASP.NET AJAX异步通信层调用。而onSucceeded的行为不会受到任何影响,仍将在成功调用后执行。 onFailed回调函数将接受一个类型为Sys.Net.WebServiceError的参数,表示异常对象。其函数签名将类似如下所示: function onFailed(error) {
ASP.NET AJAX的客户端Sys.Net.WebServiceError类型封装了异步请求服务器时可能发生的异常,它提供了若干个只读的属性,提供了对异常信息的详细描述。Sys.Net.WebServ- iceError类型的属性如表3-1所示。 表3-1 Sys.Net.WebServiceError类型的属性
根据ASP.NET AJAX客户端组件的命名规范,访问属性均需要在属性名称前加上get_或set_前缀。例如,若想得到某个Sys.Net.WebServiceError类型异常的message属性值,则应该按照如下方式书写代码: var errorMessage = errorObj.get_message();下面让我们用一个简单的示例程序演示在客户端调用Web Service代理时发生异常的处理办法,以及Sys.Net.WebServiceError类型中各个属性的使用方法。 该示例程序是一个除法计算器,程序将借助ASP.NET AJAX异步通信层将用户输入的除数和被除数发送至服务器,服务器完成具体的除法计算过程后再将结果返回至客户端显示出来。程序运行的初始界面如图3-4所示。 输入除数和被除数,然后点击问号(?)按钮,程序将调用服务器端Web Service完成本次除法,并将商显示在问号按钮中,如图3-5所示。 若是用户输入的除数为0,那么服务器端执行时显然要抛出异常。我们没有在服务器端对该异常进行处理,因此将导致本次异步调用失败,客户端也会显示出异常的详细信息,如图3-6所示。 让我们先从服务器端的Web Service入手。将该Web Service命名为MathService,并在其中定义了一个名为Divide()的方法,用来执行除法操作。Divide()方法所接受的两个参数分别代表被除数和除数,其逻辑非常简单,代码如下: [WebService(Namespace = "http://tempuri.org/")]
这里有必要再次提醒一下,Web Service类要添加[ScriptService]属性,其中需要暴露给客户端的方法也要添加[WebMethod]属性这些都是允许从客户端调用该Web Service代理的必要条件。 在ASP.NET页面中,添加ScriptManager控件以及上述Web Service的引用: <asp:ScriptManager ID="sm" runat="server">
然后在ASP.NET页面中定义程序的界面: <input id="tbA" type="text" style="width: 40px" /> /
其中前两个<input />(id分别为tbA和tbB)用来让用户输入被除数和除数;第三个<input />(id为btnInvoke)则作为按钮(type="button")用来触发对服务器端Web Service的调用,并显示除法完成后的商;下面id为result的<div />用来显示可能出现的异常信息。 btnInvoke的click事件的处理函数为btnInvoke_onclick(),其代码如下: function btnInvoke_onclick() {
注意其中粗体部分,即调用Web Service客户端代理的一行。其中不但传入了被除数和除数(a和b),还传入了成功调用后的回调函数onSucceeded以及失败时的回调函数onFailed。 成功调用时的回调函数onSucceeded()比较简单,这里不赘: function onSucceeded(result) {
失败时的回调函数onFailed()才是本示例程序的重点:
function onFailed(error) {
可以看到,onFailed()函数首先取得了传递进来的Sys.Net.WebServiceError对象的各个属性,然后再依次显示到id为result的<div />中。 这样就完成了本示例程序的编写。运行该程序并尝试做一些除法,若程序编写正确的话,你将看到如图3-4、图3-5和图3-6所示的界面。 当然,本示例程序的目的是为了演示调用服务器端Web Service时发生异常的处理方法,所以自然事无巨细地将所有异常信息均显示了出来。而在实际开发中,我们则不应该完整显示出此类唐突的异常细节。通常的做法是根据不同的异常进行相应的处理,并在需要的情况下再为用户显示出相对友好的提示消息 本文作者:未知 源代码网供稿. |



