slf4j入门
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来访问日记的功能。