介紹
IBM WebSphere® Studio Application Developer 是一種應用程序開發產品，它支持用 JSP、servlet、HTML、XML、Web 服務、數據庫和 EJB 等不同的技術構建多種應用程序。Application Developer 還特別提供 XML 與關係數據的緊密集成。Application Developer 支持所有 WebSphere Application Server 支持的數據庫，其中包括 DB2®、Oracle Sybase 和 Microsoft® SQL Server™。
本文是關注於隨 WebSphere Studio Application Developer 提供的 XML 工具的系列文章的第 5 部分。 第 1 部分討論如何使用 WebSphere Studio Application Developer 開發 XML Schema； 第 2 部分演示如何使用 Application Developer 的 SQL Builder 創建 SQL 查詢； 第 3 部分討論 Application Developer 中可用來將數據訪問和 XML 結合到您的應用中的功能；而 第 4 部分探討的是創建和編輯 XML 文檔的可視化工具 XML Editor。
本文，即第 5 部分，主要介紹 RDB to XML Mapping Editor。RDB to XML Mapping Editor 允許用戶把 XML 數據映射成關係數據，反之亦然。然後該工具可以用於生成 DAD 文件，您可以一起使用它和 DB2 XML Extender 在 XML 文件裏檢索或存儲關係數據。
先決條件
爲了照着執行該示例，您需要已安裝下列產品：
- WebSphere Studio Application Developer 4.0
- DB2 UDB，版本 7.1 修訂包 3 或更新版本
- DB2 XML Extender，版本 7.2 修訂包 5
注：這些示例可以在 Windows® 或 Linux 操作系統上運行。
什麼是 DB2 XML Extender？
DB2 XML Extender 是對 DB2 的擴展，它提供存儲 XML 文檔或從現有的關係數據生成 XML 文檔的能力。DB2 XML Extender 還提供新的數據類型、函數和存儲過程以管理 DB2 中的 XML 數據。
有關 DB2 XML Extender 的更多信息，請參考 DB2 XML Extender Library。
什麼是 DAD 文件？
DAD（Document Access Definition，文檔訪問定義）文件是 XML 格式的文件，它把 XML 文檔結構關聯到 DB2 數據庫。DB2 XML Extender 使用 DAD 把 XML 數據合成或分解爲關係數據。想得到關於 DAD 文件及其特殊語法的更多信息，請參考 DB2 XML Extender Library。
爲什麼使用 RDB to XML Mapping Editor？
RDB to XML Mapping Editor 被設計成與 DB2 XML Extender 結合使用。通過採用如下技術，它使開發任務變得簡單：
- 提供可視化界面使您很容易就可以定義關係數據和 XML 元素及屬性之間的映射。
- 自動生成 DAD 文件，這些文件通常需要手工編碼，而且很容易出錯。
- 自動生成多種平臺上的測試功能庫，可用於 使 DB2 XML Extender 可以使用 DB2 數據庫，以及保存和檢索來自關係數據的 XML 文件。
DB2 XML Extender 與 SQL to XML 組件
在本系列的 第 3 部分中，我們曾介紹過 SQL to XML 嚮導及 WebSphere Studio Application Developer 中相應的 Java™ 庫。正如我們提到的，RDB to XML Mapping Editor 被設計成與 DB2 XML Extender 一起使用。但是，如果一個機構使用其它廠商的數據庫，SQL to XML 組件就提供了另外一種選擇。SQL to XML 組件支持目前 WebSphere Application Server 支持的所有 JDBC 數據庫。
RDB to XML Mapping Editor/DB2 XML Extender 和 SQL to XML 組件之間的主要區別是：RDB to XML Mapping Editor/DB2 XML Extender 在定義關係表和 XML 數據之間的映射結構時提供更多的靈活性。利用 DB2 XML Extender 和 Mapping Editor，您可以把任意的 SQL 查詢或多個表映射到 XML 文檔。在使用 SQL to XML 組件時，是按一組特定的映射模式嚴格的一對一映射。
擴展 Video Store 示例
本文中的示例是對以前的文章中音像店樣本的擴展。對於這個示例，我們感興趣的是檢索和存儲信息，這些信息是有關所有顧客（ Customer Id 和 Customer Name ）、每位顧客租的所有錄像帶（ Vid Id 和 Video Name ）以及租借每盤錄像帶的日期的。通過將 RDB to XML Mapping 工具中的 RDB Table Map選項用於生成 DAD 文件和測試功能庫就可以實現這一點。測試功能庫將被用於 使 DB2 XML Extender 可以使用 DB2 數據庫，以及保存和檢索來自關係數據庫的 XML 數據。用於本示例的數據存儲在三個數據庫表 — CUSTOMERS、VIDEOS 和 RENTALS — 中，您會發現，這三個表都在 VIDEOS 數據庫中。
XML 輸入和輸出文件將使用如下 DTD 文件。請參見下面清單 1。
清單 1. CustomerRental.dtd
<?xml version="1.0" encoding="UTF-8"?> <!ELEMENT CustomerRental (Customer*)> <!ELEMENT Customer (Rental*)> <!ATTLIST Customer ID CDATA #IMPLIED Name CDATA #IMPLIED> <!ELEMENT Rental (VideoName)> <!ATTLIST Rental Date CDATA #IMPLIED VidID CDATA #IMPLIED> <!ELEMENT VideoName (#PCDATA)>
創建項目目錄結構
在 Workbench 中，創建一個名爲 CustomerRentals 的項目。在該項目中創建下列三個文件夾： db 、 dtd 和 testharness 。這些目錄將分別用於容納導入的數據庫、 CustomerRental.dtd 文件以及生成的測試功能庫文件。
連接到數據庫然後導入本地副本
請參考本系列的 第 2 部分，該文是有關如何連接到 VIDEOS 數據庫並把本地副本導入到上面指定的 CustomerRentals/dB 目錄的。
新的 RDB to XML Mapping Wizard：創建 RDB to XML Mapping 會話
我們需要先創建一個 RDB to XML Mapping 會話，之後才能創建映射。在擴展名爲 .rmx 的文件中將存儲有關該映射會話的信息，包括源表、目標 DTD 文件、所創建的任何映射以及連接條件。我們要保留有關已創建的任何映射的信息，以便在將來可以容易的重新裝入或修改，對此這個文件是必需的。我們要做完下面這些步驟來創建最初的 RDB to XML Mapping 會話。
- 啓動新的 RDB to XML Mapping Wizard
- 命名 RDB to XML Mapping 會話
- 選擇映射類型
- 選擇源 RDB 表
- 選擇目標 DTD 文件
- 選擇目標 DTD 文件的根元素
1. 啓動新的 RDB to XML Mapping Wizard
現在我們要創建 RDB to XML Mapping 會話。在 Application Developer 中：
- 在屏幕頂端菜單中，選擇 File => New => Other。打開名爲
New的窗口。 - 選擇左邊的 XML。
- 選擇右邊的 RDB to XML Mapping。
- 單擊 Next。將打開 Specify New RDB to XML Mapping 會話頁面。
2. 命名 RDB to XML Mapping 會話
在本頁面上，我們將指定會話名稱，以及我們想要的創建會話文件的位置。
- 選擇 CustomerRentals文件夾（這個文件夾是早創建好的）。
- 指定文件名
CustomerRentals.rmx。 - 單擊 Next。
3. 選擇映射類型
利用 RDB to XML Mapping 工具把關係數據映射成 XML 數據的方法有兩種，一種方法是通過 RDB 表映射（RDB Table Map），另一種方法是 SQL 語句映射（SQL Statement Map）。這兩種映射方法都使用 DAD 文件表示映射，但是使用的是不同的標記。
RDB 表映射把 RDB 列映射成爲 XML 數據。可選的連接條件皆可指定。如果您只想要提取或存儲數據庫表中的信息，這種方法是有用的。利用 RDB 表映射創建的 DAD 文件可以用於分解 XML 文件並把它存成關係數據，也可用於取出關係數據並利用它來合成 XML 文件。
SQL 語句映射取出 SQL 語句並允許用戶把執行 SQL 語句得到的結果列映射到 XML 屬性和元素。如果您有複雜的查詢並想表示成 XML 數據，使用這種方法是有用的。這些 SQL 語句得是使用 Application Developer 的 SQL Builder 創建的，如 第 2 部分中所示。RDB 表映射和 SQL 語句映射之間的關鍵區別是：SQL 語句映射只能用於取出關係數據並利用它來合成 XML 文件，反之則不行。
對於這個示例而言，我們將使用 RDB 表映射。
- 選擇 RDB Table to XML Mapping。
- 單擊 Next。
4. 選擇源 RDB 表
在本頁面上，我們選擇 RDB 表，我們將映射這個表中的列。對這個示例來說，我們感興趣的表有三個：CUSTOMERS、VIDEOS 和 RENTALS。
圖 1. Source RDB Tables 頁面 
- 擴展
CustomerRentals/dB下的目錄樹（我們早先把數據庫導入這裏）。 - 選擇 CUSTOMERS。
- 按住 Ctrl，選擇 RENTALS。
- 按住 Ctrl，選擇 VIDEOS。應該只突出顯示我們想要的三個表。
- 單擊 Next。
5. 選擇目標 DTD 文件
我們需要指定一個 DTD，源 XML 文件和目標 XML 文件都會符合它。如果您還沒有把 DTD 文件（ CustomerRental.dtd ）導入到 CustomerRental/dtd 文件夾中，那麼請您選中 Import按鈕現在導入。
圖 2. 目標 DTD 文件頁面 
- 選擇 CustomerRental.dtd。
- 單擊 Next。
6. 選擇目標 DTD 文件的根元素
在此，我們需要選擇目標 DTD 文件的根元素。使用它將允許我們用 XML 格式來表示 DTD 文件，從而我們可以把 RDB 表列映射到 XML 文檔的特定元素和屬性。
- 選擇 CustomerRentals。
- 單擊 Finish。
現在我們已創建了一個會話，它將把 RDB 映射到 XML。該會話將會在 RDB to XML Mapping Editor 中打開。
使用 RDB to XML Mapping Editor
我們將要在 RDB to XML Mapping Editor 中做完所有的工作。在這裏，我們將完成下列任務：
單擊 CustomerRentals.rmx 選項卡，您將會看到兩個窗格，如下面圖 3 中所示。
圖 3. 映射前的 RDB to XML Mapping 視圖 
左邊的窗格標題是 Tables，表示 RDB 表中所有可以被映射的列。在目前情況下，我們會看到 CUSTOMERS、RENTALS 和 VIDEOS 表及其所有列。
右邊的窗格標題是 XML, 其中展示的是 DTD 文件 CustomerRentals.dtd 的 XML 表示，只要選擇 CustomerRentals作爲根元素就會創建這個文件。
除 RDB to XML Mapping 視圖之外，還有另外兩個視圖： Outline 視圖，在該視圖中可以看到當前的所有映射，以及 Overview 視圖，在該視圖中可以看到 XML 文檔的摘要視圖以及已經被映射到 XML 文檔的元素和屬性的所有內容。
在頂端菜單條中，有一個菜單項 Mapping 展示了特定於 RDB to XML Mapping 工具的功能。
圖 4. Mapping 菜單 
在工具條上，另外還有兩個圖標： 
圖標可以讓您生成 DAD 文件，而 
圖標允許您 指定連接條件。
1. 創建映射
在 RDB to XML Mapping 視圖下，我們可以定義關係數據與 XML 元素及屬性之間的映射。要創建從 CUSTOMERS.CUST_ID RDB 列到 CustomerRentals/Customer 元素下的 ID XML 屬性的映射，請執行下面的操作：
- 在 Tables 窗格中選中
CUSTOMERS表下面的 CUST_ID列。 - 在 XML 窗格中選中
CustomerRentals/Customer元素下的 ID屬性。 - 右鍵單擊出現上下文菜單，並選擇 Create Mapping。
圖 5. RDB to XML Mapping 視圖上下文菜單
![RDB to XML Mapping 視圖上下文菜單的抓屏]()
現在，我們已經在 CUST_ID 列和 CustomerRentals/Customer 元素的 ID 屬性之間創建了映射。您將會看到這一映射被同時列入了 Outline 視圖和 Summary 視圖。如果您仔細看一下 RDB to XML Mapping 視圖，您會注意到 CUST_ID 列和 ID 屬性旁邊的小箭頭，表示這幾項是已經映射好的。當我們 生成 DAD 文件時，這一映射信息就會反映在生成的 DAD 文件中，DB2 XML Extender 還可以用它把 XML 文件合成爲關係數據或把關係數據分解爲 XML 文件。
我們總共需要爲這個示例創建五個映射：
- Table CUSTOMERS 列
ID到Customer元素下的屬性ID。 - Table CUSTOMERS 列
NAME到Customer元素下的屬性Name。 - Table RENTALS 列
DATE到Rental元素下的屬性Date。 - Table RENTALS 列
VID_ID到Rental元素下的屬性Vidid。 - Table VIDEOS 列
TITLE到Rental元素下的元素VideoName。圖 6. 映射後的 RDB to XML Mapping 視圖
![映射後的 RDB to XML Mapping 視圖的抓屏]()
2. 指定連接條件
由於在我們的示例中不止一個表，我們需要爲這些表指定連接條件。連接條件用來指定一個表中的哪一列應該與另外一個表中的列匹配。如果沒有指定兩個表之間的連接條件，那麼將會返回包含這兩個表的所有可能組合的結果集。這樣就很可能會返回不正確的結果，比如可能會返回無效的行。對於我們的示例，我們需要指定 CUSTOMERS 和 RENTALS 表之間以及 RENTALS 和 VIDEOS 表之間的連接條件。
如果您單擊 Generate DAD file按鈕就會有不止一個源表而且沒有指定連接條件，那麼將出現一條警告消息，該消息提示用戶添加連接條件或在沒有連接條件的情況下繼續。
要指定連接條件，請單擊工具條上的 Edit Join Conditions 按鈕。打開的將是一個包含表的窗口，我們可以在此指定想連接的列。在目前的情況下，我們想要連接 CUSTOMERS 表中的 CUST_ID 列與 RENTALS 表中的 CUST_ID 列。
圖 7. Edit Join Conditions 頁面 
添加 CUSTOMERS.CUST_ID 和 RENTALS.CUST_ID 的連接條件的步驟：
- 選擇第一列的 CUSTOMERS.CUST_ID。“=”會被填入第二列。該字段不可編輯，因爲“=”是這一列唯一可能的值。
- 選擇第三列的 RENTALS.CUST_ID。
現在，我們已經成功的創建了連接條件。如果我們需要再添加一個連接條件，那麼就繼續到下一行並重復這些步驟。第四列將會被自動填入 "AND." 這個詞。 AND 列不可編輯，而且如果不再需要的話會被刪除。
對於這個示例，我們還需要在 RENTALS.VID_ID 和 VIDEOS.VID_ID 之間創建連接條件。重複上述步驟創建該連接條件。Edit Join Conditions 頁面看上去應該與上面圖 7 相仿。
如果您想要刪除一個連接條件，只需選中該行，單擊右鍵並選擇 Remove Join Condition。
一旦創建好了合適的連接條件，請單擊 Finish。
3. 生成 DAD 文件和測試功能庫
在創建了所有的映射而且指定了所有的連接條件之後，就該生成 DAD 文件了。在工具條上單擊 Generate DAD file圖標來啓動 Generate DAD file 嚮導。
指定 DAD 文件名
Generate DAD 文件嚮導中出現的第一個頁面是 Specify DAD File Name 頁面。我們要在這裏指定將要生成的 DAD 文件的位置及文件名。
- 選擇我們早就創建好的
CustomerRentals/testharness文件夾。 - 指定
CustomerRentals.dad的文件名。
如果我們只對生成 DAD 文件感興趣，那麼我們單擊 Finish就可以了。但是由於我們想要指定封閉標記，還想要生成測試功能庫，所以請單擊 Next。
指定封閉標記
指定封閉標記是一個選擇項，它允許我們指定封閉整個文檔的標記。這在我們要合成 XML 的情況下是很有用的。XML 文檔的頂部元素包含 PCDATA 或屬性，而且這個 PCDATA 或屬性的值可以有多個。在這種情況下，由於我們有多個頂部元素，可能會有多個 XML 文件作爲輸出而被生成。封閉標記選擇項允許方便的指定一個用來封閉結果的標記，所以將只返回一個 XML 文檔。在選擇了這一選擇項的情況下，存儲 XML 功能將不使用生成的 DAD 文件。
對於我們的情況，不需要指定封閉標記。請單擊 Next。
生成測試功能庫
測試功能庫的目的在於提供操作系統特定的命令行文件，這些命令行文件將 使 XML Extender 可以使用 DB2 數據庫，並對 DAD 文件進行處理以利用關係數據生成 XML 或者把 XML 數據分解爲關係數據。
爲了生成測試功能庫，請選擇 Generate Test Harness複選框，並完成下列步驟。
- 在 Folder 域中，瀏覽
CustomerRentals/testharness文件夾並選中它。 - 現在請提供環境變量的值。這些環境變量包含有 實際執行測試功能庫的目的機器上的特定路徑信息。這並不一定要和目前運行 Application Developer 的是一樣的機器或操作系統。
- 將 DB2 SQLLIB 目錄的位置填入
SQLLIB環境變量。 - 將 DB2 XML Extender 目錄填入
DB2EXTENDER環境變量。通常這個目錄中都會包含dxx（即，Windows 系統上的e:/dxx或是 Linux 系統上的/home/db2inst1/dxx）。 - 將您想要放入生成的 XML 文件的位置填入
XMLDIR環境變量。這和storeXML將要尋找源 XML 文件的位置是一樣的。這一目錄的存在必須先於實際執行測試功能庫。
- 將 DB2 SQLLIB 目錄的位置填入
- 現在請選擇目的平臺。目的平臺是實際執行測試功能庫文件的平臺。這一點之所以非常重要，是因爲它將在生成的測試功能庫文件中確定特定於操作系統的信息，比如文件分隔符和訪問環境變量的方式。
- 請選擇 Windows。（如果您要在 Linux 系統上運行測試功能庫的話，請選擇 UNIX®。）
- 單擊 Finish生成測試功能庫文件。
生成的測試功能庫文件將會在 Destination Folder 域中指定的目錄中。可以在 Application Developer 中打開 DAD 文件，也可進行編輯。對生成的 DAD 文件進行的更改僅侷限於 DAD 文件本身，不會反映在 RDB to XML Mapping 會話文件中。因此，下一次重新生成 DAD 文件時，以前所做的任何更改都不會再反映出來。
圖 8. Generate Test Harness 頁面
![Generate Test Harness 頁面的抓屏]()
使 XML Extender 可以使用 DB2
我們需要先啓用數據庫對 XML 的支持，然後我們才能利用 DB2 XML Extender 在 DB2 中保存並檢索 XML 文檔。如 DB2 XML Extender 文檔中所述，這將會：
- 創建所有的用戶定義類型（user-defined type，UDT）和用戶定義函數（user-defined function，UDF）。
- 創建控制表並把 XML Extender 所要求的必要的元數據填入。
- 創建 db2xml 模式並指定必要的特權。
對於我們來說，啓用數據庫對 XML 的支持是在測試功能庫文件 retrieveXML 和 storeXML 中完成的。想要更多有關細節的信息，以及如何手工啓用數據庫對 XML 的支持的信息，請參考 DB2 XML Extender 文檔。
運行測試功能庫
到生成測試功能庫的目錄： CustomerRentals/testharness 。在執行任何測試功能庫文件之前，請確保數據庫已經啓動。
運行安裝（setup）文件
在 Windows 系統上，請在命令行 shell 運行 setup.bat 。該文件設置其它文件使用的環境變量。在 Windows 系統上運行 setup.bat 之後，會出現一個初始化的 DB2 shell。其它所有的測試功能庫文件都需要從這個 shell 中運行。
在 Linux 系統上，爲了初始化環境，您需要在命令行 shell 中引用 setup 。其它所有的測試功能庫文件都必須在這個 shell 中運行。
運行 updateDTD_REF 文件
如果您需要啓用驗證，或想要把 DTD 文件插入 DB2XML.DTD_REF 表中，那請運行 updateDTD_REF 文件。要啓用驗證，您會需要手工修改 DAD 文件，把 VALIDATION 標記變成 YES 。缺省情況下，它的值爲 NO 。對生成的 DAD 文件所做的任何更改都不會在 RDB to XML Mapping 會話文件中有所反映，也不會在將來生成的任何 DAD 文件中體現。
對於我們的情況，您不需要運行這個命令。
運行 retrieveXML 文件retrieveXML 文件將會用於 使 DB2 XML Extender 可以使用 DB2 數據庫，以及檢索關係數據並按照 DAD 文件中定義的映射把關係數據存儲在 XML 文件中。
啓用數據庫的結果以及結果 XML 數據都將會顯示在屏幕上。結果 XML 數據也可以寫到 XMLDIR 中的文件中，這個文件可以和會話文件同名，只是擴展名爲 .xml 。在我們的示例中，將把這個文件叫做 CustomerRental.xml 。如果返回的是多個 XML 文件，只有第一個會被寫入 XMLDIR 。
在 Windows 上，從運行 setup.bat 創建的 DB2 shell 運行 retrieveXML.bat 文件。
在 Linux 上，要在與引用 setup 一樣的命令行 shell 中運行 retrieveXML.sh 。
運行使用我們的 DTD 的 retrieveXML 的樣本結果 XML 文件將會保存在 XMLDIR 中，文件名爲 CustomerRental.xml ，類似於下面的清單 2。
清單 2.
<?xml version="1.0"?> <!DOCTYPE CustomerRental PUBLIC "CustomerRentalId" "CustomerRental.dtd"> <CustomerRental> <Customer Name="John Doe" ID="500"> <Rental Date="2000-05-25" Vidid="100"> <VideoName>The Adventures of Kernighan and Ritchie</VideoName> </Rental> <Rental Date="2000-05-25" Vidid="101"> <VideoName>The taming of the Foo</VideoName> </Rental> </Customer> <Customer Name="Jane Doe" ID="501"> <Rental Date="2000-06-01" Vidid="100"> <VideoName>The Adventures of Kernighan and Ritchie</VideoName> </Rental> </Customer> <Customer Name="Bob Smith" ID="502"> <Rental Date="2000-10-10" Vidid="104"> <VideoName>Bar Trek 4 The Voyage Home Directory</VideoName> </Rental> <Rental Date="2000-10-11" Vidid="104"> <VideoName>Bar Trek 4 The Voyage Home Directory</VideoName> </Rental> <Rental Date="2001-02-05" Vidid="105"> <VideoName>High RISC</VideoName> </Rental> </Customer> <Customer Name="Roberta Smith" ID="503"> <Rental Date="2000-09-01" Vidid="102"> <VideoName>Take out the Garbage Collection</VideoName> </Rental> </Customer> </CustomerRental>
運行 storeXML 文件storeXML 文件將會用於 使 DB2 XML Extender 可以使用 DB2 數據庫，並把 XML 元素和屬性中的數據保存在 RDB 表中。它還會在插入行之前刪除表中的所有行。這個文件會從 XMLDIR 目錄取出輸入 XML 文件。它會尋找和會話文件同名但擴展名爲 .xml 的文件。在我們的示例中，它會尋找一個名爲 CustomerRental.xml 的文件。您可以使用隨該示例提供的 CustomerRental.xml 文件，或者您也可以使用運行 retrieveXML 的結果作爲輸入。請把文件 CustomerRental.xml 複製到您早先在 XMLDIR 環境變量中指定的目錄。
在 Windows 上，從運行 setup.bat 創建的 DB2 shell 運行 storeXML.bat 文件。
在 Linux 上，要在與引用 setup 一樣的命令行 shell 中運行 storeXML.sh 。
要驗證存儲操作是否正確工作：
- 請手工操作數據庫覈對您預計應當有的數據，或者
- 請先運行
retrieveXML文件，接着複製結果 XML 文件，運行存儲操作後再運行檢索操作，並把結果 XML 文件同原來的文件進行比較。
總結
在本文中，您已經看到如何使用 RDB to XML Mapping Editor 來：
- 創建一個 RDB Mapping 會話文件。
- 將 RDB 列映射至 XML 元素和屬性.
- 指定表的連接條件。
- 生成 DAD 文件。
- 生成測試功能庫。
- 運行測試功能庫以使 XML Extender 可以使用 DB2 數據庫，並從數據庫數據創建 XML 文件。
- 運行測試功能庫以使 XML Extender 可以使用 DB2 數據庫，並把 XML 數據保存在關係表中。
