随笔 - 1690  文章 - 664 评论 - 460 trackbacks - 0

 背景

       在程序开发过程中,为了调试方便、了解程序的运行过程,进行必要的日志输出总是免不了的。对于使用Mybatis而言,我们常见的需求是希望可以在日志中打印出Mybatis执行过程中进行数据库操作的SQL语句及其传递的参数。Mybatis的日志输出是统一管理的,它有自己的日志接口,然后在需要进行日志输出的时候使用统一的API进行日志输出。这个统一的接口是org.apache.ibatis.logging.Log。Mybatis分别基于常用的日志输出工具给出了对应的实现,比如LOG4J、SLF4J等。默认情况下Mybatis的org.apache.ibatis.logging.LogFactory会按照以下顺序依次判断当前程序下可以使用哪种日志实现,直到找到为止,如果一个实现都没有那就是最后的noLogging了,将采用NoLoggingImpl实现。

Mybatis内置的日志工厂提供日志功能,具体的日志实现有以下几种工具:

  • SLF4J
  • Apache Commons Logging
  • Log4j 2
  • Log4j
  • JDK logging
  • NoLogging

日志简介

mybatis日志定义了一个日志门面LogFactory,在需要使用时调用getLog方法:

private static final Log log = LogFactory.getLog(xxxx.class);
      if (log.isDebugEnabled()) {
        log.debug("。。。。。。。。。。。。。");
      }

从上面可以看到LogFactory决定了使用哪个日志体系

  static {
    tryImplementation(LogFactory::useSlf4jLogging);
    tryImplementation(LogFactory::useCommonsLogging);
    tryImplementation(LogFactory::useLog4J2Logging);
    tryImplementation(LogFactory::useLog4JLogging);
    tryImplementation(LogFactory::useJdkLogging);
    tryImplementation(LogFactory::useNoLogging);
  }

具体使用哪个,可以在Settings中配置

初始化日志实现

深入源码

废话不多,直接上流程图

 

 

 

从流程图上看:

1.构建SqlSessionFactory时,加载配置文件。

2.调用XMLConfigBuilder的parse方法,解析配置文件

 

 

 3.加载实例,配置到Configuration类中

 

 

 4.调用LogFactory,并设置实例

 

 

 5.将实例赋值给Log

 

 

 总结

除了上面提到的几个日志实现类,还有打印sql的日志。

Mybatis的日志输出可以输出数据库连接的获取、释放信息;

可以输出执行的SQL语句及其传递的预编译参数信息;

可以输出查询结果集信息(需要是trace输出级别,其它的是DEBUG级别);

Mybatis的日志输出实现是通过JDK的动态代理来实现的,针对Connection的日志输出提供了ConnectionLogger;

针对Statement提供了StatementLogger;针对PreparedStatement提供了PreparedStatementLogger;

针对ResultSet提供了ResultSetLogger,这些Logger类都是实现了JDK的InvocationHandler类的。

 注意:如果你的应用部署在一个包含Commons Logging的环境, 而你又想用其他的日志框架,你可以根据需要调用如下的某一方法:

org.apache.ibatis.logging.LogFactory.useSlf4jLogging();
org.apache.ibatis.logging.LogFactory.useLog4JLogging();
org.apache.ibatis.logging.LogFactory.useJdkLogging();
org.apache.ibatis.logging.LogFactory.useCommonsLogging();
org.apache.ibatis.logging.LogFactory.useStdOutLogging();

 

posted on 2020-05-09 10:22  一天不进步,就是退步  阅读(366)  评论(0编辑  收藏