作者:unknown 來源:網際網路
從複雜B2B交易中交換資料,到為應用程式提供設定檔結構,XML已經在無數場景中大顯身手。隨著軟體對XML的支援日益普及,我們可以預見它的應用只會越來越廣泛。本文要介紹的正是這樣一個實例:運用XML打造一套類似Windows「開始」選單的多層選單系統,為使用者帶來更順手的網頁操作體驗。
(一個三層選單系統,可點擊放大)
這套應用程式採用C#、XML與伺服器端Microsoft .NET Framework,生成一段DHTML結構,供IE4及更高版本的瀏覽器在客戶端動態渲染。由於伺服器上的XML能被快速存取,而XML天生擅長描述階層之間的關係,因此用來標記「父/子選單」資料再合適不過。
除了動手實作選單應用程式,本文也會帶大家認識.NET Framework中位於System.Xml組件(Assembly)內的主要XML類別。
要在C#檔案中使用XML,就必須引用對應的名稱空間。.NET平台裡的每個名稱空間都作為一個組件的組織系統而存在,這在解決命名衝突上至關重要,其概念與XML中的名稱空間頗為相似。這套以XML為基礎的選單系統,正是建立於System.Xml組件所提供的System.Xml名稱空間之上。依.NET SDK的定義,組件是型別與資源的集合,這些類別與資源共同構成一個功能上的邏輯單元,也就是所謂的「邏輯」DLL。
一個組件往往需要多個實體檔案,例如介面、類別、資源檔等,並透過中介資料描述它們彼此協作的規則;組件之中還可能包含版本與安全性資訊。組件的眾多好處之一,就是能在ASP.NET應用程式中直接使用,無須靠regsvr32.exe把類別識別碼(CLSID)寫進註冊表。如此一來,升級組件只需把對應檔案複製到ASP.NET應用程式的bin目錄即可,十分便利。
如果你曾使用過微軟的MSXML3解析器,就會發現System.Xml組件中的類別同樣容易上手。本選單應用只用到其中一部分主要類別:XmlNode、XmlDocument、XmlNodeList、XmlNamedNodeMap、DocumentNavigator、XmlTextReader與XmlTextWriter。
其中,XmlDocument、XmlNodeList與XmlNode用來建立傳送給客戶端瀏覽器的選單結構。XmlDocument能以執行緒安全(thread-safe)的方式從伺服器載入並解析本地或遠端XML文件,也能載入字串中的XML標記,進而在文件中建立、搬移或移除節點。XmlNodeList可列舉節點集合以存取名稱、值或名稱空間等特定屬性;XmlNode則用來在文件中為某個待檢驗的XmlNode物件指定節點。
XmlNamedNodeMap負責列舉元素類型選擇中的屬性集合。DocumentNavigator、XmlTextReader與XmlTextWriter則提供額外能力:DocumentNavigator可執行XPath查詢,並被納入XSLT轉換之中;XmlTextReader提供只向前(forward-only)、不快取的節點存取方式,使其同樣能勝任大型XML文件;XmlTextWriter則以快速、只向前的指標模型,將XML內容寫入資料流或檔案。
由於本應用程式所用的XML文件相對小巧,我們在伺服器端採用文件物件模型(DOM)來存取各節點即可。若是解析大型XML文件,就該改用XmlTextReader所提供的只向前模型。
選單應用共使用三份XML文件:menuItems.xml、menuItems2.xml與menuItems3.xml,分別標記各自的選單項目。XML的處理與操作交由名為XMLMenus.dll的組件完成,該組件被伺服器端的ASP.NET檔案createMenus.aspx呼叫。至於客戶端的動態HTML(DHTML)內容,則由一份層疊樣式表與一份JavaScript檔案共同生成本文開頭所示的效果。
用來標記各選單項目的XML文件片段如下:文件的主元素名為menuItem,可包含名稱與超連結元素,也能嵌套額外的menuItem子元素。這種關係正好能建構出帶子選單的選單系統,就像Windows的「開始」選單一樣。
由於XML已清楚標出階層關係,我們得以用迴圈在元素之間遊走:在透過XmlDocument、XmlNode與XmlNodeList建立子節點時,可反覆呼叫WalkTree()函式來展開父/子關係。其他如ArrayList與StreamWriter則用來把相關選單歸類到陣列中,再於適當時機把生成的選單結構寫入檔案。
XmlMenus組件的程式碼開頭先宣告XmlHierMenu名稱空間,接著引用System、System.Xml、System.Collections與System.IO等名稱空間:
using System;
using System.Xml;
using System.Collections;
using System.IO;
接著建立三個建構子:第一個不接收參數,僅做變數初始化;第二個接收自訂的圖片檔案路徑;最後一個則在選單不常更新的情況下,允許把組件輸出存成檔案,該檔案可被靜態包入ASP.NET檔案,而非每次頁面請求時即時生成。
建構子之後,便開始定義CreateMenu()方法。這個方法負責載入與解析XML文件、找到根節點,再於根的子節點之間迴圈。若發現某個子節點本身還有子節點,就呼叫WalkTree()並把這些子節點傳入;若它們仍有子節點,便再次呼叫WalkTree(),如此循環直到再也找不到更深的子節點為止。
在呼叫WalkTree()並分析各節點的同時,程式會解析menuItem節點,把它超連結與名稱節點的資料放進陣列。整份XML文件解析完畢後,陣列內容被回傳給呼叫的ASP.NET頁面,再由Response物件輸出。從此刻起,客戶端的JavaScript程式碼便接手控制DHTML選單。
伺服器端以一個ASP.NET頁面啟動選單建立流程,先輸入與組件相關的名稱空間XmlHierMenu:
<%@ page language="C#" %>
<%@ Import Namespace="XmlHierMenu" %>
接著在程式碼區包入樣式表與JavaScript檔案,最後於頁面底部的程式碼中呼叫前述的CreateMenu()與WalkTree()方法。ASP.NET頁面中的C#程式碼只負責設定通往各XML文件的路徑並例示XmlMenu類別;一旦完成例示,便呼叫CreateMenu(),傳入選單名稱與對應XML文件的路徑。本例建立了menu1、menu2、menu3三個選單並在同一頁面中使用。理論上一頁可支援無限多個選單,但每多一個選單,送往客戶端的檔案量就會增加,因此建議不要放太多。
看完結構後,接著談談用哪些編譯參數把C#檔案編譯成組件,完整的參數清單可查閱.NET SDK文件。
要正確編譯出能供ASP.NET頁面使用的C#檔案,編譯器必須知道要引用System.Xml組件,這可透過/r參數加上組件完整路徑來完成。由於要產出的是一個程式庫,因此還須加上/t參數,讓編譯器不去尋找靜態的Main()方法。最後再加上/out參數,告訴編譯器輸出的檔名與位置。
所有對C#編譯器的呼叫都以csc起頭,接著指定相應參數,最後一部分是已建立之.cs檔案的路徑。完整的編譯語法如下:
C:\>csc /r:System.Xml.dll /
t:library /out:d:\inetpub\wwwroot\
xml\bin\XmlMenus.dll d:\inetpub\
wwwroot\xml\menus\XmlMenus.cs
這行指令告訴編譯器:納入System.Xml組件、以程式庫方式編譯、輸出到bin目錄、輸入檔名為XmlMenus.cs、輸出檔名為XmlMenus.dll。按下Enter後,.cs檔案即完成編譯,生成的DLL會被放進正確的資料夾。
本文透過一個應用程式的思路與實作程式碼,讓我們對Microsoft .NET平台中的若干組件與類別有了具體認識。隨著學習深入,你會發現還有更多組件與類別,能以各種方式操作本地與遠端XML文件。