iBatis使用log4j2输出日志

原文连接这里java

iBatis是一个老项目,2.3.4.726版本发布以后,项目更名为MyBatis,项目主页目前为http://mybatis.github.io/。git

我从08年开始接触iBatis,一直使用2.3.4.726版本,直至当前的项目。iBatis恰到好处的知足了项目组在ORM、SQL维护方面的需求,因此也一直懒得换成其它同类开源软件,好比MyBatis。github

最近参与新的项目开发,一切都要从零开始。为了节省时间,我直接把原项目中数据库相关操做的代码拿过来使用,发现遇到一个问题。新项目基于log4j2来输出日志,我按照求配置了iBatis相关的日志记录器以后,发现SQL执行时没有任何日志输出。iBatis在日志中输出拼装后的SQL、绑定的变量、查询返回的结果等,这对我来讲是极为有用的特性,如今新项目中相关的日志都消失了,那分析SQL的正确性时就只好靠猜了。项目进度比较紧,我一开始没有时间去仔细考虑日志的问题。
好在紧急需求很快就搞定了,我终于有相对充足的时间来解决这个iBatis日志不输出的问题。项目里使用的log4j2配置文件不方便直接贴出来,精简以后以下

<?xml version="1.0" encoding="UTF-8"?>
<configuration status="OFF">
<appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</appenders>
<loggers>
<logger name="java.sql" level="debug" additivity="false">
<appender-ref ref="Console"/>
</logger>
<root level="debug">
<appender-ref ref="Console"/>
</root>
</loggers>
</configuration>

根据官网的资料,我反复对比过几回,确认配置文件没有问题,应该是其它地方出了问题。sql

找到iBatis的源码,打开iBatis建立日志记录器的类com.ibatis.common.logging.LogFactory,这个类是日志记录器的构造器工厂类,有以下的一段代码,用来定义查找日志记录器的顺序。

static
{
tryImplementation("org.apache.commons.logging.LogFactory", "com.ibatis.common.logging.jakarta.JakartaCommonsLoggingImpl");
tryImplementation("org.apache.log4j.Logger", "com.ibatis.common.logging.log4j.Log4jImpl");
tryImplementation("java.util.logging.Logger", "com.ibatis.common.logging.jdk14.Jdk14LoggingImpl");
tryImplementation("java.lang.Object", "com.ibatis.common.logging.nologging.NoLoggingImpl");
}

从这段代码能够看出,iBatis支持四种记录器,分别是:数据库

  • commons-logging
  • apache-log4j
  • JDK原生的Log系统
  • 空记录器,不记录日志

看到这段代码的时候,我秀逗的大脑忽然快速转动起来。在以前的项目时,iBatis和log4j配合能够正常输出日志,缘由是iBatis针对log4j实现了专门的日志记录器构造工厂;当前的这个项目基于log4j2,iBatis没有专门定制的日志记录器工厂类,因此日志没法正常输出。想到这里,日志不能输出的缘由找到了,但怎么让iBatis的日志恢复正常,我踌躇了很久。考虑要不要修改iBatis的源码,仿照com.ibatis.common.logging.log4j.Log4jImpl新写一个新的日志记录器的构造器。犹豫了半天,想一想仍是算了,我却是不惧怕修改iBatis的源码,以前参与过的一个项目里,已经为了修改另外的问题修改过iBatis的源码,编译环境什么的都还在;为了新项目修改点源码根本不是事情,可是考虑到项目正式发布时可能要作开源软件扫描和整改,我就怂了,仍是少给本身找点事情吧。
从新回到iBatis建立日志记录器工厂类的代码,琢磨半天,猜测commons-logging也许是一个突破口。假如可以经过扩展commons-logging的构造工厂来搞定问题的话,项目里不须要增长新的依赖,由于项目的lib目录下已经有commons-logging相关的jar文件了。
感谢CSDN上不知名的热心网友,我找到一份commons-logging的配置说明,按照说明在项目的代码根路径下增长了commons-logging.properties文件,内容以下

org.apache.commons.logging.Log=ibatis.Log4j2Impl

这个ibatis.Log4j2Impl类先占位,具体实现网友的那份说明里没写,惟一了解的信息是类Log4j2Impl须要实现接口org.apache.commons.logging.Log,但如何实现不清楚。好在项目里有一些开源软件使用commons-logging来记录日志,在eclipse里针对org.apache.commons.logging.Log接口按F4,查找当前已实现了接口的类,发现commons-logging自带的org.apache.commons.logging.impl.Jdk14Logger可供参考,因此直接把相关的代码抄到ibatis.Log4j2Impl里,解决掉几个编译问题以后,工厂类就大功告成,接下来就是验证iBatis是否能够正常输出。
基于iBatis写个简单的测试类,代码以下

package ibatis;
apache

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;mybatis

import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;app

import com.ibatis.sqlmap.client.SqlMapClient;
import com.ibatis.sqlmap.client.SqlMapClientBuilder;eclipse

public class Test {测试

private static Logger logger = LogManager.getLogger(Test.class);
public static void main(String[] args) throws Exception {
SqlMapClient sqlMapClient = SqlMapClientBuilder.buildSqlMapClient(Test.class.getClassLoader().getResourceAsStream("sql-map-config.xml"));
logger.info("before query");
sqlMapClient.queryForList("User.selectSubscriberInfo");
logger.info("succeed to query");
}
}

在eclipse里执行这段代码,终于看到了久违的SQL运行日志。