velocity源码分析：初始化之日志系统

之前在“velocity源码分析：velocity初始化”文章中粗略地介绍了velocity整体的初始化过程，包括各个系统的初始化，本文主要介绍日志系统初始化。

日志系统类图：

概要：

1.调用：velocity源码中这种封装方式我个人是比较赞同的，也是相当容易扩展，对于日志系统之外的内容只需要关注Log（进行日志操作），LogManager（日志系统初始化）即可；

2.日志系统扩展：目前该套代码包含了大部分的日志记录方式，假设以后新增一种记录方式，只要添加对应的Chute并实现LogChute接口即可；

3.日志记录方式扩展：LogDisplayWrapper已经很好的实现了扩展，对于日志，新增一些标识，该类完全足够；

说明：

Velocity在初始化时调用RuntimeInstance.initializeLog()进行日志系统的初始化。

该方法调用如下代码，传入日志系统接口类和配置信息初始化。

LogManager.updateLog(this.log, this);

方法具体实现：

public static void updateLog(Log log, RuntimeServices rsvc) throws Exception { // create a new LogChute using the RuntimeServices LogChute newLogChute = createLogChute(rsvc); LogChute oldLogChute = log.getLogChute(); // pass the new LogChute to the log first, // (if the old was a HoldingLogChute, we don't want it // to accrue new messages during the transfer below) log.setLogChute(newLogChute); // If the old LogChute was the pre-Init logger, // dump its messages into the new system. if (oldLogChute instanceof HoldingLogChute) { HoldingLogChute hlc = (HoldingLogChute)oldLogChute; hlc.transferTo(newLogChute); } }

1.创建LogChute：

LogChute的创建采用反射的方式初始化配置文件中定义

runtime.log.logsystem 和

runtime.log.logsystem.class

的内容。看看一下velocity自带的配置文件：

runtime.log.logsystem.class = org.apache.velocity.runtime.log.Log4JLogChute,org.apache.velocity.slf4j.Slf4jLogChute,org.apache.velocity.runtime.log.CommonsLogLogChute,org.apache.velocity.runtime.log.ServletLogChute,org.apache.velocity.runtime.log.JdkLogChute # --------------------------------------------------------------------------- # This is the location of the Velocity Runtime log. # ---------------------------------------------------------------------------- runtime.log = velocity.log
默认不配置runtime.log.losystem,但配置了对应class列表，该列表的初始化顺序是：

org.apache.velocity.runtime.log.Log4JLogChute, org.apache.velocity.slf4j.Slf4jLogChute, org.apache.velocity.runtime.log.CommonsLogLogChute, org.apache.velocity.runtime.log.ServletLogChute,org. apache.velocity.runtime.log.JdkLogChute默认初始化log4日志。 当一个日志系统能获取后就丢弃其他信息

2.替换日志系统：

RuntimeInstance代码中有成员变量：private Log log = new Log();初始化默认的日志系统。

Log()代码：

public Log() { setLogChute(new HoldingLogChute()); }
可以发现，RuntimeInstance在初始化日志系统之前，默认使用HoldingLogChute()。

再看初始化LogManager.updateLog方法，该方法在初始化log系统之后先把原先的日志信息记录下来，如果原先采用的是HoldingLogChute，则把原先记录的信息写到新的日志系统中。

这是个很简单但很有用的日志系统信息交换的方式。

至此：RuntimeInstance中：

private Log log = new Log();

初始化好了，至于
private ExtendedProperties overridingProperties = null;
在调用时作初始化