ArcGIS Server .Net ADF中的AJAX(一)

對于沒有很好的 .net 編程基礎(chǔ)， arcobjects 的開發(fā)經(jīng)驗的開發(fā)人員而言，開發(fā) arcgis server 的應(yīng)用是比較費(fèi)勁的。最簡單和最快的學(xué)習(xí)之處就是先整清楚 esri 為我們提供的模板程序，別看這個功能簡單的模板程序，里面包含了各種你開發(fā) arcgis server 應(yīng)用所需要的技術(shù)。 Ajax 技術(shù)就是其中之一。下面講的東西在模版程序中都可以找到應(yīng)用。


我們并不細(xì)究 ajax 復(fù)雜的技術(shù)本身，我們需要的僅僅是 ajax 技術(shù)在我們的 arcgis server 開發(fā)過程中是怎么具體發(fā)揮作用的，是具體怎么使用的。

Ajax 的定義
Ajax 是異步的 javascript 和 xml 的簡稱，它其實是老技術(shù)的一個新組合，因為 javascript 和 xml 都不是新技術(shù)，但是 ajax 的應(yīng)用卻給 web 應(yīng)用帶來了很多新的變化。

在 .net 中實現(xiàn) ajax, 基本原理
在 .net 中有一個函數(shù)可以使用客戶端的腳本調(diào)用服務(wù)器端指定的函數(shù)。也就是通過這個方法才實現(xiàn)了 .net 中頁面的無回調(diào)刷新的。

public string GetCallbackEventReference (Control control,string argument,string clientCallback,string context)
參數(shù)：
control 處理客戶端回調(diào)的服務(wù)器 Control 。該控件必須實現(xiàn) ICallbackEventHandler 接口并提供 RaiseCallbackEvent 方法。
argument 從客戶端腳本傳遞一個參數(shù)到服務(wù)器端的 RaiseCallbackEvent 方法。
clientCallback 一個客戶端事件處理程序的名稱，該處理程序接收服務(wù)器端事件返回的結(jié)果。
context 啟動回調(diào)之前在客戶端的客戶端腳本信息。腳本的結(jié)果傳回給客戶端事件處理程序。
返回值 調(diào)用客戶端回調(diào)的客戶端函數(shù)的名稱。
返回服務(wù)器端的響應(yīng)函數(shù)是沒有選擇的。必須是服務(wù)器端的 RaiseCallbackEvent ，因此當(dāng)一個頁面中有多個地方需要回調(diào)的時候，就需要使用參數(shù)來區(qū)分。
客戶端的響應(yīng)函數(shù)使用 javascripts 來寫，沒有什么問題，在這里把返回的結(jié)果刷新出來。
服務(wù)器端的實現(xiàn)代碼放在 RaiseCallbackEvent 中，也沒有什么問題。
還有一個問題就是 GetCallbackEventReference 這個函數(shù)放在哪里，
一個位置是放在 page_load 中，
m_copyrightCallback = Page.ClientScript.GetCallbackEventReference(Page, "argument" , "processCallbackResult" , "context" , true );
另一個就是直接放在客戶端的事件當(dāng)中。

<%=ClientScript.GetCallbackEventReference( this , "imagechange" , "ShowServerTime2" , null ) %>

下面這個圖示中就放在了 GetServerTime 這個客戶端事件腳本中，下面這個圖很好的說明了這整個過程，從這個過程中，大家并沒有看到 GetCallbackEventReference 這個函數(shù)，而是 WebForm_DoCallback 函數(shù)，大家只要理解為 WebForm_DoCallback 是更底層的一個實現(xiàn) ajax 的回調(diào)的函數(shù)就可以了。
理解 ajax 的基本原理，才能較好的理解 ajax 在 arcgis server.Net 中的應(yīng)用。

ArcGIS Server .Net ADF中的AJAX(二)

