作者:Dflying Chen(http://dflying.cnblogs.com/)
前面的一系列的文章都是直接調用單獨的一個Web Service,而在實際項目開發中,特別是在對現有的項目轉換中,把頁面中的邏輯再提取到專門的Web Service中往往會帶來相當多的工作。Atlas充分考慮到了這一點,允許您將服務器端的public方法加上[WebMethod]屬性以允許客戶端JavaScript的直接調用。
想允許客戶端直接調用定義在ASPX頁面中的方法,您需要指定該方法為public,並且添加[WebMethod]屬性,例如如下定義在ASPX文件中的服務器端方法:
<script runat="server">
[WebMethod]
public int AddInt(int int1, int int2)
{
return int1 + int2;
}
</script>
在客戶端,Atlas將為您Mashup出一個AddInt的JavaScript方法,存在於一個特殊的命名空間PageMethods中,這樣您就可以通過PageMethods.AddInt()調用上面的方法了。
同時,將WebMethod定義到ASPX頁面中,您還可以在該方法中訪問一切頁面上的服務器端控件的值和VIEwState,並且整個頁面的的生存周期將和傳統的ASP.Net頁面PostBack一樣,諸如Page_Load等方法均會被調用,可以讓我們對頁面有更強的訪問能力。不過這樣也帶來了性能上的折扣,因為每次調用Web Method的時候都會把頁面上的VIEwState和控件的值傳回給服務器,並且服務器端處理整個頁面的生存周期將要比僅僅處理一個純粹的定義在ASMX中的Web Method要復雜的多。所以這裡我推薦盡可能的使用純粹的Web Service,請參考:在Atlas服務器端實現中推薦使用Web Service而不是Page Method。
下面來看一個實例,首先來定義在ASPX中的WebMethod,可以看到這裡不單單求兩個數的和,還訪問了一個頁面上的服務器端TextBox的值:
<script runat="server">
[WebMethod]
public string AddInt(int int1, int int2)
{
return (int1 + int2).ToString() + string.Format("\r\nAnd the Server TextBox's Text is '{0}'.", tbServer.Text);
}
</script>
然後是頁面的ScriptManager,這裡無需添加任何引用了: <atlas:ScriptManager ID="scriptManager" runat="server" />
然後兩個用來輸入加數的input以及用來觸發服務器調用的input:
<input id="value1" type="text" value="1" />
<input id="value2" type="text" value="2" />
<input id="btnAdd" type="button" value="Add!" onclick="return btnAdd_onclick()" />
還有一個服務器端TextBox:
<asp:TextBox ID="tbServer" runat="server" Text="Server control"></ASP:TextBox>
最後是JavaScript調用,注意PageMethods這個內建的命名空間:
function btnAdd_onclick() {
PageMethods.AddInt(
$('value1').value,
$('value2').value,
OnComplete
);
}
function OnComplete(result)
{
alert(result);
}
浏覽器中運行,輸入兩個加數,然後在Server端的TextBox中輸入一些字符,點擊Add,可以看到Server端的TextBox的值卻是被訪問到了:
這是Fiddler截獲的網絡傳輸,可以看到VIEwState和TextBox都被傳回了Server:
該實例程序的源代碼可以在此下載:http://www.cnblogs.com/Files/dflying/WebMethodOnPage.zip