java日志框架slf4j与log4j的使用与配置.doc

java日志框架slf4j与log4j的使用与配置日志记录自然是非常重要的，但恐怕能记住slf4j与log4j等日志框架配置的人就很少了，这个东西不难，只是配置好后很少会去动它，开发新项目一般也是从其他项目拷贝，或者参照文档废话不多说，先说log4j，使用log4j只要简单的几步首先，弄到log4j的jar包，maven工程配置以下依赖就行，或者，从阿里的maven仓库下载jar包，添加到工程的“build path” log4j log4j 1.2.17然后，整一个perties，内容以下面的为例，不明白不要紧，后面会详细介绍这个东西，这是log4j配置的重点log4j.rootLogger=INFO,.apache=true#consolelog4j.appender.console=org.apache.log4j.ConsoleAppenderlog4j.appender.console.Threshold=INFOlog4j.appender.console.ImmediateFlush=truelog4j.appender.console.Target=System.outlog4j.appender.console.layout=org.apache.log4j.PatternLayoutlog4j.appender.console.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %p %m%n最后，在代码中使用package com.xmyself.log4j;import org.apache.log4j.Logger;public class Main public static void main(String args) new Test().test(); class Test final Logger log = Logger.getLogger(Test.class); public void test() (hello this is log4j info log); 运行main方法，日志信息就出来了12016-12-01 21:23:29 INFO hello this is log4j info log问题也来了，perties要放在哪里才能被解析呢？一、配置perties路径解析perties具体内容的肯定是log4j的jar包中的类，至于是哪个类我就不去研究了，那perties要放在哪以及怎样配置才能被解析呢？不同工程类型配置方式不同1、普通java工程或spring工程这是最常见的java工程类型，写demo用的多，把perties放在src/main/java目录（也就是包所在的根目录）运行main方法就看到日志了，终于整出了一个完整的log4j的demo！ 2、spring mvc工程web工程里用spring mvc构建的比较多了，把perties放在src/main/resources的conf目录（web工程配置文件通常在resources或WEB-INF目录），编辑web.xml，添加 log4jConfigLocation classpath:/conf/perties org.springframework.web.util.Log4jConfigListener3、普通web工程没有了spring提供的listener加载perties，我们要怎么加载这个文件呢？同样，把perties放在src/main/resources的conf目录，我们整一个servlet来加载public class Log4jServlet extends HttpServlet private static final long serialVersionUID = 1L; public void init(ServletConfig config) throws ServletException String prefix = this.getClass().getClassLoader().getResource(/).getPath(); String path = config.getIParameter(log4j-path); PropertyConfigurator.configure(prefix + path); public void doGet(HttpServletRequest req, HttpServletResponse res) throws IOException, ServletException public void doPost(HttpServletRequest req, HttpServletResponse res) throws IOException, ServletException public void destroy() 然后配置servlet随着web工程启动而初始化，编辑web.xml，添加 log4j com.xmyself.log4j.Log4jServlet log4j-path conf/perties 1看着是不是和spring mvc的很像，甚至你也想到了，普通java工程没有指定perties的路径，那说明log4j的jar包一定有一个默认的路径。另外，建议，log4j的配置放在第一个，因为后续加载其他组件就要开始使用日志记录了现在，你可以在多种类型的java工程中打出日志了，但都是控制台的日志，输出内容也很有限，下面我们就来详细介绍perties内容怎么配置二、配置perties内容接下来介绍的内容看起来独立，其实相互关联，并且很有规律，我们要输出日志，首先得有日志对象（logger），那这些日志对象把日志输出到哪里呢，控制台还是文件，这就要设置输出位置（appender），输出的格式与内容又是什么样的呢，这就要设置输出样式（layout），这些设置完，log4j的配置也就完了1、日志等级log4j日志分为7个等级：ALL、DEBUG、INFO、WARN、ERROR、FATAL、OFF，但是，建议只使用“DEBUG”到“ERROR”四个等级，从“ALL”到“OFF”等级由低到高，明白这一点很重要，因为设置了输出日志等级之后，只有等级等于或高于该等级的日志才会输出，例如，输出日志等级设置为“INFO”，“DEBUG”级别的日志将不会输出2、logger日志实例，就是代码里实例化的Logger对象log4j.rootLogger=LEVEL,appenderName1,appenderName2,..apache=false：表示不会在父logger的appender里输出，默认true这是全局logger的配置，LEVEL用来设定日志等级，appenderName定义日志输出器，示例中的“console”就是一个日志输出器下面给出一个更清晰的例子，配置“com.demo.test”包下所有类中实例化的Logger对象.demo.test=DEBUG,.demo.test=false3、appender日志输出器，指定logger的输出位置1log4j.appender.appenderName=classNameappender有5种选择org.apache.log4j.ConsoleAppender（控制台）org.apache.log4j.FileAppender（文件）org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件）org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）每种appender都有若干配置项，下面逐一介绍ConsoleAppender（常用）Threshold=WARN：指定日志信息的最低输出级别，默认DEBUGImmediateFlush=true：表示所有消息都会被立即输出，设为false则不输出，默认值是trueTarget=System.err：默认值是System.outFileAppenderThreshold=WARN：指定日志信息的最低输出级别，默认DEBUGImmediateFlush=true：表示所有消息都会被立即输出，设为false则不输出，默认trueAppend=false：true表示消息增加到指定文件中，false则将消息覆盖指定的文件内容，默认trueFile=D:/logs/logging.log4j：指定消息输出到logging.log4j文件DailyRollingFileAppender（常用）Threshold=WARN：指定日志信息的最低输出级别，默认DEBUGImmediateFlush=true：表示所有消息都会被立即输出，设为false则不输出，默认trueAppend=false：true表示消息增加到指定文件中，false则将消息覆盖指定的文件内容，默认trueFile=D:/logs/logging.log4j：指定当前消息输出到logging.log4j文件DatePattern=.yyyy-MM：每月滚动一次日志文件，即每月产生一个新的日志文件。当前月的日志文件名为logging.log4j，前一个月的日志文件名为logging.log4j.yyyy-MM另外，也可以指定按周、天、时、分等来滚动日志文件，对应的格式如下：1).yyyy-MM：每月2).yyyy-ww：每周3).yyyy-MM-dd：每天4).yyyy-MM-dd-a：每天两次5).yyyy-MM-dd-HH：每小时6).yyyy-MM-dd-HH-mm：每分钟RollingFileAppenderThreshold=WARN：指定日志信息的最低输出级别，默认DEBUGImmediateFlush=true：表示所有消息都会被立即输出，设为false则不输出，默认trueAppend=false：true表示消息增加到指定文件中，false则将消息覆盖指定的文件内容，默认trueFile=D:/logs/logging.log4j：指定消息输出到logging.log4j文件MaxFileSize=100KB：后缀可以是KB,MB或者GB。在日志文件到达该大小时，将会自动滚动，即将原来的内容移到logging.log4j.1文件MaxBackupIndex=2：指定可以产生的滚动文件的最大数，例如，设为2则可以产生logging.log4j.1，logging.log4j.2两个滚动文件和一个logging.log4j文件4、layout指定logger输出内容及格式1log4j.appender.appenderName.layout=classNamelayout有4种选择org.apache.log4j.HTMLLayout（以HTML表格形式布局）org.apache.log4j.PatternLayout（可以灵活地指定布局模式）org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串）org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等信息）layout也有配置项，下面具体介绍HTMLLayout12LocationInfo=true：输出java文件名称和行号，默认falseTitle=My Logging： 默认值是Log4J Log MessagesPatternLayout（最常用的配置）1ConversionPattern=%m%n：设定以怎样的格式显示消息设置格式的参数说明如下%p：输出日志信息的优先级，即DEBUG，INFO，WARN，ERROR，FATAL%d：输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，如：%dyyyy/MM/dd HH:mm:ss,SSS%r：输出自应用程序启动到输出该log信息耗费的毫秒数%t：输出产生该日志事件的线程名%l：输出日志事件的发生位置，相当于%c.%M(%F:%L)的组合，包括类全名、方法、文件名以及在代码中的行数%c：输出日志信息所属的类目，通常就是类全名%M：输出产生日志信息的方法名%F：输出日志消息产生时所在的文件名%L：输出代码中的行号%m：输出代码中指定的具体日志信息%n：输出一个回车换行符，Windows平台为rn，Unix平台为n%x：输出和当前线程相关联的NDC(嵌套诊断环境)，尤其用到像java servlets这样的多客户多线程的应用中%：输出一个%字符#另外，还可以在%与格式字符之间加上修饰符来控制其最小长度、最大长度、和文本的对齐方式。如：1)c：指定输出category的名称，最小的长度是20，如果category的名称长度小于20的话，默认的情况下右对齐2)%-20c：-号表示左对齐3)%.30c：指定输出category的名称，最大的长度是30，如果category的名称长度大于30的话，就会将左边多出的字符截掉，但小于30的话也不会补空格5、完整示例介绍完配置，我们开始配置了，首先弄几个日志输出器12log4j.rootLogger=DEBUG,console,dailyFile,rollingFile,logF.apache=true然后一个一个的配置控制台console日志输出器# 控制台(console)log4j.appender.console=org.apache.log4j.ConsoleAppenderlog4j.appender.console.Threshold=DEBUGlog4j.appender.console.ImmediateFlush=truelog4j.appender.console.Target=System.errlog4j.appender.console.layout=org.apache.log4j.PatternLayoutlog4j.appender.console.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %p %m%n文件logFile日志输出器# 日志文件(logFile)log4j.appender.logFile=org.apache.log4j.FileAppenderlog4j.appender.logFile.Threshold=DEBUGlog4j.appender.logFile.ImmediateFlush=truelog4j.appender.logFile.Append=truelog4j.appender.logFile.File=D:/logs/log.log4jlog4j.appender.logFile.layout=org.apache.log4j.PatternLayoutlog4j.appender.logFile.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %p %m%n滚动文件rollingFile日志输出器# 滚动文件(rollingFile)log4j.appender.rollingFile=org.apache.log4j.RollingFileAppenderlog4j.appender.rollingFile.Threshold=DEBUGlog4j.appender.rollingFile.ImmediateFlush=truelog4j.appender.rollingFile.Append=truelog4j.appender.rollingFile.File=D:/logs/log.log4jlog4j.appender.rollingFile.MaxFileSize=200KBlog4j.appender.rollingFile.MaxBackupIndex=50log4j.appender.rollingFile.layout=org.apache.log4j.PatternLayoutlog4j.appender.rollingFile.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %p %m%n定期滚动文件dailyFile日志输出器# 定期滚动日志文件(dailyFile)log4j.appender.dailyFile=org.apache.log4j.DailyRollingFileAppenderlog4j.appender.dailyFile.Threshold=DEBUGlog4j.appender.dailyFile.ImmediateFlush=.dailyFile.Append=truelog4j.appender.dailyFile.File=D:/logs/log.log4jlog4j.appender.dailyFile.DatePattern=.yyyy-MM-ddlog4j.appender.dailyFile.layout=org.apache.log4j.PatternLayoutlog4j.appender.dailyFile.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %p %m%n6、局部日志上述方式的日志配置是全局配置，所有代码使用同一套日志配置，实际项目却并非如此，项目中运行日志、数据库访问日志等等通常不会输出到同一个文件。如何让不同的包、类输出不同的日志，甚至同一个类输出不同的日志？答案是，为它们指定单独的日志输出器.demo.test=DEBUG,testlog4j.appender.test=org.apache.log4j.FileAppenderlog4j.appender.test.File=/log/test.loglog4j.appender.test.layout=org.apache.log4j.PatternLayoutlog4j.appender.test.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %p %m%n为“com.demo.test”包指定日志输出器“test”也可以让同一个类输出不同的日志private static Log logger1 = LogFactory.getLog(myTest1);private static Log logger2 = LogFactory.getLog(myTest2);需要在该类中创建两个logger，然后分别配置log4j.logger.myTest1= DEBUG,test1log4j.additivity.myTest1=falselog4j.appender.test1=org.apache.log4j.FileAppenderlog4j.appender.test1.File=/log/test1.loglog4j.appender.test1.layout=org.apache.log4j.PatternLayoutlog4j.appender.test1.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %p %m%n log4j.logger.myTest2=DEBUG,test2log4j.appender.test2=org.apache.log4j.FileAppenderlog4j.appender.test2.File=/log/test2.loglog4j.appender.test2.layout=org.apache.log4j.PatternLayoutlog4j.appender.test2.layout.ConversionPattern=%dyyyy-MM-dd HH:mm:ss %p %m%n三、slf4j与log4jslf4j是什么？slf4j只是定义了一组日志接口，但并未提供任何实现，既然这样，为什么要用slf4j呢？log4j不是已经满足要求了吗？是的，log4j满足了要求，但是，日志框架并不只有log4j一个，你喜欢用log4j，有的人可能更喜欢logback，有的人甚至