Log4J

Log4J的三个组件：

Logger：日志记录器

Appender：日志输出

Layout：日志格式化

一个logger能够对应多个appender，一个appender只能对应一个layout。

一、Logger：

logger能够有选择的启动和禁用日志的输出，咱们常常会在各类框架中看到如：

 

Java代码  

1. 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")得到。

二、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，须要手动指定。

logger.debug(message);  
logger.info(message);
logger.warn(message);
logger.error(message);
logger.fatal(message);

三、Appender：

Appender能够控制日志的输出的目的地，一个输出源就叫一个Appender，appender的类别有：Console（控制台）File（文件）JDBC、JMS等，logger能够经过方法logger.addAppender(appender); 配置多个appender，对logger来讲，每一个有效的日志请求结果都将输出到logger自己以及父logger的appender上。例如：

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

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

example.addAppender( appender);

Logger extest = Logger.getLogger("example.test");

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

extest.info("hello world");

上例中，“extest”是继承“example”logger的，"example"定义的appender是FileAppender，而"example"定义的appender是ConsoleAppender，这里我并无设置他们的Level，那么自动使用root默认的INFO做为日志的的等级，所以此处extest.info（“hello world")会被输出到指定的appender上。注意：这里"extest" 并无设置FileAppender做为本身的appender，可是最终日志信息会显示在控制台，并且也会输出到文件example.log中去。不过这里能够经过设置logger ”extest"的additivity（附加标记）设为false ==》extest.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（将日志信息以流格式发送到任意指定的地方）

四、Layout：

使用指定的Layout来展现（格式化）日志，常见的Layout有：

org.apache.log4j.HTMLLayout（以HTML表格形式布局）

org.apache.log4j.PatternLayout（能够灵活地指定布局模式）

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

org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息），更多

 

五、配置：

理解了以上几个组建后，咱们就能够了解一下log4j的配置log4j.properties了。

 #配置根Logger
log4j.rootLogger  =   [ level ]   ,  appenderName1 ,  appenderName2 ,  …

#例子：
log4j.rootLogger = DEBUG ,  stdout ,file
#配置日志信息输出目的地（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级别以上的日志，这里的意思是rootLogger设置为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
#配置日志信息的格式（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          输出产生该日志事件的线程名