slf4j入门
农码经神 2010-03-17
log4j的作者CekiGülcü在停止维护log4j后开始新的日志组件的开发，他的新作为日志门面slf4j以及log4j的替代品logback。不过logback至今还没有出1.0的正式版，所以使用率并不算高。反而是slf4j几乎已经称为业界日志的统一接口，在hibernate、mina等很多重要的框架中都有所试用。
slf4j作为日志门面，比之单纯的log4j有很多优点。
诸如下面这样的代码，在log4j中应该很常见
logger.info("this is "+ user.getpasswd());这个是变相的字符串拼接 而利用slf4j作为门面，这句代码可以写完
logger.info("this is {}",user.getpasswd());更符合程序员的逻辑 log4j层次判断也是让我们头疼的问题，slf4j可以完全不用理会这点，诸如if(logger.isdebugenable()){}
这样的代码可以不用在重复出现在我们的代码中
当然，slf4j作为日志门面，可以和很多常见的日志模块相接，在选择添加jar包时选取slf4j-api-1.*.*.jar和对应的日志模块jar包可以了。
简单代码
public class Test{
final Logger logger = LoggerFactory.getLogger(Test.class);
public void log(int index){
logger.info("the input is {}",index);
}
public static void main(String[] args){
Test t = new Test(5);
t.log();
}
}如果想利用slf4j的简单日志功能，就选择slf4j-simple-1.5.10.jar
那这时这段代码输出的日志就是“简单日志”风格的log
[main] INFO test.Test - the input is 5
如果还是喜欢log4j风格，可以选择替换为slf-log4j12-1.5.10.jar，并加上log4j.jar，还是一样的代码，就可以输出log4j风格的日志了
附件附上几个常用的jar包
再有就是项目地址，源码有下载：www.slf4j.org
一.Log4j+commons-logging
JAR包
commons-logging-1.1.jar
log4j-1.2.15.jar
配置文件
commons-logging.properties
log4j.xml
commons-logging.jar包读取commons-logging.properties中指定的log,自动加载日志配置
在commons-logging+log4j组合中commons-logging.properties指定的日志为:
org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JLogger
log4j指定具体日志输出配置
如果未选用commons-logging,可以在启动项目中,主动加载log4j的配置文件
二.Logback+slf4j
JAR包
slf4j-api-1.5.2.jar
logback-classic-0.9.9.jar
logback-core-0.9.9.jar
配置文件
Logback.xml
logback的加载采用编码加载
String logbackCfg = "/config/logback.xml"; URL logURL = new ClassPathResource(logbackCfg).getURL(); ILoggerFactory loggerFactory = LoggerFactory.getILoggerFactory(); LoggerContext loggerContext = (LoggerContext) loggerFactory; loggerContext.shutdownAndReset(); JoranConfigurator configurator = new JoranConfigurator(); configurator.setContext(loggerContext); configurator.doConfigure(logURL);
三.Slf4j+log4j
JAR包
slf4j-api-1.5.2.jar
slf4j-log4j12-1.5.2.jar
log4j-1.2.15.jar
配置文件
Logback.xml
四.Slf4j+logback+logback
注:这种情况下是项目中有log4j输出的日志以及logback数据的日志.老项目改造,log4j和logback共存的情况下.(当选用spring+slf4j+logback的时候,spring的日志输出是log4j的,这个时候采用这种配置.)
JARbao
log4j-over-slf4j-1.5.2.jar
logback-classic-0.9.9.jar
logback-core-0.9.9.jar
slf4j-api-1.5.2.jar
配置文件
Logback.xml
配置加载
String logbackCfg = "/config/logback.xml"; URL logURL = new ClassPathResource(logbackCfg).getURL(); ILoggerFactory loggerFactory = LoggerFactory.getILoggerFactory(); LoggerContext loggerContext = (LoggerContext) loggerFactory; loggerContext.shutdownAndReset(); JoranConfigurator configurator = new JoranConfigurator(); configurator.setContext(loggerContext); configurator.doConfigure(logURL);
五.Log4j配置文件示例
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<!-- 控制台输出-->
<appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
<param name="Target" value="System.out" />
<param name="Threshold" value="INFO" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="%d{yyyy-MM-dd HH:mm:ss sss}[%-p][%-c][line:%-L] \r\n %m%n" />
</layout>
<!— 以下是过滤一些不需要输出的log信息 -->
<filter class="org.apache.log4j.varia.StringMatchFilter">
<param name="StringToMatch" value="new a seq no spend" />
<param name="AcceptOnMatch" value="false" />
</filter>
<filter class="org.apache.log4j.varia.StringMatchFilter">
<param name="StringToMatch" value="new hi[type=" />
<param name="AcceptOnMatch" value="false" />
</filter>
<filter class="org.apache.log4j.varia.StringMatchFilter">
<param name="StringToMatch" value="FileTransfer.execCommand()" />
<param name="AcceptOnMatch" value="false" />
</filter>
</appender>
<!--文件输出 按照文件大小滚动文件-->
<appender name="xxxx_file" class="org.apache.log4j.RollingFileAppender">
<param name="Append" value="true" />
<param name="Threshold" value="INFO" />
<param name="File" value="xxxx.log" />
<param name="MaxFileSize" value="100MB" />
<param name="MaxBackupIndex" value="15" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="%d{yyyy-MM-dd HH:mm:ss sss}[%-p][%-c][line:%-L] \r\n %m%n" />
</layout>
<filter class="org.apache.log4j.varia.StringMatchFilter">
<param name="StringToMatch" value="new a seq no spend" />
<param name="AcceptOnMatch" value="false" />
</filter>
<filter class="org.apache.log4j.varia.StringMatchFilter">
<param name="StringToMatch" value="new hi[type=" />
<param name="AcceptOnMatch" value="false" />
</filter>
<filter class="org.apache.log4j.varia.StringMatchFilter">
<param name="StringToMatch" value="FileTransfer.execCommand()" />
<param name="AcceptOnMatch" value="false" />
</filter>
</appender>
<!-- 错误输出 过滤出错误日志信息-->
<appender name="xxxx_error" class="org.apache.log4j.RollingFileAppender">
<param name="Append" value="true" />
<param name="Threshold" value="ERROR" />
<param name="File" value="xxxx-error.log" />
<param name="MaxFileSize" value="100MB" />
<param name="MaxBackupIndex" value="4" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern"
value="%d{yyyy-MM-dd HH:mm:ss sss}[%-p][%-c][line:%-L] \r\n %m%n" />
</layout>
</appender>
<!-- 根loggr -->
<root>
<appender-ref ref="CONSOLE" />
<appender-ref ref="xxxx_file" />
<appender-ref ref="xxxx_file_error" />
</root>
</log4j:configuration>六.Logback配置文件示例
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration>
<configuration>
<jmxConfigurator />
<!-- 控制台输出日志 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<layout class="ch.qos.logback.classic.PatternLayout">
<pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
</layout>
</appender>
<!-- 文件输出日志 (文件大小策略进行文件输出，超过指定大小对文件备份)-->
<appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<File>xxxx.log</File>
<rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
<FileNamePattern>xxxx.log.%i.bak</FileNamePattern>
<MinIndex>1</MinIndex>
<MaxIndex>12</MaxIndex>
</rollingPolicy>
<triggeringPolicy
class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
<MaxFileSize>100MB</MaxFileSize>
</triggeringPolicy>
<layout class="ch.qos.logback.classic.PatternLayout">
<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</Pattern>
</layout>
</appender>
<appender name="FILE-ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
<filter class="ch.qos.logback.classic.filter.LevelFilter">
<level>ERROR</level>
<OnMismatch>DENY</OnMismatch>
<OnMatch>ACCEPT</OnMatch>
</filter>
<File>xxxx-err.log</File>
<rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
<FileNamePattern>xxxx-err.log.%i.bak</FileNamePattern>
<MinIndex>1</MinIndex>
<MaxIndex>3</MaxIndex>
</rollingPolicy>
<triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
<MaxFileSize>100MB</MaxFileSize>
</triggeringPolicy>
<layout class="ch.qos.logback.classic.PatternLayout">
<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</Pattern>
</layout>
</appender>
<!--这里指定logger name 是为jmx设置日志级别做铺垫 -->
<logger name="com.xxx.xxx">
<level value="INFO" />
<appender-ref ref="STDOUT" />
<appender-ref ref="FILE" />
<appender-ref ref="FILE-ERROR" />
</logger>
</configuration>七.相关简单说明
Log4j
Log4j是Apache的一个开放源代码项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件、甚至是套接口服务器、NT的事件记录器、UNIXSyslog守护进程等；用户也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别，用户能够更加细致地控制日志的生成过程。这些可以通过一个配置文件来灵活地进行配置，而不需要修改程序代码
Slf4j
简单日记门面(Facade)SLF4J是为各种logingAPIs提供一个简单统一的接口，从而使得最终用户能够在部署的时候配置自己希望的logingAPIs实现。LoggingAPI实现既可以选择直接实现SLF4J接的logingAPIs如：NLOG4J、SimpleLogger。也可以通过SLF4J提供的API实现来开发相应的适配器如Log4jLoggerAdapter、JDK14LoggerAdapter。
Logback
Logback是由log4j创始人设计的又一个开源日记组件。logback当前分成三个模块：logback-core,logback-classic和logback-access。logback-core是其它两个模块的基础模块。logback-classic是log4j的一个改良版本。此外logback-classic完整实现SLF4JAPI使你可以很方便地更换成其它日记系统如log4j或JDK14Logging。logback-access访问模块与Servlet容器集成提供通过Http来访问日记的功能。
