在ASP.NET Atlas中调用Web Service——处理错误，超时以及响应用户的取消操作

在ASP.NET Atlas中调用Web Service——处理错误，超时以及响应用户的取消操作

作者：Dflying Chen （ http://dflying.cnblogs.com/ ）

在本系列的上一篇（在ASP.NET Atlas中调用Web Service——介绍及简单应用）中，我们熟悉了Atlas中调用Web Service的最基础方法，但是在实际开发中，仅仅发出请求并等待返回结果是不够的，我们大都需要考虑对错误超时等的处理，也要允许用户取消操作。幸运的是，Atlas对Web Service中的Web Method的封装也充分考虑到了这些需求。

让我们举一个Web Method的例子来说明，例如，对于如下的Web Method：

public   class  ComplexWebService  : System.Web.Services.WebService  {

    [WebMethod]
    public string BadMethod(int delayTime, bool throwException)
    {
        // something something
    }
}

 

 

Atlas 产生的JavaScript mash up 将会有如下的签名：

ComplexWebService.BadMethod(
    delayTime, 
    throwException, 
    onMethodComplete, 
    onMethodTimeout, 
    onMethodError, 
    onMethodAborted,
    userContext,
    timeoutInterval,
    priority,
    useGetMethod,
);

 

1. onMethodComplete：指定当该方法顺利完成并返回时被触发的回调函数名，一般情况下您应该总是指定这个方法。
2. onMethodTimeout,：指定当该方法执行超时时被触发的函数名。
3. onMethodError：指定当该方法在执行中遇到异常时被触发的函数名。
4. onMethodAborted：制定当该方法执行期间被用户取消时被触发的函数名。
5. userContext：用户上下文对象，在上述四个函数中都可以访问到。
6. timeoutInterval：设定超时的时间限制，单位毫秒，默认值好像为90000。一般情况下不需要更改。
7. priority：设定该方法的执行优先级。该优先级将被用于批量AJAX操作（将在下一篇中提到）中。
8. useGetMethod：是否采用HTTP GET来发送请求，默认为false。

上述这八个属性的顺序必须按照指定的来。但有时候我们只需要指定顺序靠后的某个参数，就不得不同时书写前面的参数。为此，Atlas特意为我们提供了另一种调用方法，将上述八个参数以dictionary的形式传给该方法。例如当我们只需要onMethodComplete和timeoutInterval参数时，可以这样写：

ComplexWebService.BadMethod(
    delayTime, 
    throwException, 
     {
        onMethodComplete: completeHandler, 
        timeoutInterval: 10000
    }
);

 

OK，让我们通过一个实例看看在一般情况下上述四种回调函数（onMethodComplete，onMethodTimeout，onMethodError和onMethodAborted）中的常见处理。

首先让我们完成开头部分的Web Service方法：

using  System;
using  System.Web;
using  System.Web.Services;
using  System.Web.Services.Protocols;

[WebService(Namespace  =   " http://tempuri.org/ " )]
[WebServiceBinding(ConformsTo  =  WsiProfiles.BasicProfile1_1)]
public   class  ComplexWebService  : System.Web.Services.WebService  {

    [WebMethod]
    public string BadMethod(int delayTime, bool throwException)
    {
        if (throwException)
        {
            throw new Exception("Sorry, I do not like to do this!");
        }
        System.Threading.Thread.Sleep(delayTime);
        return "Done!";
    }
}

 

可以看到该方法有两个参数：delayTime指定该方法的延时，throwException指定该方法是否掷出异常。通过控制这两个参数以及调用时的timeoutInterval参数，我们就可以模拟完成，超时以及异常的三种情况。

然后，在页面中加入ScriptManager并添加对这个Web Service的引用：

< atlas:ScriptManager  ID ="ScriptManager1"  runat ="server" >
     < Services >
         < atlas:ServiceReference  Path ="ComplexWebService.asmx"   />
     </ Services >
</ atlas:ScriptManager >

 

 

在ASPX页面上添加四个按钮，用来触发下述四种情况：

< div >
    This is a BAD method, it can: < br  />
     < input  id ="btnWorkFine"  type ="button"  value ="work fine"  onclick ="return btnWorkFine_onclick()"   />
     < input  id ="btnTimeOut"  type ="button"  value ="timeout"  onclick ="return btnTimeOut_onclick()"   />
     < input  id ="btnThrowException"  type ="button"  value ="throw an exception"  onclick ="return btnThrowException_onclick()"   />
     < input  id ="btnCanceld"  type ="button"  value ="get canceled"  onclick ="return btnCanceld_onclick()"   />
</ div >

 

function  btnWorkFine_onclick()  {
    ComplexWebService.BadMethod(
        0, 
        false, 
        onBadMethodComplete, 
        onBadMethodTimeout, 
        onBadMethodError, 
        onBadMethodAborted,
        "btnWorkFine_onclick",
        10000
        );
}
function  onBadMethodComplete(result) 
{
    alert(result);
}

 

function  btnTimeOut_onclick()  {
    ComplexWebService.BadMethod(
        3000, 
        false, 
        onBadMethodComplete, 
        onBadMethodTimeout, 
        onBadMethodError, 
        onBadMethodAborted,
        "btnTimeOut_onclick",
        1000
        );
}
function  onBadMethodTimeout(request, userContext) 
{
    var timeoutString = "The call to '" + userContext + "' failed due to time out!"; 
    alert(timeoutString);
}

 

function  btnThrowException_onclick()  {
    ComplexWebService.BadMethod(
        0, 
        true, 
        onBadMethodComplete, 
        onBadMethodTimeout, 
        onBadMethodError, 
        onBadMethodAborted,
        "btnThrowException_onclick",
        10000
        );
}
function  onBadMethodError(result, response, userContext) 
{
    var errorString = "Test '" + userContext + "' failed!";
    if (result == null) {
        errorString += "  Status code='" + response.get_statusCode() + "'";
    }
    else {
        errorString += 
             "  Message='" + result.get_message() +
            "'/r/nstackTrace = " + result.get_stackTrace();
    }
    
    alert(errorString);
}

 

function  btnCanceld_onclick()  {
    var request = ComplexWebService.BadMethod(
        2000, 
        false, 
        onBadMethodComplete, 
        onBadMethodTimeout, 
        onBadMethodError, 
        onBadMethodAborted,
        "btnCanceld_onclick",
        10000
        );
    request.abort();
}
function  onBadMethodAborted(request, userContext)  {
    var errorString = "The call to  '" + userContext + "' failed, request is aborted!";
    alert(errorString);
}

 

超时：

异常：

用户取消：

该示例程序可以在此下载：http://www.cnblogs.com/Files/dflying/ControlTheWebService.zip

正常完成，我们指定服务器端没有延时也没有异常，并给出了一个合理的（10秒）的超时时间：超时，指定服务器端延时3秒，但超时时间设置成为仅1秒：异常，制定服务器端掷出异常。注意回调函数中可以使用response参数得到详细的错误信息：用户取消，与正常完成类似，不过在发出请求后立刻使用request.abort()取消了操作：截图如下，正常完成：
注意到Web Method 中的两个参数按照顺序作为了JavaScript 方法的前两个参数，接下来还有一些额外的参数：