作者:Dflying Chen ( http://dflying.cnblogs.com/ )
在前一篇文章(在ASP.NET Atlas中呼叫Web Service-建立Mashup呼叫遠端Web Service(基礎知識以及簡單範例))中,我介紹了一些Atlas中對遠端Web Service進行Mashup的基礎知識,並給了一個最基礎的沒有絲毫用處例子。今天再回到這個主題上,我將給出一個更複雜點的,但有一些用處的例子——Yahoo! Weather。
廢話到此為止,讓我們先熟悉一下Yahoo! Weather服務:Yahoo!在其網站上提供了天氣預報服務( http://weather.yahoo.com/ ),並且它也提供了Web Service的介面( http ://developer.yahoo.com/weather/ )
從上面兩個網頁上面,我們可以知道Yahoo!提供的天氣Service的URL為http://xml.weather.yahoo.com/forecastrss ,該服務還有兩個參數:
p:要查詢天氣的地點代碼(可以在http://weather.yahoo.com/查詢到不同地方的這個程式碼)。
u:回傳結果中溫度的單位,f代表華氏度,c代表攝氏度。
看來這個Yahoo! Weather服務還蠻簡單的,讓我們測試下好不好用。先到http://weather.yahoo.com/查出來上海的地點代號為CHXX0116。然後在瀏覽器中輸入http://xml.weather.yahoo.com/forecastrss?p=CHXX0116&u=c ,嗯,回傳瞭如下的一段不是很複雜的XML:
Yahoo Weather Service XML Result
http://us.rd.yahoo.com/dailynews/rss/weather/Shanghai__CH/*http://xml.weather.yahoo.com/forecast/CHXX0116_c.html
http://weather.yahoo.com/
http://us.rd.yahoo.com/dailynews/rss/weather/Shanghai__CH/*http://xml.weather.yahoo.com/forecast/CHXX0116_c.html
" />
Current Conditions:
Fog, 21 C
Forecast:
Thu - Scattered Thunderstorms. High: 25 Low: 20
Fri - AM Showers. High: 26 Low: 18
Full Forecast at Yahoo! Weather
(provided by The Weather Channel)
]]>
我們可以看到,它提供的資訊非常全面(連日出日落時間都有…) ,下面讓我們書寫asbx Bridge頁面來對這個Service進行Mashup。
首先,參考在ASP.NET Atlas中呼叫Web Service-建立Mashup呼叫遠端Web Service(基礎知識以及簡單範例)這篇文章中的那個asbx的聲明,我們可以寫出如下一段:
其中:
GetWeather方法中定義了上面列出來的p和u兩個參數,其中u參數我們指定了它的預設值為c(代表攝氏度),p參數將由呼叫者負責傳過來。
寫到這一步驟其實也夠了,客戶端將會收到上面瀏覽器中看到的那一段XML String,並且可以在客戶端處理並顯示。但客戶端對XML的處理並不是那麼容易,也不是那麼高效,同時透過網路傳輸太多不必要的資訊也是一種浪費。所以這裡我們利用asbx中內建的Transformer對這段XML處理一下,提取出我們感興趣的內容並以JSON的形式發給客戶端。在
其中
name為selector的attribute段,其中指定的value屬性為XPath表達式,將選取整個XPathBridgeTransformer將使用到的資料段。
name為namespaceMapping的一個dictionary段,其中指定了這個XML檔案中的namespace映射。如果在下面的選擇節點過程中我們用到了某個namespace,那麼這裡就必須有它的宣告。這裡我們在其中加入一個對yweather的映射,因為下面要用到。
name為selectedNodes的一個dictionary段,其中每一個item的value屬性是一個XPath String,用來從XML中選擇對應的值,name屬性用來指定對應的在JavaScript中的屬性名稱。這裡作為範例,我只取得其中三段內容,你可以看到,其中CurrentCondition的XPath中使用了上面指定的namespaceMapping。
關於XPath的知識,我就不多講了,有興趣或是不太熟悉的朋友可以自行Google,網路資源很多。關於其他類型的Transformer,我也不是很熟悉,今後如果遇到了我再講講。完成後的YahooWeatherBridge.asbx檔案如下:
現在建立一個ASP.NET Page測試一下,首先依然是重複了一千遍的ScriptManager,還有對Bridge的引用:
然後一個HTML Select元素,裡面列入了幾個城市以及相應的城市代碼:
一個HTML Button,用來觸發對Service的呼叫:
一段HTML用來顯示結果:
然後是JavaScript,可以看到透過Dflying.YahooWeatherService.GetWeather()呼叫了Mashup,並在方法返回後把經過transform的值輸出到了頁面上: function getWeather_onclick() {
// new atlas 'Select' control
var place = new Sys.UI.Select($('place'));
// invoke the bridge method
Dflying.YahooWeatherService.GetWeather({'p': place.get_selectedValue()}, onGetComplete);
}
function onGetComplete(result) {
$('result').style.display = "block";
$('title').innerHTML = result[0].Title;
$('description').innerHTML = result[0].Description;
}