在前一篇日志:Java 流行框架(Spring/Struts2/Hibernate/iBatis)都在使用什么日志组件,介绍了当前流行框架 Spring、 Struts2、 Hibernate、iBatis(Mybatis) 分别使用的是什么通用日志组件:

Spring 3.0.4:Commons-Logging
Struts 2.2.1:间接的优先支持 Commons-Logging
Hibernate 3.6.0:直接的使用 Slf4J
iBatis/MyBatis 3.0.2:间接的优先使用 Slf4J

再考虑 Slf4J 以及 Logback 的优越性,性能得到的改善,多 JVM 写同一日志文件都无妨,方便运用于 OSGI 环境,自动压缩日志,参数化。所以个人认为在 SSH 或 SSI 项目中推荐用

Slf4J + Logback 对于 Hibernate 和 iBatis/MyBatis 直接走这条路
jcl-over-slf4j + Logback 对于 Spring 和 Struts2,需用用 jcl-over-slf4j 把 Commons-Logging 桥接到 Slf4J,然后 Logback。

下面介绍在这样的项目中如何使用 Slf4J、继而用 Logback 输出日志。

首先需要引入相关的 jar,如果你是用 Maven 来管理你的依赖,那太简单了,只需要在你的 pom.xml 文件中加入:

<dependency>
<groupId>org.slf4jgroupId>
    <artifactId>slf4j-apiartifactId>
<version>1.6.1version>
dependency>
<dependency>
<groupId>ch.qos.logbackgroupId>
<artifactId>logback-coreartifactId>
<version>0.9.24version>
dependency>
<dependency>
<groupId>ch.qos.logbackgroupId>
<artifactId>logback-classicartifactId>
<version>0.9.24version>
dependency>
<dependency>
<groupId>org.slf4jgroupId>
<artifactId>jcl-over-slf4jartifactId>
<version>1.6.1version>
dependency>

相应的四个 jar 包,slf4j-api-1.6.1、logback-core-0.9.24.jar、logback-classic-0.9.24.jar、jcl-over-slf4j-1.6.1.jar 就会加到你的 classpath 中了。否则必须手工到 http://www.slf4j.org/ 和http://logback.qos.ch/ 去下载相应的包,是不是觉得 http://www.slf4j.org/ 和 http://logback.qos.ch/ 是那么的像,没错它们其实映射在同一个 IP 上的,可见 slf4j + logback 原生的绝配

jcl-over-slf4j-1.6.1.jar 是 Commons-Logging 到 Slf4J 的桥接器,应用 Commons-Logging 的 SPI 模式,只要把它放到 classpath 中就起作用了。机关就是这个包的 META-INF/service/org.apace.commons.logging.LogFactory 文件,内容是:org.apache.commons.logging.impl.SLF4JLogFactory。

接下来配置 logback.xml 文件,logback 也需要像 log4j.properties 那样的配置文件。把 logback.xml 文件放在 classpath 下,内容可参考:

xml version="1.0" encoding="UTF-8"?>
<configuration>
    <appender name="stdout" class="ch.qos.logback.core.ConsoleAppender">
        <filter class="ch.qos.logback.core.filter.EvaluatorFilter">      
            <evaluator> 
                <expression>logger.contains("springframework")expression>
evaluator>
<OnMismatch>NEUTRALOnMismatch>
<OnMatch>DENYOnMatch>
filter>
<encoder charset="UTF-8">
<pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%npattern>
encoder>
appender>  
<appender name="RollingFile" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>unmi_ssh.logfile>
<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
<level>INFOlevel>
filter>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>unmi_ssh.%d{yyyy-MM-dd}..log.zipfileNamePattern>
<minIndex>1minIndex>
<maxIndex>3maxIndex>
rollingPolicy>
<triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
<maxFileSize>5MBmaxFileSize>
triggeringPolicy>
<encoder>
<pattern>%-4relative [%thread] %-5level %logger{35} - %msg%npattern>
encoder>
appender>
<root level="DEBUG">
<appender-ref ref="stdout" />
<appender-ref ref="RollingFile"/>
root>
configuration>

熟悉 log4j 的看到上面的配置应该能够很好的理解,奇怪的是目前还没有 logback.xml 文件的 schema 文件出现,不然在 Eclipse 等 xml 编辑器上可提示出一些标签和属性来。详细的配置可参考:http://logback.qos.ch/manual/index.html。对于输出日志的过滤可以控制的更精细,这点比 log4j 要强,可以用表达式来判断。

需要用上面的 ch.qos.logback.core.filter.EvaluatorFilter 来过滤日志输出,要引用 janino-2.5.16.jar。在 pom.xml 中加上 org.codehaus.janino.janino-2.5.16 的依赖。

应用 Slf4J 和 Logback 了,来写个测试代码:

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
 
/**
* Make use of the slf4j
* @author Unmi
*/
public class TestLog {
 
private static final Logger logger = LoggerFactory.getLogger(TestLog.class);
 
public static void main(String[] args) {
logger.info("Hello {}","TestLogback");
}
}

输出是:00:48:16.984 [main] INFO TestLog - Hello TestLogback

你现在同时可以发现,从 Java 框架输出的日志信息全部按照 logback.xml 中的布局输出,说明它们都经由 Slf4J -> Logback 输出了日志。

你可以继续挖掘,要看它能输出到什么地方就看下它提供了多少种 Appdender,并且 Logback 提供了 Log4J 所没有的 Access 的功能,即可以让你的日志历史信息更直观的展示出来,而不是总是在文本编辑器中来查看。