Apache—DBUtils架構簡介、DbUtils類、QueryRunner類 、ResultSetHandler介面

Apache—DBUtils架構簡介、DbUtils類、QueryRunner類 、ResultSetHandler介面

commons-dbutils 是 Apache 組織提供的一個開源 JDBC工具類庫，它是對JDBC的簡單封裝，學習成本極低，並且使用dbutils能極大簡化jdbc編碼的工作量，同時也不會影響程式的效能。因此dbutils成為很多不喜歡hibernate的公司的首選。

API介紹：

org.apache.commons.dbutils.QueryRunner --BDManager

org.apache.commons.dbutils.ResultSetHandler—處理結果集

工具類

org.apache.commons.dbutils.DbUtils、。

DbUtils類 

DbUtils ：提供如關閉串連、裝載JDBC驅動程式等常規工作的工具類，裡面的所有方法都是靜態。主要方法如下：

public static void close(…) throws java.sql.SQLException：　DbUtils類提供了三個重載的關閉方法。這些方法檢查所提供的參數是不是NULL，如果不是的話，它們就關閉Connection、Statement和ResultSet。

public static void closeQuietly(…): 這一類方法不僅能在Connection、Statement和ResultSet為NULL情況下避免關閉，還能隱藏一些在程式中拋出的SQLEeception。

public static void commitAndCloseQuietly(Connection conn)： 用來提交串連，然後關閉串連，並且在關閉串連時不拋出SQL異常。 

public static boolean loadDriver(java.lang.String driverClassName)：這一方裝載並註冊JDBC驅動程式，如果成功就返回true。使用該方法，你不需要捕捉這個異常ClassNotFoundException。

QueryRunner類 

該類簡單化了SQL查詢，它與ResultSetHandler組合在一起使用可以完成大部分的資料庫操作，能夠大大減少編碼量。

QueryRunner類提供了兩個構造方法：

預設的構造方法

需要一個 javax.sql.DataSource 來作參數的構造方法。

QueryRunner類的主要方法

public Object query(Connection conn, String sql, Object[] params, ResultSetHandler rsh) throws SQLException：執行一個查詢操作，在這個查詢中，對象數組中的每個元素值被用來作為查詢語句的置換參數。該方法會自行處理 PreparedStatement 和 ResultSet 的建立和關閉。

public Object query(String sql, Object[] params, ResultSetHandler rsh) throws SQLException:　幾乎與第一種方法一樣；唯一的不同在於它不將資料庫連接提供給方法，並且它是從提供給構造方法的資料來源(DataSource) 或使用的setDataSource 方法中重新獲得 Connection。

public Object query(Connection conn, String sql, ResultSetHandler rsh) throws SQLException : 執行一個不需要置換參數的查詢操作。

public int update(Connection conn, String sql, Object[] params) throws SQLException:用來執行一個更新（插入、更新或刪除）操作。

public int update(Connection conn, String sql) throws SQLException：用來執行一個不需要置換參數的更新操作。

ResultSetHandler介面 

該介面用於處理 java.sql.ResultSet，將資料按要求轉換為另一種形式。

ResultSetHandler 介面提供了一個單獨的方法：Object handle (java.sql.ResultSet .rs)。

ResultSetHandler 介面的實作類別

ArrayHandler：把結果集中的第一行資料轉成對象數組。

ArrayListHandler：把結果集中的每一行資料都轉成一個數組，再存放到List中。

BeanHandler：將結果集中的第一行資料封裝到一個對應的JavaBean執行個體中。

BeanListHandler：將結果集中的每一行資料都封裝到一個對應的JavaBean執行個體中，存放到List裡。

ColumnListHandler：將結果集中某一列的資料存放到List中。

KeyedHandler(name)：將結果集中的每一行資料都封裝到一個Map裡，再把這些map再存到一個map裡，其key為指定的key。

MapHandler：將結果集中的第一行資料封裝到一個Map裡，key是列名，value就是對應的值。

MapListHandler：將結果集中的每一行資料都封裝到一個Map裡，然後再存放到List