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

相关推荐