Query Object(快速上手)

Table Object 的設計是針對單一個表格和物件間的對應。但是在有些時候我們會需要一個 Java 物件對應到數個資料庫內的表格，此時，我們就可以使用 Query Object。

在本次的說明中，我們將會作如下的動作：

創建一個新的 Netbeans 專案
在 Netbeans IDE 中建立一個資料庫連線
新增一個 Query Object 的定義檔案
產出對應資料庫表格的 Java 檔案
使用所產出的檔案，對資料庫作查詢資料

在 Netbeans 建立一個測試用的專案。

專案名稱為 TEST01 ，專案路徑則自行選定。

在 Netbeans IDE 中建立一個資料庫連線。

開啟 Netbeans->Windows->Services 。
DB Obejct Builder 目前可以支援三種資料庫：Oracle, MSSQL 和 MySQL，在本範例中，我們是採用 MySQL 資料庫。
建立的連線如下：

新增一個 Query Object 的定義檔案

開啟 Netbeans->File->New File，Categories 選擇 DBObject ，File Types 選擇 QueryTemplate，按下一步。
File Name 填入 QryCustOrders ，Folder 填入 src\test01\dbObjDef，按 Finish。
新產出的定義檔如下：

產出對應資料庫表格的 Java 檔案

當開啟 QryCustOrders 時，會見到如下的畫面：

指定剛所設定的資料庫連線後，按 Connection 。

設定 Java 的檔名， SQL ，及產出的目錄 (Package) ，按下 Execute Query，並驗證查詢結果是否如預期。

按下 Generate Java Source，則會見到在指定的目錄下見到新產出的檔案：

使用所產出的檔案，對資料庫作查詢資料

建立查詢範例程式 test01.examples.b01_qry.java，程式碼如下：

Connection conn = DriverManager.getConnection("jdbc:mysql://localhost:3306/classicmodels", "root", "root");
QryCustOrders[] custOrders = QryCustOrders.executeQuery(conn);
for (QryCustOrders custOrder : custOrders) {
    int custNumber = custOrder.getCustomernumber();
    String custName = custOrder.getCustomername();
    int orderNum = custOrder.getOrdernumber();
    System.out.println(String.format("Number:%s, Name:%s, OrderNum: %s", custNumber, custName, orderNum));
}

程式碼說明

從上述的程式碼我們可以看到，僅需透過 QryCustOrders 的靜態方法來取得所有的 QryCustOrders 陣列。
當取得 QryCustOrders 物件後，就可以輕易取出內含的屬性（透過 IDE 的 Code Completion）如下：

Simple DB Object Builder

Query Object 快速上手