本文以 DB2 for Linux、UNIX and Windows V9.5 與 IBM Database Add-Ins for Visual Studio 2005 V9.5 為基礎,說明 .NET 開發人員如何借助 Visual Studio 工具完成 XML 模式標註、註冊、比較、Web 方法產生與範例程式碼生成。這些工具把 DB2 的 pureXML 能力帶進日常開發流程,讓 XML 資料的設計、驗證與服務封裝更直覺。
若要跟著本文操作,請準備 DB2 V9.5 用戶端與資料庫環境,並安裝 IBM Database Add-Ins for Visual Studio 2005 V9.5。安裝完成後,就能在 Visual Studio 的 Server Explorer 中看到 XML Schema Repository 等節點。
DB2 從 9.1 版開始提供原生 XML 資料型別、SQL/XML 查詢能力與模式驗證機制。到了 V9.5,這些能力進一步與 Visual Studio 整合,讓開發人員可以用圖形化方式標註 XML 模式、建立 Web 服務,並管理 XML Schema Repository。
新版本允許直接以 Web 服務作為 XML 模式來源。過去只能使用已註冊的 XML 模式或檔案,現在可以從 WSDL 推導模式結構,再指定要對應的資料表。
操作時,先在 Server Explorer 中右鍵點選 XML Schema Repository,選擇 Add Annotated XML Schema。
圖 1:新增標註 XML 模式
在對話框中選擇 Use document from a web service,即可把 Web 服務定義作為輸入。
圖 2:選擇 XML 模式來源
輸入 Web 服務後,可按 Validate wsdl 驗證服務描述,再選擇要作為根節點的元素。
圖 3:選擇根元素
接著右鍵新增目標資料表,讓 XML 模式中的資料能對應到資料庫欄位。
圖 4:新增目標資料表
在 Mapping Editor 中,可將來源 XML 模式的結構映射到目標資料表的欄位。
圖 5:映射欄位
完成映射後,可用 Test 功能檢查設計是否正確。
圖 6:檢查設計
若需要檢視背後產生的程式碼,可用 View Source 開啟文字編輯器或 XML 設計工具。
圖 7:檢視來源程式碼
系統會依設定產生對應程式碼,供開發人員後續調整或整合。
圖 8:產生的程式碼
測試時可指定 XML 輸入,或直接在測試表單中編輯內容,再觀察驗證與轉換結果。
圖 9:測試視窗
設計確認無誤後,可在 Visual Studio 中選擇 Save,將標註 XML 模式儲存並註冊到資料庫。
圖 10:註冊標註 XML 模式
註冊時可設定 XSR 名稱、所有者、說明、模式位置與分解選項。
完成後,Server Explorer 的 XML Schema Repository 節點會顯示新的模式,並可從右鍵選單開啟定義。
圖 11:Server Explorer 中的標註 XML 模式
開啟定義後,可檢視 XML 模式檔名、XSR 名稱、所有者、分解設定與相依關係。
圖 12:檢視標註 XML 模式定義
V9.5 新增 Compare XML Schemas 功能,可比較兩個 XSR 物件,並在操作過程中提示差異。這對追蹤 XML 模式變更特別有幫助。
圖 13:XML Schema Repository 比較
在 XSR Object Compare 對話框中,可選擇原始 XSR 物件、其相依物件,以及要比較的另一組 XSR 物件。
圖 14:選擇要比較的 XSR 物件
若物件包含相依文件,每次只能選擇一份文件進行比較。下拉選單會列出所有已註冊模式。
Diff 按鈕可調整比較選項,例如忽略註解。
圖 15:XSR Object Compare 選項
比較結果會以顏色標示新增、刪除、修改、移動與忽略等差異。
圖 16:XSR 比較結果
若兩個 XSR 在指定選項下完全相同,系統會顯示檔案相同的提示。
標註 XML 模式在 DB2 XSR 中註冊後,可用於分解與驗證 XML 文件。V9.5 進一步允許從 Server Explorer 選擇 Generate Web Method,把 XML 驗證能力封裝成 ASP.NET Web 服務。
圖 17:產生 Web 方法
產生的程式碼會顯示在編輯器中,內容與 XML 設計工具使用的驗證邏輯相近。
圖 18:產生的 Web 方法
可按 F5 啟動測試,瀏覽器會顯示服務描述與相關方法。
圖 19:測試產生的程式碼
Generate XML Helper Code 會在 Solution Explorer 中建立一個包含範例程式碼的專案,方便開發人員作為起點。
圖 20:產生範例程式碼
產生的程式碼會加入新專案,內容涵蓋 XSL Transformation 與驗證範例。
圖 21:產生的範例程式碼
執行範例時會出現對話框,可測試 XML 轉換與驗證。
圖 22:產生的對話框
按下 Validate Sample 可檢視驗證結果,按下 Transform Sample 則可看到格式化後的報告。
IBM Database Add-Ins V9.5 把 DB2 pureXML 的關鍵能力整合到 Visual Studio 開發經驗中。從標註 XML 模式、比較 XSR、產生 Web 方法,到輸出可直接修改的範例程式碼,這些工具讓 .NET 開發人員能更有效率地建置以 XML 為核心的應用程式。