日期:2010-08-26 浏览次数:20586 次
让我们举一个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,
);
注意到Web Method中的两个参数按照顺序作为了JavaScript方法的前两个参数,接下来还有一些额外的参数:
onMethodComplete:指定当该方法顺利完成并返回时被触发的回调函数名,一般情况下您应该总是指定这个方法。
onMethodTimeout,:指定当该方法执行超时时被触发的函数名。
onMethodError:指定当该方法在执行中遇到异常时被触发的函数名。
onMethodAborted:制定当该方法执行期间被用户取消时被触发的函数名。
userContext:用户上下文对象,在上述四个函数中都可以访问到。
timeoutInterval:设定超时的时间限制,单位毫秒,默认值好像为90000。一般情况下不需要更改。
priority:设定该方法的执行优先级。该优先级将被用于批量AJAX操作(将在下一篇中提到)中。
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" />
<input id="btnTimeOut" type="button" value="timeout" />
<input id="btnThrowException" type="button" value="throw an exception" />
<input id="btnCanc