Mybatis源码研究4：日志框架的实现

 一、logging包的概述

本包主要依赖了 Mybatis的reflection包的ExceptionUtil和io包的Resources， 以及第三方的Log4j,Slf4j,CommonsLogging。
 
  Mybatis的其它包大量引用了本包中的类和接口，即严重依赖于本包。
 
 
  从Mybatis自身的包和类来看，logging包对其它包仅有少量的依赖，而其它很多包却对logging包有大量的依赖。

  因此，先从logging包讲起。先易后难是制胜之道。
 
 

二、日志框架核心类和接口

 Log接口定义了4种日志级别，
 
 void error(String s);

 void debug(String s);

 void trace(String s);

 void warn(String s);
 
 LogFactory工厂类生成Log接口，准确地说，是生成Log接口的实现。
 
 LogException定义了 日志异常，运行时异常。
 
 
三、日志的7种实现

 

 把日志抽象成Log接口，该接口有7种实现。
  1.Apache Commons Logging
  2.JDBC Logging
  3.Java Util Logging
  4.Log4j
  5.No Logging
  6.Slf4J
  7.Stdout
 
 7种实现分别位于logging包的7个子包中：commons,jdbc,jdk14,log4j,nologging,slf4j,stdout。
 
 
 1.commons包下的JakartaCommonsLoggingImpl使用Apache Commons Logging包实现了Log接口。
 
 2.jdbc包下的类 并没有直接实现Log接口，而是将Log接口作为自身的一个属性。
 
 BaseJdbcLogger:代理类的父类，代理类增加了logging功能。
 
 ConnectionLogger， PreparedStatementLogger， ResultSetLogger，StatementLogger都继承了BaseJdbcLogger，
 实现了InvocationHandler 接口。
 
 ConnectionLogger：Connection的代理类，增加了日志功能。
 
 PreparedStatementLogger：PreparedStatement的代理类，增加了日志功能。
 
 ResultSetLogger：ResultSet的代理类，增加了日志功能。
 
 StatementLogger：Statement的代理类，增加了日志功能。
 
 
 
 3.jdk14包下的Jdk14LoggingImpl 使用java.util.logging.Logger和java.util.logging.Level 2个类实现了Log接口。
 
 4.log4j包下的Log4jImpl 使用 Log4J包实现了 Log接口。
 
 5.nologging包下的NoLoggingImpl 空实现了 Log接口，即Log接口的实现方法没有意义，或者没有任何代码。
 
 6.slf4j包下的Slf4jImpl，Slf4jLocationAwareLoggerImpl，Slf4jLoggerImpl 都使用Slf4J包 实现了 Log接口。
 
 7.stdout包下的StdOutImpl使用 System.err.println(s)和System.out.println(s) 实现了Log接口。
 
 
 
 四、日志工厂

 日志工厂类：LogFactory，提供日志接口的实现。
 
 在静态代码块中 加载所有的log实现类，
 mybatis会按以下顺序依次找有没有这个日志类，找到就用这个日志

SLF4J->Apache Commons Logging->Log4J->JDK logging->No Logging

 

获取Log接口的实现类的方法。
public static Log getLog(Class<?> aClass);

public static Log getLog(String logger) ;

五、值得探讨的几个问题：

在这个工厂类里我们可以非常容易地感觉到“坏味道”:
 
  1.在catch块中什么都不做，这是应该尽量避免出现的情况。
 
  2.在static块中会尝试依次加载所有的log实现类，这点也是值得商榷的。
 
  3.因为在一个系统中一般只使用一种日志实现，一次性加载所有的实现只会带来性能问题；
 
  4.还有一个问题就是是否需要动态切换日志实现的功能，至少我觉得这个功能也是个鸡肋。