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

diaoyudao

　　一、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.还有一个问题就是是否需要动态切换日志实现的功能，至少我觉得这个功能也是个鸡肋。