log4j入门教程

目录

正文

1. 导入log4j的jar

• log4j的下载链接
• 新建一个lib文件夹，把jar包放进去，右键buildpath->add to build path添加jar包就可以使用了

2. 编写log4j.properties文件

2.0 该文件要放在src的目录下

2.1 logger的编写

• log4j.rootLogger = [ level ] , appenderName, appenderName, …
  level是控制日志的输出级别，低于这个级别的不会输出。
  appenderName 就是指日志信息输出到哪个地方

2.2 appender的编写

• log4j.appender.appenderName = 参数
• 参数：
  1.org.apache.log4j.ConsoleAppender （控制台） 2.org.apache.log4j.FileAppender （文件），
  3.org.apache.log4j.DailyRollingFileAppender （每天产生一个日志文件），
  4.org.apache.log4j.RollingFileAppender （文件大小到达指定尺寸的时候产生一个 新的文件）
  5.org.apache.log4j.WriterAppender （将日志信息以流格式发送到任意指定的地方）

2.3 layout的编写

• log4j.appender.appenderName.layout = 参数
• 参数：
  org.apache.log4j.HTMLLayout（以HTML表格形式布局），
  org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
  org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），
  org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）

2.4 patter的编写

• log4j.appender.log.layout.ConversionPattern = 参数
• 参数：
  例：（[%-5p] %t %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l %m%n）
  %m 输出代码中指定的消息
  %p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL
  %r 输出自应用启动到输出该log信息耗费的毫秒数
  %c 输出所属的类目，通常就是所在类的全名
  %t 输出产生该日志事件的线程名
  %n 输出一个回车换行符，Windows平台为“/r/n”，Unix平台为“/n”
  %d 输出日志时间点的日期或时间。
  默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss , SSS}，输出类似：2002年10月18日 22 ： 10 ： 28 ， 921
  %l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。（大小写是有区别的，一帮用小写的）

2.5其他参数

//表示输出到的文件
log4j.appender.appenderName.File = log/log.log 
//追加的方式输出 
log4j.appender.appenderName.Append = true
//表示低于这个级别的不输出到appenderName  
log4j.appender.appenderName.Threshold = ERROR  

3.代码的使用

3.1 制定配置文件路径

如果不适用默认的文件名log4j.properties，可用使用PropertyConfigurator指定配置文件路径,例如:PropertyConfigurator.configure(“src/log4jConfigTest.properties”);

3.2例子

import org.apache.log4j.Logger;

public class MyLog4j {
    //也可以是MyLog4j.class,最后都是的logger都是继承自rootlogger
    private static Logger logger = Logger.getLogger("Test");

    public static void main(String[] args) {  
        System.out.println("This is println message.");  

        // 记录debug级别的信息  
        logger.debug("This is debug message.");  
        // 记录info级别的信息  
        logger.info("This is info message.");  
        // 记录error级别的信息  
        logger.error("This is error message."); 

    }  
}

4. log4j的编码习惯

• 让每个类都拥有一个private static的Logger对象，用来输出该类中的全部日志信息
• 使用xml文件来完成对log4j环境的配置。在项目的main class中的静态初始化块里放log4j环境的配置代码。注意：在一个项目中，log4j环境只需要被配置一次，而不是在每个使用了logger的类里都需要调用一次
• 用MyClass.class作为参数创建该类的静态Logger对象

5. 一个配置文件的例子

log4j.rootLogger=debug, stdout, log, errorlog
log4j.Logger=search,Test
###Console ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.Threshold = DEBUG
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern =  %d{ABSOLUTE} [ %t ] [ %p ]:%l - %m%n
### Log ###  
log4j.appender.log = org.apache.log4j.DailyRollingFileAppender
log4j.appender.log.File = log/log.log
log4j.appender.log.Append = true
log4j.appender.log.Threshold = INFO
log4j.appender.log.DatePattern='.'yyyy-MM-dd
log4j.appender.log.layout = org.apache.log4j.PatternLayout
log4j.appender.log.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t ] %m%n
### Error ###
log4j.appender.errorlog = org.apache.log4j.DailyRollingFileAppender
log4j.appender.errorlog.File = log/errorlog.log
log4j.appender.errorlog.Append = true
log4j.appender.errorlog.Threshold = ERROR 
log4j.appender.errorlog.DatePattern='.'yyyy-MM-dd
log4j.appender.errorlog.layout = org.apache.log4j.PatternLayout
log4j.appender.errorlog.layout.ConversionPattern =%-d{yyyy-MM-dd HH:mm:ss} [ %t ] %m%n