[TOC]

0 前言

使用java進(jìn)行數(shù)據(jù)庫(kù)操作時(shí)最痛苦的莫過(guò)于拼接SQL語(yǔ)句蚯舱。在實(shí)際運(yùn)行時(shí)往往需要查看<font color='red'>實(shí)際生成的SQL語(yǔ)句</font>和實(shí)際<font color='red'>傳入的參數(shù)</font>，或許還會(huì)有查看SQL<font color='red'>執(zhí)行時(shí)間</font>等的需求昧诱。
無(wú)論原生JDBC晓淀、dbutils、mybatis還是hibernate盏档，使用log4j等日志框架可以看到生成的SQL，但是占位符和參數(shù)總是分開打印的燥爷。實(shí)在是不太友好蜈亩。顯示如下的效果:

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

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

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

1 log4jdbc簡(jiǎn)介

沒(méi)有什么比官網(wǎng)對(duì)它的介紹更加貼切了:
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在國(guó)內(nèi)的訪問(wèn)問(wèn)題……
官網(wǎng)的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. 配置簡(jiǎn)單稚配，一般情況下你只需要將你的DriverClass改為:net.sf.log4jdbc.DriverSpy，并在你的jdbcUrl之前拼接jdbc:log4
3. 自動(dòng)將占位符(?)替換為實(shí)際的參數(shù)
4. 能夠及時(shí)方便地顯示SQL的實(shí)際執(zhí)行時(shí)間
5. 顯示SQL Connection的數(shù)量的信息
6. 能在JDK1.4+和SLF4J1.X上和大多數(shù)常見(jiàn)的JDBC驅(qū)動(dòng)協(xié)同工作
7. open source

3 使用

以下多數(shù)信息來(lái)自于官網(wǎng)

3.0 jar包的選擇

不了解 JDBC3 JDBC4港华？

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

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

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

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

3.2 更改DriverClass

log4jdbc "spy" driver 將會(huì)嘗試著加載以下驅(qū)動(dòng):

<font color="blue">注意:</font> 如果你要使用一個(gè)不在上表中的Driver，請(qǐng)?zhí)峁﹍og4jdbc.drivers配置尊流，多個(gè)之間用逗號(hào)分隔帅戒，不帶空格。

3.3 prepend jdbcUrl屬性

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

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

log4jdbc使用5種logger:

此外還有個(gè)叫 log4jdbc.debug 的 logger瞎访，用于log4jdbc的內(nèi)部調(diào)試，會(huì)輸出 log4jdbc spy 加載驅(qū)動(dòng)的時(shí)的信息吁恍，如driver found 或 not found 等信息装诡。

3.5 修改debug選項(xiàng)--可選

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

4 實(shí)戰(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 測(cè)試

```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

截至目前為止，官網(wǎng) 對(duì)于log4jdbc和數(shù)據(jù)源的使用還沒(méi)有一個(gè)很好地例子,以下是官網(wǎng)的截圖:

log4jdbc對(duì)于數(shù)據(jù)源的說(shuō)明

本人嘗試了一下C3P0數(shù)據(jù)源拓提，不到之處請(qǐng)指正读恃。

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 兩個(gè)配置文件即可，配置同4.0中的配置文件代态。

4.1.2 測(cè)試

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的使用結(jié)合官網(wǎng)的幫助文檔中主要的一部分羅列出來(lái)寺惫。部分不太常用或理解不到位的沒(méi)有翻譯，怕誤人子弟蹦疑，有翻譯不周的地方或理解不到位的地方歡迎指正西雀。
實(shí)戰(zhàn)部分，以后會(huì)抽時(shí)間加入其它的使用方式歉摧。
<font color="red">轉(zhuǎn)載請(qǐng)保留出處艇肴。</font>