[TOC]

0 前言

使用java進行數據庫操作時最痛苦的莫過于拼接SQL語句。在實際運行時往往需要查看<font color='red'>實際生成的SQL語句</font>和實際<font color='red'>傳入的參數</font>，或許還會有查看SQL<font color='red'>執(zhí)行時間</font>等的需求。
無論原生JDBC、dbutils、mybatis還是hibernate，使用log4j等日志框架可以看到生成的SQL，但是占位符和參數總是分開打印的。實在是不太友好。顯示如下的效果:

select * from t_user where age>? and (sex=? or dept_id=?)

<font color='red'>log4jdbc</font>能很好的解決上述問題。使用log4jdbc之后的效果如下:

select * from t_user where age>1 and (sex=0 or dept_id='007')

1 log4jdbc簡介

沒有什么比官網對它的介紹更加貼切了:
log4jdbc is a Java JDBC driver that can log SQL and/or JDBC calls (and optionally SQL timing information) for other JDBC drivers using the Simple Logging Facade For Java (SLF4J) logging system.
但是，眾所周知googlecode在國內的訪問問題……
官網的News一欄有如下消息:

2015-03-30: Due to Google Code shutting down soon, log4jdbc has moved to github at 2015-03-30: Due to Google Code shutting down soon, log4jdbc has moved to github at https://github.com/arthurblake/log4jdbc

2 特性

1. 完全支持JDBC3和JDBC4
2. 配置簡單，一般情況下你只需要將你的DriverClass改為:net.sf.log4jdbc.DriverSpy，并在你的jdbcUrl之前拼接jdbc:log4
3. 自動將占位符(?)替換為實際的參數
4. 能夠及時方便地顯示SQL的實際執(zhí)行時間
5. 顯示SQL Connection的數量的信息
6. 能在JDK1.4+和SLF4J1.X上和大多數常見的JDBC驅動協(xié)同工作
7. open source

3 使用

以下多數信息來自于官網

3.0 jar包的選擇

不了解 JDBC3 JDBC4？

3.1 日志系統(tǒng)的選擇

log4jdbc 使用Simple Logging Facade for Java (SLF4j) 作為日志系統(tǒng)，(SLF4J)是一個簡單靈活的日志抽象層，可以方便的在以下日志系統(tǒng)之間切換:

• Log4j
• java.util logging in JDK 1.4
• logback
• Jakarta Commons Logging

下載 SLF4j，你將需要slf4j-api-1.5.0.jar和你實際所用的日志系統(tǒng)的jar包，或許還會有一個適配的中間插件jar包(取決于你使用的實際日志系統(tǒng))。

3.2 更改DriverClass

log4jdbc "spy" driver 將會嘗試著加載以下驅動:

<font color="blue">注意:</font> 如果你要使用一個不在上表中的Driver，請?zhí)峁﹍og4jdbc.drivers配置，多個之間用逗號分隔，不帶空格。

3.3 prepend jdbcUrl屬性

例如:
你的url為: url= <font color="blue">jdbc:mysql://localhost:3306/mvn</font>
應該改為: url= <font color="blue"><font color="red">jdbc:log4</font>jdbc:mysql://localhost:3306/mvn</font>

3.4 建立你的日志系統(tǒng)

log4jdbc使用5種logger:

此外還有個叫 log4jdbc.debug 的 logger，用于log4jdbc的內部調試，會輸出 log4jdbc spy 加載驅動的時的信息，如driver found 或 not found 等信息。

3.5 修改debug選項--可選

可以在類路徑下提供一個名為 <font color="blue">log4jdbc.properties </font>的配置文件，用以修改一些默認的debug屬性。
其常用屬性如下(來自于 官網 文檔):

4 實戰(zhàn)

4.0 純JDBC--log4j

4.0.0 jar包

maven 依賴

<dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.4</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.googlecode.log4jdbc</groupId>
            <artifactId>log4jdbc</artifactId>
            <version>1.2</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.35</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.16</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.6.0</version>
        </dependency>
    </dependencies>

4.0.1 配置文件

1. log4j.properties

   log4j.logger.jdbc.sqlonly=OFF
   log4j.logger.jdbc.sqltiming=INFO
   log4j.logger.jdbc.audit=OFF
   log4j.logger.jdbc.resultset=OFF
   log4j.logger.jdbc.connection=OFF
   
   log4j.logger.jdbc.sqlonly=console
   log4j.appender.console=org.apache.log4j.ConsoleAppender
   log4j.appender.console.layout=org.apache.log4j.PatternLayout
   log4j.appender.console.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss.SSS} %m%n%n
   #log4j.logger.jdbc.sqltiming=INFO,console 
   #log4j.logger.jdbc.connection=INFO,console
   
   log4j.rootLogger=DEBUG, console
   

