深度解析 pureQuery：IBM 革新 Java 資料庫開發的對象化範式

關係型資料佔據企業資訊系統核心地位，而 Java 以物件導向著稱。物件與關係列之間的「阻抗失配」長期困擾開發者。IBM pureQuery 作為 Eclipse 為基礎的可插拔元件，透過**關係資料對象化**，將 SQL 與 Java 無縫整合於 IDE 編輯器，提供設計時編譯驗證、內容輔助、動態 SQL 執行與視覺化效能分析，顯著提升資料庫應用開發效能。本文系統介紹 pureQuery 核心概念、三大對象化模式 (DDO/QDO/ORM)、實戰場景與進階特性。

一、 核心問題：關係資料對象化的必要性

• 物件 vs 列：物件具備封裝/繼承/多型，唯一性由引用決定；列唯一性由主鍵決定，屬於表，刪除即消失。
• 傳統痛點：SQL 以字串內嵌 Java，缺乏編譯期語法/語義驗證、無內容輔助、重構困難。
• pureQuery 使命：自動將關係資料轉換為 Java 物件，讓開發者以自然 OO 範式編寫業務邏輯，SQL 與 Java 深度融合。

二、 pureQuery 是什麼？

• 基於 Eclipse 的可插拔元件，無縫整合 IDE。
• 提供設計時與運行時雙模式，自動發現資料庫構件 (表、預存程序等)。
• GUI 直觀將關係實體轉換為 Java 物件，自動生成 SQL 與封裝類。
• Java 編輯器與 SQL 緊密整合：語法著色、語義驗證、內容輔助、動態執行與錯誤標記。
• 設計時可執行 SQL 並預覽結果集，自動回滾副作用。
• 整合 Visual Explain 視覺化查詢計劃，設計時即可定位效能瓶頸。

三、 三大對象化模式

1. 資料庫驅動對象化 (DDO, Database-driven Objectization)

最常用模式：選擇表 → 自動生成 CRUD 物件模型。

• 生成 Bean 類 (欄位對應列)、註解介面 (CRUD 方法)、預設實現類、單元測試類、內聯 SQL 測試類。
• 支援 @Table、@Column 註解映射。

2. 查詢驅動對象化 (QDO, Query-driven Objectization)

已有 SQL 語句 → 右鍵選單「Generate SQL Bean」 → 自動解析結果集元資料生成 Bean 類與介面。

3. 物件關係映射 (ORM, Object-Relational Mapping)

已有 Bean 類 → 透過 @Table、@Column 註解映射至資料庫表 → 生成 CRUD 介面與實現。反向亦支援：由 Bean 生成 DDL 建表腳本。

四、 實戰場景：DDO 流程完整演示

環境需求：DB2 8.0+ (含 SAMPLE 資料庫)、Developer Workbench 9.5、pureQuery Plugin 1.0。

步驟 1：建立 Java 專案

專案名 Personnel，建立 src/bin 目錄。

步驟 2：啟用 pureQuery 支援

右鍵專案 → Add pureQuery Support → 勾選 Import required pureQuery JAR files into project → 選擇 SAMPLE 資料庫連線。

圖 1：為 Eclipse Java 專案啟用 pureQuery 支援

圖 2：Add pureQuery Support 精靈 - 常規選項

圖 3：選擇 SAMPLE 資料庫連線

步驟 3：自動生成程式碼

Database Explorer 中右鍵 EMPLOYEE 表 → Generate pureQuery Code。

圖 4：包含 SAMPLE 資料庫所有構件的 Database Explorer

圖 5：右鍵選單生成 pureQuery 程式碼

精靈關鍵配置頁面

• Bean 選項：資料夾 Personnel/src，Bean 名 MyEmployee (生成 @Table(name="EMPLOYEE"))，勾選生成介面、測試類、內聯範例類、JUnit 測試。
• 欄位定義：選擇 Protected Fields with Public accessor methods，可自訂欄位名 (生成 @Column 註解)。
• SQL 風格：選擇 Generate all SQL statements。

圖 6：pureQuery Code Generation 精靈

圖 7：定義 Bean 欄位屬性

圖 8：生成不同風格的 SQL 語句

生成構件清單

檔案	說明
MyEmployee.java	主 Bean 類，欄位與表列 1:1 映射，含存取器
MyEmployeeData.java	註解介面，定義 CRUD 抽象方法
MyEmployeeDataImpl.java	介面預設實現，封裝所有 SQL (專案建構時生成)
MyEmployeeDataTest.java	單元測試類，含 main 測試所有方法
MyEmployeeInLineSample.java	內聯 SQL 風格測試類 (可選生成)
SampleUtil.java	工具包：取得連線、列印輸出等靜態方法

圖 9：表示 Employee 表的 Java Bean 類

圖 10：包含 CRUD 介面的 MyEmployeeData.java

圖 11：包含介面方法實現的類

圖 12：生成的單元測試類

圖 13：自動生成的內聯 SQL 測試類

圖 14：自動生成的工具類

五、 QDO 與 ORM 場景速覽

QDO：從 SQL 生成 Bean

1. 專案中新建 Java 檔，貼上 SQL 查詢語句。
2. 右鍵 SQL → pureQuery Assist → Generate SQL Bean → 命名 MySQLEmployee → 完成生成 Bean。

圖 15：根據 SQL 語句建立 Bean

圖 16：指定 Bean 類名稱

圖 17：指定 Bean 欄位屬性

ORM：現有 Bean 映射資料庫

1. 在 Bean 類上添加 @Table(name="EMPLOYEE", schema="DB2ADMIN")。
2. 需映射欄位上添加 @Column(name="COL_NAME")。
3. 右鍵類 → pureQuery Assist → Generate pureQuery Code → 生成介面/實現/測試類。

圖 18：將 Bean 映射到關係表

圖 19：註解建立主機變數與表列映射

六、 進階特性：SQL 與 Java 編輯器深度整合

1. 程式碼輔助

• SQL 語句完成：輸入關鍵字自動提示子句結構。
• 內容輔助：提示表/模式/欄位名稱、Java 主機變數。
• 快速修復：偵測拼字錯誤 (如 Selct) 並一鍵修正。

圖 20：SQL 語句完成

圖 21：內容輔助 - 實體名稱

圖 22：主機變數內容輔助

圖 23：快速修復 - 拼字錯誤

2. 自動發現資料庫定義

點擊 Bean 成員名稱 (類名/欄位名) 即可跳轉至 Database Explorer 對應表/欄位節點，雙向導航極致便利。

圖 24：點擊選擇 Bean 類成員名稱

圖 25：點擊跳轉至 Database Explorer

3. 設計時運行時聯合：動態執行 SQL

編輯器中右鍵 SQL → pureQuery Assist → Run SQL → 即時在 Data View 預覽結果集，自動回滾變更，零風險驗證查詢邏輯。

圖 26：設計時點擊運行 SQL

圖 27：Data View 顯示設計時執行 SQL 結果

七、 結語

pureQuery 以直觀的 GUI 驅動對象化流程，將關係存取無縫轉化為物件操作，結合 Eclipse 編輯器的 SQL/Java 深度融合 (驗證、輔助、動態執行、視覺化解釋)，為資料庫中心應用開發提供了先進的生產力工具。它不僅優化開發效率，更透過設計時效能分析與靜態 SQL 執行能力，保障應用運行品質，是 Eclipse 生態中 Java 資料庫開發的里程碑式創新。