JDBCUtils詳解

一、概述

JDBCUtils是一個基於Java的JDBC工具類，它簡化了JDBC的使用，使得開發者可以更加便捷地管理數據庫連接、執行SQL語句和處理返回結果集。它是Apache DBUtils的一個擴展庫，提供了更多的功能和便利。

使用JDBCUtils可以有效地減少JDBC編程的代碼量，提高代碼的可讀性和可維護性。同時，JDBCUtils還提供了連接池技術，能夠更好地管理數據庫連接、提高應用程序性能。

下面將從多個方面詳細介紹JDBCUtils的使用方法。

二、數據庫連接管理

JDBCUtils提供了ConnectionUtil類，用於管理數據庫連接。在使用時，需要先根據數據庫信息創建一個數據庫連接池，然後從連接池中獲取數據庫連接。

public class ConnectionUtil {
    private static BasicDataSource dataSource = new BasicDataSource();

    static {
        dataSource.setDriverClassName(DRIVER_CLASS_NAME);
        dataSource.setUrl(URL);
        dataSource.setUsername(USER_NAME);
        dataSource.setPassword(PASSWORD);
        dataSource.setInitialSize(INITIAL_SIZE);
        dataSource.setMaxActive(MAX_ACTIVE);
        dataSource.setMaxIdle(MAX_IDLE);
        dataSource.setMinIdle(MIN_IDLE);
    }

    // 獲取連接
    public static Connection getConnection() throws SQLException {
        return dataSource.getConnection();
    }

    // 釋放連接
    public static void release(Connection conn, Statement st, ResultSet rs) {
        try {
            if (rs != null) {
                rs.close();
            }
            if (st != null) {
                st.close();
            }
            if (conn != null) {
                conn.close();
            }
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }
}

在使用時只需要調用getConnection()方法即可獲取數據庫連接，同時在使用完畢後，應該調用ConnectionUtil的release()方法將連接釋放。這裡需要注意，如果在release()方法中傳入的參數為null，那麼在釋放連接時就會拋出異常。

三、SQL語句執行

JDBCUtils提供了QueryRunner類，可方便地執行SQL語句，同時支持參數綁定和查詢結果映射（使用BeanHandler和BeanListHandler）。以下是一個查詢示例：

public List getUserList() {
    QueryRunner qr = new QueryRunner();
    String sql = "select * from user";
    Connection conn = null;
    try {
        conn = ConnectionUtil.getConnection();
        return qr.query(conn, sql, new BeanListHandler(User.class));
    } catch (SQLException e) {
        e.printStackTrace();
    } finally {
        ConnectionUtil.release(conn, null, null);
    }
    return null;
}

在上述代碼中，首先通過QueryRunner類創建了一個qr實例，並定義了查詢SQL語句；接下來獲取一個數據庫連接conn，並使用qr的query()方法執行查詢操作。其中，第三個參數BeanListHandler是一個結果集處理器，用於將結果集映射成User對象的List集合。最後需要釋放連接。

四、事務處理

JDBCUtils提供了TransactionalQueryRunner類，支持事務處理。在使用TransactionalQueryRunner時，需要使用TransactionManager類來管理事務。

public class TransactionManager {
    private static ThreadLocal tl = new ThreadLocal();

    public static Connection getConnection() throws SQLException {
        Connection conn = tl.get();
        if (conn == null) {
            conn = ConnectionUtil.getConnection();
            tl.set(conn);
        }
        return conn;
    }

    public static void startTransaction() throws SQLException {
        Connection conn = getConnection();
        conn.setAutoCommit(false);
    }

    public static void commit() throws SQLException {
        Connection conn = getConnection();
        conn.commit();
        conn.setAutoCommit(true);
        release();
    }

    public static void rollback() throws SQLException {
        Connection conn = getConnection();
        conn.rollback();
        conn.setAutoCommit(true);
        release();
    }

    public static void release() throws SQLException {
        Connection conn = getConnection();
        conn.close();
        tl.remove();
    }
}

在上述代碼中，定義了getConnection()方法用於獲取數據庫連接，startTransaction()方法用於開啟事務，commit()方法用於提交事務並釋放連接，rollback()方法用於回滾事務並釋放連接，release()方法用於釋放連接。其中，使用了ThreadLocal類來保存連接，確保一個線程只使用一個連接。

接下來看一個事務處理的示例：

public void transferMoney(String sourceName, String targetName, float money) throws SQLException {
    TransactionManager.startTransaction();
    try {
        // 扣除轉出賬戶的金額
        String sql1 = "update account set balance = balance - ? where name = ?";
        queryRunner.update(TransactionManager.getConnection(), sql1, money, sourceName);
        // 增加轉入賬戶的金額
        String sql2 = "update account set balance = balance + ? where name = ?";
        queryRunner.update(TransactionManager.getConnection(), sql2, money, targetName);
        // 提交事務
        TransactionManager.commit();
    } catch (SQLException e) {
        // 回滾事務
        TransactionManager.rollback();
        e.printStackTrace();
    }
}

在上述代碼中，首先開啟事務（在方法的開始處調用startTransaction()方法），接着執行一些數據庫操作，最後需要在try-catch語句中提交事務或回滾事務（在commit()和rollback()方法中），並釋放連接。需要注意的是，如果在try語句塊中出現了異常，那麼需要在catch語句塊中回滾事務。

五、批處理

JDBCUtils提供了BatchQueryRunner類，支持批處理。BatchQueryRunner可以通過addBatch()方法將多個SQL語句添加到批處理中，然後通過executeBatch()方法將這些SQL語句一次性全部執行。

public void batchInsert(List userList) {
    BatchQueryRunner bqr = new BatchQueryRunner();
    String sql = "insert into user(name, age, gender) values(?, ?, ?)";
    Object[][] params = new Object[userList.size()][3];
    for (int i = 0; i < userList.size(); i++) {
        params[i][0] = userList.get(i).getName();
        params[i][1] = userList.get(i).getAge();
        params[i][2] = userList.get(i).getGender();
    }
    try {
        Connection conn = ConnectionUtil.getConnection();
        bqr.batch(conn, sql, params);
    } catch (SQLException e) {
        e.printStackTrace();
    }
}

在上述代碼中，使用BatchQueryRunner類創建了一個bqr實例，並定義了插入SQL語句。然後根據userList列表生成params參數，最後調用batch()方法執行批處理操作。

六、結語

到此為止，我們詳細介紹了JDBCUtils的使用方法，包括數據庫連接管理、SQL語句執行、事務處理和批處理等方面。使用JDBCUtils可以大大簡化JDBC編程，提高開發效率和程序性能。