讓我們舉一個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="btncanceld" type="button" value="get canceled" />
</div>
正常完成,我們指定服務器端沒有延時也沒有異常,并給出了一個合理的(10秒)的超時時間:
function btnworkfine_onclick() {
complexwebservice.badmethod(
0,
false,
onbadmethodcomplete,
onbadmethodtimeout,
onbadmethoderror,
onbadmethodaborted,
"btnworkfine_onclick",
10000
);
}
function onbadmethodcomplete(result)
{
alert(result);
}
超時,指定服務器端延時3秒,但超時時間設置成為僅1秒:
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);
}
異常,制定服務器端擲出異常。注意回調函數中可以使用response參數得到詳細的錯誤信息:
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);
}
用戶取消,與正常完成類似,不過在發出請求后立刻使用request.abort()取消了操作:
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);
}
新聞熱點
疑難解答
圖片精選