做表單的人多半有過這種經驗:資料庫欄位早就定好了,Web Service 也包好了,卻還得回頭一格一格把輸入欄位、驗證規則、錯誤提示手刻一遍。IBM 的 XML Forms Generator(以下簡稱 XFG)搭配 Data Studio,走的正是把這段重複勞動自動化的路。
XFG 能在幾秒之內產出一份堪用的表單骨架——它把 XForms 標記直接內嵌在 XHTML 文件裡(本文把這種組合稱為「XHtml/XForm」)。產生的輸入可以是一份 XML 資料實例,也可以搭配後端的 XML Schema 或 WSDL 文件。至於 Data Studio,它是 IBM 提供的圖形化用戶端工具,能直接連上資料庫,把 SQL 腳本與 stored procedure 包裝成 Data Web Services。
W3C 為表單資料的表達與蒐集制定了 XForms 標準。依 W3C 的說法,XForms 的目標是成為「下一代 Web 表單」:它把傳統 XHTML 表單拆成三個部分——XForms 模型、實例資料、使用者介面——藉此把「表達」與「內容」分離。這樣做的好處是元件可重複使用、具備強型別、大幅減少與伺服器往返的次數,同時擺脫裝置相依性,整體程式碼量也随之下降。
一份 XForms 文件帶有一個數據模型,其中包含一個或多個 XML 實例文件;表單負責編輯這些實例,最後再把整份 XML 提交給後端系統。
XFG 本身是開放原始碼的 Eclipse Workbench 外掛,2005 年 4 月首次在 alphaWorks 上釋出。
IBM Data Studio 是一套整合式的資料管理工作環境,為資料庫物件、查詢、資料庫邏輯與 pureQuery 應用程式提供完整的開發與測試環境。透過它,你可以用 SQL 與 XQuery 整合查詢編輯器加速開發、針對應用程式與查詢做效能調校、用互動式除錯器測試以 Java 程式碼或 SQL 撰寫的 stored procedure,也能直接在 Java 應用程式內部開發或客製 SQL。
Data Studio 眾多新功能中,最值得注意的是對 Data Web Services 的支援。Data Web Services 是 IBM 資料庫伺服器的新一代 Web 服務供應器,提供完整的 Web 服務介面:支援 REST 風格的服務(HTTP GET/POST 綁定)、SOAP over HTTP,並能自動產生 WSDL。它涵蓋 IBM DB2 資料庫家族、IBM Informix Dynamic Server(IDS),並可搭配 Apache Tomcat 5.5、IBM WebSphere Application Server V6.1、IBM WebSphere Application Server Community Edition V1.1 等常見的 Web 伺服器運行。
Data Studio 已經把資料庫層與中介層的 Data Web Services 開發變得相當省力,而 XFG 則靠著「讀 WSDL 就能生表單」的能力,把 XForms 介面的開發效率拉上來。把兩者放在一起,就等於打通了一條從資料庫到 Web 服務、再到使用者介面的快速開發流水線。
整合之後能拿到什麼?大致是這幾件事:
由於 XFG 與 Data Studio 都是 Eclipse 外掛,兩者的整合顯得格外單純:從更新站台下載 XFG 外掛,裝進 Eclipse 即可。
整體架構與資料流向可以參考下圖。
圖 1. Data Studio 與 XFG 的架構與互動
流程是這樣的:Data Studio 依據資料庫中繼資料產生 Data Web Services;接著 XFG 拿這份 Web 服務定義加上資料庫中繼資料,產生出 XHTML/XForms;最後,這份表單透過 REST 或 SOAP 與 Data Web Services 溝通。
為了把細節走一遍,我們做一個迷你版的「患者資訊管理」應用程式,資料表結構如下:
| 欄位名稱 | 欄位型別 | 必填 | 說明 |
|---|---|---|---|
| ID | INTEGER | Y | 每筆寫入資料的唯一識別碼 |
| NAME | VARCHAR(10) | Y | 患者姓名 |
| BIRTHDAY | DATE | Y | 患者出生日期 |
| HEIGHT | DECIMAL | Y | 患者身高 |
| WEIGHT | DECIMAL | Y | 患者體重 |
| DESCRIPTION | VARCHAR(10) | Y | 關於患者的簡短描述 |
想動手試的人,先下載免費的 DB2 Express-C,用 DB2 Control Center 建立一個資料庫,再照上表建立資料表。本文的範例使用 DB2ADMIN 這個 schema,建立名為 PATIENT 的表。
表建好之後,回到 Data Studio 定義 Web 服務——本質上就是把一條 SQL 語句或一個 stored procedure 包裝成服務。使用 SQL 語句時,語句中的參數會對應到 WSDL 裡的輸入參數。Data Studio 與 XFG 都支援兩種參數風格:未命名參數與命名參數。
用未命名參數時,語句長得像這樣:
INSERT INTO DB2ADMIN.PATIENT (NAME, BIRTHDAY, HEIGHT, WEIGHT, DESCRIPTION) VALUES (?,?,?,?,?)
值的位置由問號佔位符(?,?,?,?,?)表示。
用命名參數時,則是一串有名字的變數:
INSERT INTO DB2ADMIN.PATIENT (NAME, BIRTHDAY, HEIGHT, WEIGHT, DESCRIPTION) VALUES (:NAME, :BIRTHDAY, :HEIGHT, :WEIGHT, :DESCRIPTION)
兩者的差別會一路影響到表單:使用命名參數時,產生的 XHtml/XForm 中每個標籤名稱都會沿用參數名稱;使用未命名參數時,系統會自動指派 p1、p2 這類名稱。範例中我們建立名為 insertPatient.sql 的 SQL 檔案,據此產生對應的服務與名為 insertPatient.wsdl 的 WSDL 文件。
服務建立並部署完成後,就能請 XFG 接手,產生與服務溝通的表單及對應的 XML 檔案。在 WSDL 檔案上按右鍵,從 XForms Generator 選單中選擇 Generate XHtml/XForms 精靈。
圖 2. XFG 精靈的第一個步驟
第一步需要輸入使用者名稱與密碼,以便連上底層資料庫。畫面上的「Generate validation information」與「Retrieve PureXML instance from Database」兩個選項都與 DB2 的 pureXML 支援有關,留待系列第二篇再談,這裡先不要勾選。
接著選擇要產生表單的操作,這裡挑 insertPatient。
圖 3. 選擇目標操作
下一步指定輸出的 XHTML 檔案要放在哪裡。
圖 4. 指定目標檔案位置
這一步是關鍵:把提交目標(submission target)改成已部署 Web 服務的端點。只有端點設定正確,產生的表單才有辦法真正把資料送進服務。
圖 5. 客製化輸出文件
接著決定 XML 實例的產生方式。
圖 6. 為 XML 實例的產生選擇選項
指定 XML 實例檔案的位置。
圖 7. 指定 XML 檔案位置
再指定 XML Schema 檔案的位置。
圖 8. 指定 Schema 檔案位置
按下 Finish,XHTML/XForm 就完成了,檔名為 insertPatient.xHtml。在這個檔案裡,XFG 產出了一份 XForms 模型以及相關的綁定屬性;模型中的資料約束以 XForms 綁定屬性的形式存在,內容直接對應資料庫中繼資料——欄位型別、長度、是否必填等等。
清單 1. 產生的 XForms 模型與綁定屬性
用 Firefox 打開 insertPatient.xHtml,畫面大致如下:
圖 9. 在 Firefox 中檢視 insertPatient 的 XHtml/XForms
幾個值得注意的地方:
按下提交,表單便會呼叫 Web 服務,由後端執行 SQL INSERT,把畫面上的數值寫成一列資料。回到資料庫查一下,就能確認記錄確實已經進去了。
本文快速掃過了 XForms、XML Forms Generator、Data Studio 與 Data Web Services,接著說明把 XFG 整合進 Data Studio 的理由,並實走一遍兩者協同工作的流程——最終目標,是替使用者端搭出一套無縫的資料服務解決方案。
系列第二篇會談 XFG 對 DB2 pureXML 的支援:如何在已註冊的 XML Schema 輔助下,把 pureXML 實例直接可視化為 XHtml/XForms。