Log4J学习笔记

Log4J的三个组件:

Logger:日志记录器,负责收集处理日志记录(如何处理日志)

Appender:日志输出目的地,负责日志的输出(输出到什么地方)

Layout:日志格式化,负责对输出的日志的格式化(以什么形式展现)

一个logger可以对应多个appender,一个appender只能对应一个layout。

1、Logger:

logger可以有选择的启动和禁用日志的输出,我们经常会在各种框架中看到如:

private static final Logger log=LoggerFactory.getLogger(xx.class);

讲解:log就代表了一个Logger实例,他的name就是类“xx”的full quailied name(类的全限定名),这个log可以指定多个appender和layout。Logger的名字大小写敏感,其命名有继承机制:例如:name为org.apache.commons的logger会继承name为org.apache的logger。

Log4J中有一个特殊的logger叫做“root”,他是所有logger的根,也就意味着其他的logger都会直接或者间接地继承自root。root logger可以用Logger.getRootLogger()方法获取,但是不能通过Logger.getLogger("root")获得。

java code:

Logger root = Logger.getRootLogger();

Logger log = Logger.getLogger("root");

System.out.println(log==root);//false 说明root无法通过name获取


Logger log2 = Logger.getLogger("root");

System.out.println(log==log2);//true,说明一个name唯一对应一个logger

2、Level:

level为logger服务,用来定义日志的级别,他的值可以是:OFF(关闭)FATAL(致命的)ERROR(错误)WARN(警告)INFO(信息)DEBUG(调试)ALL(所有),输出日志的策略由此Level决定,例如:如果logger的Level设置为INFO,那么系统只输出INFO以及以上(WARN、ERROR、FATAL)信息。如果当前logger没有设定Level,那么它在输出日志时采用的策略是:它会使用它继承的Logger的Level作为它自己的Level来处理。如果它的上级也没有设置Level,那么就找上上级,几次类推,直到root为止,(root的Level是不能设为空的,所以最终一定会找到一个Level)。默认root的Level是INFO,其他logger的Level默认都是null,需要手动指定。

Level对应的logger输出级别对应的方法有:

logger.debug(message);

logger.info(message);

logger.error(message);

logger.fatal(message);

3、Appender:

Appender可以控制日志的输出的目的地,一个输出源就叫一个Appender,appender的类别有:Console(控制台)File(文件)JDBC、JMS等等,logger可以通过方法logger.addAppender(appender)配置多个appender,对logger来说,每个有效的日志请求结果都将输出到logger本身以及父logger的appender上。例如:

Logger com=Logger.getLogger("com");

Appender appender = new FileAppender(new SimpleLayout(),"hello.log");

com.addAppender(appender);

Logger iteye = Logger.getLogger("com.iteye");

iteye.addAppender(new ConsoleAppender(new SimpleLayout(),"System.out"));//target:sys.out(default)或sys.err

iteye.info("hello world");

上例中,“iteye”是继承"com"logger的,“com”定义的appender是FileAppender,而“iteye”定义的appender是ConsoleAppender,这里我并没有设置他们的Level,那么自动使用root默认的INFO作为日志的等级,因此此处iteye.info("hello world")会被输出到指定的appender上。但是最终日志信息会显示在控制台,而且也会输出到文件hello.log中去。不过这里可以通过设置logger“iteye”的additivity(附加标记)设为false==>>iteye.setAdditivity(false);这样日志信息”hello world“就不会写入到hello.log中去了。

常用的集中appender有:

org.apache.log4j.ConsoleAppender(控制台)

org.apache.log4j.FileAppender(文件)

org.apache.log4j.DailyRollingFileAppender(每天产生一个日志文件)

org.apache.log4j.RollingFileAppender((文件大小到达指定尺寸的时候产生一个新的文件))

org.apache.log4j.WriterAppender(将日志信息以流格式发送到任意指定的地方)

4、Layout:

使用指定的Layout来展示(格式化)日志,常见的Layout有:

org.apache.log4j.HTMLLayout(以HTML表格形式布局)

org.apache.log4j.PatternLayout(可以灵活地指定布局模式)

org.apache.log4j.SimpleLayout(包含日志信息的级别和信息字符串)

org.apache.log4j.TTCCLayout(包含日志产生的时间、线程、类别等等信息),等

5、配置:

配置了以上几个组件后,我们就可以了解一下log4j的配置.properties了。

Java code:

#配置根Logger

log4j.rootLogger = [level],appenderName1,appenderName2,...

#例子:

log4j.rootLogger =  DEBUG,stdout,file

java code:

#配置日志信息输出目的地(Appender)

log4j.appender.appenderName =  fully.qualified.name.of.appender.class

log4j.appender.appenderName.option1=value1

...

log4j.appender.appenderName.optionN=valueN

#例子

###输出到控制台###

log4j.appender.stdout = org.apache.log4j.ConsoleAppender

log4j.appender.stdout .Target = System.out #默认就是System.out,另外一个值是System.error

log4j.appender.stdout.layout = org.apache.log4j.PatternLayout

log4j.appender.stdout.layout.ConversionPattern = %d{ABSOLUTE}  %5p %c{1}:%L - %m%n

###输出到文件###

log4j.appender.file=org.apache.log4j.DailyRollingFileAppender

log4j.appender.file.File = logs/log.log

log4j.appender.file.Append = true #默认是true,系统启动时追加至文件中,否则会覆盖原有内容

log4j.appender.file.Threshold = INFO ## 输出IFNO级别以上的日志,这里的意思是rootLooger设置为DEBUG时,只输出INFO以上(INFO、WARN、ERROR、FATAL)的信息到文件中去,而DEBUG信息就不会输出 了

log4j.appender.file.layout=org.apache.log4j.PatternLayout

log4j.appender.file.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss} [%t:%r] - [%p] % m%n

java code

#配置日志信息的格式(Layout)

log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class

log4j.appender.appenderName.layout.option1 = value1

...

log4j.appender.appenderName.layout.optionN =  valueN

#例子

log4j.appender.file.layout =  org.apache.log4j.PatternLayout

log4j.appender.file.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [%t:%r] - [%p] %m%n

ConversionPattern参数的格式含义

格式名 含义

%c    输出日志信息所属的类的全名

%d    输出日志时间点的日期或时间,默认格式为ISO8601,也可以在其后指定格式,比如:%d{yyy-MM-dd HH:mm:ss},输出类似:2002-10-18 22:10:28

%f      输出日志信息所属的类的类名

%l      输出日志事件的发生位置,即输出日志信息的语句处于它所在的类的第几行

%m    输出代码中指定的信息,如log(message)中的message

%n     输出一个回车换行符,Windows平台为“rn”,Unix平台为"n"

%p     输出优先级,即DEBUG,INFO,WARN,ERROR,FATAL。如果是调用debug()输出的。则国DEBUG,依此类推

%r     输出自应用启动到输出该日志信息所耗费的毫秒数

%t     输出产生该日志事件的线程名



最后如果你看到此类错误应该有不再感到疑惑了吧:

public static org.slf4j.Logger log = LoggerFactory.getLogger(Test.class);

 log.error("erro");


log4j:WARN No appenders could be found for logger (Test).

 log4j:WARN Please initialize the log4j system properly.

你可能感兴趣的:(Log4J学习笔记)