2. dbconfig.properties

   url:jdbc:log4jdbc:mysql://localhost:3306/mvn
   driverClassName:net.sf.log4jdbc.DriverSpy
   username:root
   password:root
   

3. log4jdbc.properties

   log4jdbc.debug.stack.prefix=software_test.log4jdbc
   log4jdbc.drivers=com.mysql.jdbc.Driver
   log4jdbc.auto.load.popular.drivers=true
   
   log4jdbc.statement.warn=true
   log4jdbc.sqltiming.warn.threshold=1000
   log4jdbc.sqltiming.error.threshold=3000
   log4jdbc.dump.booleanastruefalse=true
   log4jdbc.dump.sql.maxlinelength=90
   log4jdbc.dump.fulldebugstacktrace=false
   
   log4jdbc.dump.sql.select=true
   log4jdbc.dump.sql.insert=true
   log4jdbc.dump.sql.delete=true
   log4jdbc.dump.sql.update=true
   log4jdbc.dump.sql.create=true
   log4jdbc.dump.sql.addsemicolon=false
   
   log4jdbc.trim.sql=true
   log4jdbc.trim.sql.extrablanklines=true
   log4jdbc.suppress.generated.keys.exception=false
   

4.0.2 測試

```java
import java.io.IOException;
import java.io.InputStream;
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.PreparedStatement;
import java.sql.SQLException;
import java.util.Properties;

import org.junit.Test;

public class SimpleTest {

    @Test
    public void test1() {
        String sql = "select * " + "from t_user where id=?";
        Connection conn = null;
        PreparedStatement ps = null;
        try {
            conn = getConnection();
            ps = conn.prepareStatement(sql);
            ps.setInt(1, 2);
            ps.executeQuery();
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        } catch (SQLException e) {
            e.printStackTrace();
        }
    }

    public Connection getConnection() throws IOException, SQLException,
            ClassNotFoundException {
        String driverClassName = null;
        String jdbcUrl = null;
        String user = null;
        String password = null;
        // 讀取類路徑下的配置文件
        InputStream in = getClass().getClassLoader().getResourceAsStream(
                "dbconfig.properties");
        Properties properties = new Properties();
        properties.load(in);
        driverClassName = properties.getProperty("driverClassName");
        jdbcUrl = properties.getProperty("url");
        user = properties.getProperty("username");
        password = properties.getProperty("password");
        Class.forName(driverClassName);
        // 連接信息
        Properties info = new Properties();
        info.put("user", user);
        info.put("password", password);
        // 獲取連接
        Connection connection = DriverManager.getConnection(jdbcUrl, user,
                password);
        return connection;
    }
}
```

4.1 DataSource--c3p0

截至目前為止，官網 對于log4jdbc和數據源的使用還沒有一個很好地例子,以下是官網的截圖:

log4jdbc對于數據源的說明

本人嘗試了一下C3P0數據源，不到之處請指正。

4.1.0 jar包

maven 依賴

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.4</version>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>com.googlecode.log4jdbc</groupId>
            <artifactId>log4jdbc</artifactId>
            <version>1.2</version>
        </dependency>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.35</version>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.16</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.6.0</version>
        </dependency>
        <dependency>
            <groupId>c3p0</groupId>
            <artifactId>c3p0</artifactId>
            <version>0.9.1.2</version>
        </dependency>
    </dependencies>

4.1.1 配置文件

此處只需要 log4j.properties 和log4jdbc.properties 兩個配置文件即可，配置同4.0中的配置文件。

4.1.2 測試

package software_test.log4jdbc;

import java.sql.Connection;
import java.sql.PreparedStatement;

import org.junit.Test;

import com.mchange.v2.c3p0.ComboPooledDataSource;

public class DataSourceTest {

    @Test
    public void testC3P0() {
        try {
            ComboPooledDataSource dataSource = new ComboPooledDataSource();
            dataSource.setUser("root");
            dataSource.setPassword("1234");
            dataSource.setDriverClass("net.sf.log4jdbc.DriverSpy");
            dataSource.setJdbcUrl("jdbc:log4jdbc:mysql://localhost:3306/mvn");
            dataSource.setMaxPoolSize(50);
            Connection conn = dataSource.getConnection();
            String sql = "select * " + "from t_user where id=?";
            PreparedStatement ps = null;
            ps = conn.prepareStatement(sql);
            ps.setInt(1, 2);
            ps.executeQuery();
            ps.close();
            conn.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

5 聲明

在此將log4jdbc的使用結合官網的幫助文檔中主要的一部分羅列出來。部分不太常用或理解不到位的沒有翻譯，怕誤人子弟，有翻譯不周的地方或理解不到位的地方歡迎指正。
實戰(zhàn)部分，以后會抽時間加入其它的使用方式。
<font color="red">轉載請保留出處。</font>