Ajax 在 ArcGIS Server 中的應(yīng)用也是遵循基本的那幾個步驟，但為什么使用起來的時候好像感覺摸不著頭腦了呢？因為 .net ADF 提供了一個比較統(tǒng)一的框架，就把最基本的一些函數(shù)進(jìn)行了包裝，根據(jù)自己的模式提供了統(tǒng)一的入口和模式。但是只要再往下推敲幾步就會發(fā)現(xiàn)熟悉的 ajax 的步驟了。這可能會讓你在開始使用的時候會有些糊涂，但也正是這種統(tǒng)一的入口和模式讓我們的工作變得簡單。 ArcGIS Server .Net adf 提供了各種控件，這些控件里面都集中了復(fù)雜的功能，它們的刷新（比如地圖的放大縮小，移動等等）都不是簡單的幾句 javascripts 能夠完成的。這也就是為什么它提供了統(tǒng)一的入口和模式的原因了， web adf 已經(jīng)幫你寫好了很多的響應(yīng)的 javascripts 的代碼。你只需要按照相應(yīng)的格式把刷新請求字符串返回客戶端的相應(yīng)函數(shù)， adf 提供的豐富的各種控件的刷新 javascripts 就能夠幫你完成相應(yīng)的刷新操作。但是盡管如此，你仍然有必要了解整個的過程。 1 在工具中使用 ajax ，這是最基本的模式 其中一種最常見的統(tǒng)一模式就是在工具中使用 ajax 了。 自定義工具大家都知道怎么實現(xiàn)了，有很多文檔說明，大家都會在自定義工具的 SeverAction 類中來寫很多功能，然后需要把結(jié)果返回到客戶端去，那么這個過程中就會用到 ajax ，實現(xiàn) ajax 的整個流程過程參見圖 7-2 請仔細(xì)看附圖， 1 頁面加載以后，客戶會在 map 上做操作，比如畫矩形框，那么程序執(zhí)行客戶端的操作，比如 dragrectangle ，那就會激發(fā) javascripts 目錄下面的 MapMouseDown 函數(shù)，這個函數(shù)會開始繪制 rectangle ，在這個函數(shù)中，會去執(zhí)行 postback 函數(shù)。 2　 postback 函數(shù)中會執(zhí)行 webForm_DoCallback 函數(shù)，這個函數(shù)把相應(yīng)的請求發(fā)回到服務(wù)器端， WebForm_DoCallback('Map1',argument,processCallbackResult,context,postBackError,false) 3?? 到服務(wù)器端之后首先執(zhí)行的是 map 控件的 RaiseCallbackEvent 函數(shù)， 4? ? 進(jìn)而會去調(diào)用用戶自己寫的工具的 ServerAction 函數(shù)，并把相應(yīng)的返回字符串返回到客戶端的 processcallbackresult ．函數(shù)中，字符串類似于： Map:::Map1:::changelevel:::-1:::1:::1:::0:::0:::0:::0:::709:::389:::-1:::0:::0 5??這個過程到這里是不是完畢了呢，其實還沒有，因為這個時候刷新的操作提示還沒有做完， processcallbackresult 函數(shù)中還會有執(zhí)行很多的 javascripts 函數(shù)，這些函數(shù)中還會嵌套有 ajax 的回調(diào)。但這個過程是最基礎(chǔ)的過程。嵌套 ajax 的調(diào)用都只是重復(fù)這些步驟，然后調(diào)用的客戶端的腳本函數(shù)和服務(wù)器的執(zhí)行函數(shù)略有不同而已。 ? ? 在上面的步驟中很多都是不需要我們進(jìn)行干預(yù)的，所以我們只需要關(guān)心我們要做的事情就可以了，我們要做的就是 ServerAction 函數(shù)的功能，如果 ServerAction 中的功能都只是更新服務(wù)器端的內(nèi)容，那就簡單了，只需要使用 ao 組件進(jìn)行執(zhí)行就可以了，但是如果需要在 ServerAction 之后刷新客戶端的內(nèi)容的話，這個時候就需要注意了，千萬不要忘記要把相應(yīng)的字符串帶到原來制定好的客戶端的腳本中去。否則即使服務(wù)器的內(nèi)容都已經(jīng)更新了客戶端卻什么反應(yīng)都沒有了。 無論是客戶端要刷新 arcgis server 的控件還是其他的控件，要返回的字符串都是 map. CallbackResults 中的字符串。因此需要你把想要更新到客戶端的東西就都添加到 map.CallbackResults 里面去，否則無論你在服務(wù)器端做了什么客戶端都看不到結(jié)果。很多人都不會忘記在服務(wù)端做工作，完成應(yīng)該完成的事情，但是卻容易忘記把相應(yīng)的刷新字符串傳到客戶端。因為 b/s 的應(yīng)用和 c/s 應(yīng)用比起來，流程要復(fù)雜一些。 那么這里最重要的一個問題就是，需要把什么內(nèi)容添加到 map.CallbackResults 中去呢。答案是一個字符串。 那么首先我們來看看字符串的解析函數(shù)，其次來看看構(gòu)造這個字符串的規(guī)則。 1 ） 通過 Ajax 返回到客戶端的字符串的響應(yīng)函數(shù)詳解 要在工具的 ServerAction 中通過 ajax 技術(shù)來在客戶端來刷新 adf 中的 webcontrols ，那么返回字符串的第一個客戶端的響應(yīng)函數(shù)都是 processcallresult 。該函數(shù) C:/Inetpub/wwwroot/aspnet_client/ESRI/WebADF/JavaScript 中的 display_dotnetadf.js 中。只有了解了這個函數(shù)是怎么來解析字符串的，我們才能知道我們應(yīng)該怎么給這個字符串。 先說刷新 arcgis server 提供的控件， 先舉一個例子，對 Map 控件進(jìn)行一個放大操作，最后返回到 processcallresult 的 string ： "Map:::Map1:::changelevel:::-1:::1:::1:::0:::0:::0:::0:::709:::389:::-1:::0:::0^^^Map:::Map1:::cleargrid" ^^^ 是操作分割符號， ::: 是參數(shù)分割符號， Processcallresult 函數(shù)中的解析代碼 var ov2 = null; // 分割獨(dú)立的操作 var pairs = response.split("^^^"); var actions; var o; var action; var c; var c; var resp; var validResponse = false; for (var i=0;i<pairs.length;i++) { // 進(jìn)行參數(shù)的分割，并進(jìn)行分析 actions = pairs .split(":::"); responseItem = pairs ; if (responseItem==null || responseItem.length==0) continue; controlType = actions[0].toLowerCase(); controlID = actions[1]; action = actions[2].toLowerCase(); switch (controlType) { case "map": map2 = Maps[controlID]; if (action=="changelevel") {……………………..} ………………………………… } 如果是刷新其他的asp.net的控件的話，情況就又不一樣了。Processcallbackresult函數(shù)中有下面的解析代碼，總體來說，刷新其他的asp.net的控件就直接把新的Html賦給相應(yīng)的控件就可以了。如果傳回來的是一串Javascrpts的話，就是讓它直接運(yùn)行就可以了。 ? ? ArcGIS Server .Net Web ADF的AJAX(二)續(xù) 2） 構(gòu)造返回字符串的規(guī)則 當(dāng)然除了研究Processcallbackresult這個函數(shù)來確定我們應(yīng)該怎么來構(gòu)造返回的字符串之外，ESRI也給出了相應(yīng)的說明，見下表。 如果是刷新adf提供的webcontrols的內(nèi)容的話，那么字符串的構(gòu)建就比較簡單，都是通過webcontrol自動生成的，但是如果刷新的內(nèi)容普通的asp.net控件的話，那么就需要按照需求手動來構(gòu)造返回字符串，如果返回的是javascript的話也是一樣的。下面是如果返回的參數(shù)是用來刷新普通的asp.net控件或者是Javascripts的話，會要求使用到下面的幾類參數(shù)： “ content" Used to set the outerHTML property of an html element. The html element on the client defined by the CallbackResult 抯 controlType and controlID is completely replaced by the html content provided as a parameter in the object array (object[]). "innercontent" Used to set the innerHTML property of an html element. The content inside the html element on the client defined by the CallbackResult 抯 controlType and controlID is completely replaced by the html content provided as a parameter in the object array (object[]). "image" Used to set the src property of an image element. The source of the image element on the client defined by the CallbackResult 抯 controlType and controlID is changed to the url string provided as a parameter in the object array (object[]). "javascript" Used to execute JavaScript on the client. The CallbackResult 抯 controlType and controlID and set to null. The JavaScript code is provided as a parameter in the object array (object[]). Conent是返回設(shè)置給html控件的outerhtml屬性。 Innercontent是返回給html控件的innerhtml屬性。 Javascrpt是返回一段javascripts. 從上面的構(gòu)造字符串中可以看出，返回到客戶端的字符串可以用來刷新一個控件，也可以是直接返回一段javascript,這樣我們就可以很靈活的來控制客戶端的一些界面，對于content或者innercontent的內(nèi)容的構(gòu)造一般都是通過控件直接生成的，而javascriptes一般都是直接在函數(shù)中自己構(gòu)造的。 下面是在具體使用過程中的經(jīng)常會涉及到的兩個例子，也就是要在自定義的工具中要實現(xiàn)的ajax刷新的代碼例子。 1 在map刷新的同時也刷新其他的arcgis server的web控件， 下面是刷新toc控件的相關(guān)代碼， ESRI.ArcGIS.ADF.Web.UI.WebControls.Toc toc1 = (ESRI.ArcGIS.ADF.Web.UI.WebControls.Toc )map.Page.FindControl("Toc1" ); toc1.Nodes.Clear(); toc1.Refresh(); string aaa = toc1.CallbackResults.ToString(); CallbackResult tocstring = new CallbackResult ("TOC" , "Toc1" , "content" , aaa); map.CallbackResults.Add(tocstring); 2 在map刷新的同時也刷新其他的asp.net的控件，下面是一段例子代碼，刷新的是一個div控件 DataTableCollection dtc = dataset.Tables; string returnstring = string .Empty; foreach (DataTable dt in dtc) { if (dt.Rows.Count == 0) continue ; GridView gd = new GridView (); gd.ToolTip = dt.TableName; gd.Caption = dt.TableName; gd.DataSource = dt; gd.DataBind(); gd.Visible = true ; gd.BorderWidth = 10; using (System.IO.StringWriter sw = new System.IO.StringWriter ()) { HtmlTextWriter htw = new HtmlTextWriter (sw); gd.RenderControl(htw); htw.Flush(); returnstring = returnstring + sw.ToString(); } } CallbackResult cr = new CallbackResult ("div" , "datadiv" , "innercontent" , returnstring); map.CallbackResults.Add(cr); ArcGIS Server .Net ADF中的AJAX(三) 直接在頁面中使用ajax來刷新arcgis server的控件 這種情況的執(zhí)行思路和原理看附件流程圖 這種情況下也會有刷新arcgis server控件和普通的asp.net兩種情況，這兩種情況的區(qū)別和上一節(jié)的內(nèi)容一樣。 圖7-3 1 ） 直接在map的客戶端事件中來實現(xiàn)arcgis server的ajax刷新 protected void Map1_DragRectangle( object sender, ESRI.ArcGIS.ADF.Web.UI.WebControls. ToolEventArgs args) { ? ??? CallbackResult cr = new CallbackResult ( null , null , "javascript" , "showFloatingPanel('FloatingPanel1')" ); ? ???Map1.CallbackResults.Add(cr); } 2 ） 直接在html的控件的事件中來使用ajax進(jìn)行刷新，這種情況下客戶端的響應(yīng)函數(shù)是processCallbackResult，服務(wù)器端的處理函數(shù)是page的RaiseCallbackEvent函數(shù)。 function Button2_onclick() { ? ???eval( "WebForm_DoCallback('__Page','jintian', processCallbackResult,'jintian',null,true)" ); }

總結(jié)

以上是生活随笔為你收集整理的Esri中国社区 » GIS大讲堂：ArcGIS Server .Net ADF中的AJAX的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。