產生 DADX 檔

DADX 精靈支援從一或多個 SQL 陳述式、儲存程序和 DAD 檔案的組合,來建立 DADX 檔。DADX 檔是一種 XML 檔,可用來建立存取關聯式資料庫的 Web 服務。

註: 如果您從含有參數的 SQL 陳述式產生 DADX 檔,參數必須在簡式直欄表示式中,才能在 DADX 檔中適當產生參數類型。 如果您有在複式直欄表示式中的參數(比方說,在函數中),您必須以手動方式,自行將它們加入產生的 DADX 程式碼中。這是一個已知的問題。

如果需要有關 DADX 的詳細資訊,請參閱 ftp://ftp.software.ibm.com/ps/products/db2extenders/software/xmlext/docs/v72wrk/webserv/dadxspec/dadx.html

文件存取定義 (DAD) 檔是使用者指定檔案,負責控制將 XML 文件元素對映至 DB2® 資料庫直欄以進行儲存及擷取作業。DADX 精靈只支援 Xcollection DAD。DADX 精靈支援的對映和作業類型如下:
  • SQL 陳述式作業(支援基於 SQL 陳述式的查詢和更新作業)。
  • RDB_node 對映(支援基於 DAD 檔案對映的 storeXML 和 retrieveXML 作業)。
  • 儲存程序呼叫。

如果您選取的 DAD 檔定義 SQL 陳述式 (SQL_stmt) 對映,您可能需要自訂 SQL_override 資訊來指定要從 SQL 主變數置換的參數。請參閱 Web services Object Runtime Framework (WORF) 文件,以取得詳細資訊。

您的 SQL 陳述式或儲存程序必須在工作台中,您才能完成 DADX 精靈。 如果需要有關建立 SQL 陳述式或儲存程序的詳細資訊,請參閱相關作業。

如果要產生 DADX 檔,請執行下列動作:

  1. 按一下檔案 > 新建 > 其他
  2. 在「新建」視窗中,展開 Web 服務節點,按一下 DADX 檔,然後按下一步
  3. (選用)展開資料夾,並選取要併入 DADX 檔中的 SQL 陳述式和儲存程序。 您可以只選取 SQL 陳述式、只選取儲存程序,或是同時選取 SQL 和儲存程序。
  4. 下一步
  5. (選用)利用這個頁面來選取要併入 DADX 檔中的一或多個 DAD 檔:
    1. 如果要從檔案系統匯入 DAD 檔,請按一下匯入檔案
    2. 工作台檔案清單中,按一下 DAD 檔,然後按一下 > 請重複這個步驟來新增其他 DAD 檔。
    3. 如果要從選取的檔案清單中移除一或多個 DAD 檔,請按一下 <<< 按鈕。
    4. 將所有必要的 DAD 檔新增至選取的檔案清單之後,請按下一步
    註: 您必須建立 DADX 檔或將 DADX 檔匯入 DADX 群組:WebProject\JavaSource\groups\DADXGroup。任何相關的 DAD 檔也必須位於這個資料夾中。在執行時期,這個資料夾是這些檔案的預期位置。如果不是這樣,您可能會遇到資料庫或伺服器錯誤。
  6. (選用)您可以選取列,再選取您要修改的資料格,以在作業說明欄位中修改或新增文字。輸入您的變更,然後按 Enter 鍵。 作業欄位會為所產生 DADX 檔中作業標籤的名稱屬性提供一個名稱,而說明欄位則提供該文件標籤的說明文字。
  7. 輸入 DADX 檔的檔案名稱。 副檔名必須是 .dadx。
  8. (選用)在說明文字欄位中輸入 DADX 檔的說明。
  9. 選取輸出資料夾,然後按一下完成 為了讓您的 Web 服務能夠正確運作,您必須在 DADX 群組中依序建立 DADX 檔。 必要的話,您可以在別的位置產生 DADX 檔,再於稍後將它移到 DADX 群組中;不過,我們建議您在最初產生它時就將它放在 DADX 群組中。

這時會產生 DADX 檔,且會開啟在 XML 編輯器中,您可以依照需要來編輯它。 如果需要關於搭配 Web 服務使用 DADX 檔的詳細資訊,請參閱下面的相關作業。

註: 如果 DADX 檔以儲存程序為基礎,結果集 Meta 資料就是為了 DADX 而產生的,用在呼叫元素中。為了讓 Web 服務能夠有明確定義的 WSDL 檔,您只能從 DADX 呼叫擁有具固定 Meta 資料之結果集的儲存程序。

<result_set_metadata> 元素是在儲存程序所傳回每個結果集的 DADX 中產生的。即使這些元素共用相同的 Meta 資料性質也是這種情形。如有需要,您可以修改產生的程式碼來使用單一 <result_set_metadata> 標示。 如果您修改了 <call> 元素之 <result_set> 子項元素中使用的 Meta 資料名稱,請務必在對應的 <result_set_metadata> 定義中修改它的名稱。

相關概念
「建立新的 SQL 陳述式」精靈
SQL 建置器
相關工作
利用精靈從 SQL 產生 XML
相關資訊
建立執行 SQL 陳述式的 Java Bean
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.