這份實驗說明如何在 WebSphere Studio Application Developer(WSAD)中,把關聯式資料庫的結構匯入工作台,設計 SQL 查詢並直接產出 XML 結果,最後再用映射精靈把資料轉成另一套 XML 格式。
XML 出現在越來越多的應用當中。由於格式公開、不受特定廠商拘束,XML 很適合在應用程式之間描述與交換資料;而大多數應用的資料仍以某種形式保存下來,其中最常見的載體就是關聯式資料庫。一端負責儲存,一端負責表達,兩種技術之間自然形成一道橋樑。
WSAD 同時具備關聯式資料庫設計工具與 XML 編輯工具,既能處理既有的資料庫結構,也能建立新的結構。本實驗會用到其中的 XML 工具,以及「資料」視角(Data Perspective)的若干功能。
需事先安裝 DB2 7.2 與 WSAD,並建立 Invest 資料庫(執行 c:\yourbank\lab5\DBSetup.bat),實驗用到的原始碼需放在 c:\yourbank\lab5。
連線到一個運作中的資料庫並把結構匯入 WSAD;為資料表加上外部鍵;用 SQL 語句精靈跨多個資料表建立查詢;用 XML to SQL 精靈查詢資料庫並以 XML 文件形式取回結果;最後用 XML to XML 映射精靈把結果轉換成另一種 XML 格式。
Invest 資料庫有三張表,分別存放客戶的持股資訊與聯絡資訊。要在應用程式中使用這些資料,得先連線資料庫並把結構匯入 WSAD。取得結構之後,你會把 ADDRESS 表關聯到 PERSONALINFORMATION 表,接著建立一個 SQL SELECT 語句取出所有客戶地址資訊,在資料視角中執行它並以 XML 取得兩位客戶的資料,最後用 XML to XML 映射精靈把客戶資訊對應到一份 statement DTD。
※ 解答說明位於第五部分末尾。
1. 若尚未建立 Invest 資料庫,開啟 DB2 命令視窗(Start → Programs → IBM DB2 → Command Window),執行 C:\YourBank\Lab5\DBSetup.bat,於提示時輸入密碼 PASSWORD。
2. 在 WSAD 中開啟資料視角:Perspective → Open → Other...,選擇 Data,按下 OK。
3. 建立資料庫連線:在 DB Explorer 視圖中按右鍵選 New Connection...,將連線名稱設為 Invest DB Connection、資料庫設為 Invest,User ID 與密碼分別輸入 USERID 與 PASSWORD,其餘保留預設值後按 Finish。
4. 建立存放用的專案:File → New → Project...,選 Simple 與 Project,名稱輸入 InvestDatabase,按 Finish。專案會在資源視角中建立,完成後關閉資源視角。
5. 回到資料視角並確認 DB Explorer 視圖開啟,展開 Invest DB Connection,對 Invest (jdbc:db2:Invest) 按右鍵選 Import to Folder...,按 Browse 選取 InvestDatabase 專案後 OK,再按 Finish。Invest 的結構資訊便匯入了專案。
1. 在資料視角中切換到導覽器視圖(Navigator)。
2. 展開 InvestDatabase,雙擊 Invest_DB_Connection_Invest_USERID_ADDRESS.tblxmi。
3. 點選 Foreign Keys 頁籤,按 Add another。
4. 在 Target Table 欄位按 Browse...,展開 InvestDatabase → Invest (DB2 UDB, V7.2) → USERID → Tables,選擇 USERID.PERSONALINFORMATION 後按 OK。
5. 按 >> 按鈕把 MEMBERID 欄位移到右側窗格。這會建立本表 MEMBERID 欄位與 PersonalInformation 主鍵之間的關聯。
6. 儲存並關閉檔案。
1. File → New → Other...,選擇 Data 與 SQL Statement,按 Next。
2. 精靈會引導你建立 SELECT 語句。SQL 語句必須參照一份既有的結構,你可以在 Database Model 欄位右側按 Browse...,展開 InvestDatabase 並選取 Invest (DB2 UDB, V7.2),按 OK。這裡使用第一部分匯入的結構。
3. 在 SQL Statement Name 欄位輸入 customerinfo,按 Next。
4. 在 Tables 頁籤中展開 DB2ADMIN 結構與 Tables 資料夾,分別選取 USERID.ADDRESS 與 USERID.PERSONALINFORMATION,各按 > 移入右側清單。這兩張表將共同構成查詢的基礎。
5. 切到 Columns 頁籤指定要取回的欄位:從 USERID.PERSONALINFORMATION 選 FULLNAME、SSN、MEMBERID;從 USERID.ADDRESS 選 ADDRESS、CITY、STATE、POSTALCODE。注意不要再選一次 MEMBERID。
6. 切到 Joins 頁籤指定關聯條件:從 Address 表的 MEMBERID 拖曳到 PersonalInformation 表的 MEMBERID 後放開滑鼠,兩表之間的連接線會在拖曳過程中即時呈現。
7. 按 Next,畫面會顯示產生的 SQL 原始碼,你可以在這裡做必要的手動調整,然後按 Finish。
完成後,invest_customerinfo.sqx 會出現在 InvestDatabase 專案中。你可以直接開啟這個檔案,透過介面或直接編輯 SQL 來修改語句。
1. 開啟剛才建立的 invest_customerinfo.sqx。
2. 在 Outline 視圖中對 customerinfo 按右鍵,選擇 Generate new XML...。
3. 選取 DTD 單選鈕,其餘維持預設後按 Finish。此舉會在 InvestDatabase 專案中產生 customerinfo.dtd、customerinfo.html、customerinfo.xml、customerinfo.xsl 與 customerinfo.xst。
打開 customerinfo.html,你會看到表格形式的查詢結果,資料來源正是資料庫。看完後關閉檔案。
customerinfo.xml 則是同一批資料的 XML 呈現形式,而且連定義檔也一併備妥。有了這組組合,你就能把資料庫中的資訊直接放進應用程式使用,因為轉成 XML 幾乎不費力。
情境是這樣的:投資對帳單每月寄發,客戶資訊與投資摘要會印在報表上交寄客戶,而報表版面要求客戶資訊必須是特定的 XML 格式。你要做的,就是把 customerinfo 查詢取得的客戶資訊,映射到對帳單的 XML 格式。
1. 先建立存放結果的專案:File → New → Project,選 Simple 與 Project,名稱輸入 StatementXML,按 Finish。
2. 匯入 statement.dtd(定義客戶資訊的結構):File → Import,選 File System 後 Next,按 Browse 定位到 c:\yourbank\lab5\statement.dtd,在 lab5 資料夾前方的方框按兩下以選取它,取消勾選 DBSetup.bat,按 OK;接著在 Folder 欄位按 Browse 選取 StatementXML,按 Finish。
3. 定義檔就位後即可開始映射:File → New → Other...,選 XML 再選 XML to XML Mapping,按 Next。
4. 在 New XML to XML Mapping Session 視窗中選取 StatementXML,按 Next。
5. 在 Source XML or DTD Files 視窗中展開 InvestDatabase,把 customerinfo.xml 用 > 移入右側。你也可以同時選多份文件,實現多份 XML 對一份定義的映射。按 Next。
6. 在 Target XML or DTD File 視窗中展開 StatementXML 並選取 statement.dtd(選 customerinfo.dtd 亦可),按 Next,再按 Finish。
7. 映射檔 XMLmap.xmx 會在編輯器中開啟。展開 customerinfo → SQLResult → ADDRESS_PERSONALINFORMATION 查看來源端的元素;在目標端展開 statement → StatementAddress,以及 AccountInfo 與 Contact。
8. 把下列元素從來源拖到目標,每完成一次映射,Outline 視圖都會同步更新:
|來源元素|目標元素|
|ADDRESS|AddressLine|
|CITY|City|
|STATE|State|
|POSTALCODE|Zip|
|FULLNAME|LastName|
|FULLNAME(再次)|FirstName|
|SSN|TaxID|
|MEMBERID|AccountNumber|
9. LastName 目前對應到一個形如「lastname, firstname」(例如 Doe, John)的屬性值,因此要額外定義映射才能只取出姓氏:在目標端對 LastName 按右鍵選 Define XSLT Function...,在視窗中保留 String 並按 Next,函數名稱選 substring-after;按 Add 開啟值對話框,於參數欄位輸入 ' '(單引號、一個空格、單引號),按 OK,再按 Finish。
10. FirstName 的處理方式相同,只是函數改為 substring-before,參數同樣是 ' '。完成後儲存映射檔。
11. 點工具列最右側的 Generate XSLT script for mapping 按鈕,選擇 StatementXML,檔名維持 statement.xsl,按 Finish。產生的 statement.xsl 會加入 StatementXML 專案。
12. 在導覽器視圖中,按住 Ctrl 同時選取 InvestDatabase 專案裡的 customerinfo.xml 與 XMLStatement 專案裡的 statement.xsl,按右鍵選 Apply XSL → As XML。
13. 套用 XSL 之後,customerinfo.xml 被轉換成 Result XML。你會看到來源檔中的值如何被搬進目標元素,其中 FULLNAME 的值已被拆成 LastName 與 FirstName 兩部分。
14. 此時你也可以追蹤整個轉換過程:確認已選取 XSL Trace Editor 視圖且 XSL Trace 選單可用,從選單中選 Trace forward 開始逐步追蹤(工具列上的 Trace forward 按鈕亦可)。反覆前進數次後再按 Trace backward,你會看到 XML 檔中對應的映射行與 XSL 檔中執行轉換的那一行被反白標示。
15. 最後再次同時選取 customerinfo.xml 與 statement.xsl,按右鍵選 Apply XSL → As HTML,XSL Trace Editor 會再次開啟並以 HTML 顯示結果。
你透過資料視角連上運作中的資料庫,把結構匯入 WSAD;在其中一張資料表上建立了外部鍵;接著建立跨兩張表的 SQL SELECT 語句並以 XML 取回結果;最後用 XML to XML 映射精靈,把查詢回傳的 XML 對應到另一份 XML 定義。
若想跳過前面的實驗直接執行本實驗,可依序完成:執行 C:\yourbank\solutions\lab1Cfg\Lab1.bat(在 DOS 視窗輸入或雙擊),它會開啟 DB2CMD 視窗並執行 cfgdb.bat;匯入伺服器組態(File → New → Project... 選 Server 與 Server Project,專案名 TestServer;File → Import 選 Zip file,定位 C:\YourBank\Solutions\Lab1\TestServers.zip,資料夾名輸入 TestServer 後 Finish);在 Application Developer 中匯入 EAR(File → Import 選 EAR file,定位 c:\YourBank\Solutions\Lab2\YourBankAfterLab2.ear,企業應用專案名設為 YourBankEAR);在導覽器視圖中對 YourBankWebModule 與 YourBankEJBModule 分別按右鍵選 Properties → Server Preferences → YourBankServer,按 Apply 再按 OK;最後在 DB2 命令視窗執行 c:\YourBank\Lab5\DBSetup.bat。
※ 匯入的測試伺服器假設使用預設目錄結構。若你的目錄結構與預設不同,需依 Lab 1 第三節的說明手動設定伺服器。
※ 原始教材 © Copyright IBM Corporation 2001,出自 IBM WebSphere Studio Application Developer Workshop 實驗 APPDEVL5。