log4j2使用手册@zhangsf(4)

当 configuration被加载或者 每个LogEvent 运行时，这个变量将被解析。如果这个日志组件可以处理这个变量。

三．Log4j2 API

Log4j2API提供了应用程序使用的接口，也提供了创建一个日志实现所需的适配器组件， Log4j2解耦了API及其实现之间的关系。这样做的目的是不允许有多个实现 。

一种可能的情况是 一个Log4j2的API对应多个实现，所以在应用中要使用 Log4j2 API中的类和方法， 而不要使用具体的实现内容

（1）Hello World!

下面是一个helloworld的例子， 有一个从LogManager中获取的 名称为 HelloWorld的Logger，接着，这个Logger打印了 \的日志消息。 当然，只有在configured 中做了相应的配置，这些内容才能打印出来。

1. importorg.apache.logging.log4j.LogManager; 2. importorg.apache.logging.log4j.Logger; 3.

4. publicclassHelloWorld{

5. privatestaticfinalLogger logger =LogManager.getLogger(\); 6. publicstaticvoid main(String[] args){ 7. logger.info(\); 8. } 9. }

调用方法 logger.info()的输出会有所不同，主要取决于 configuration的配置

(2) Substituting Parameters

日志记录的目的是要提供系统中发生的信息，这就要打印一些对象信息，在 Log4j1.x中， 可以通过这样来打印 :

1. if(logger.isDebugEnabled()){

2. logger.debug(\+ user.getName()+\

\+user.getBirthdayCalendar()); 3. }

这样的代码感觉很繁琐，而且会检查2次日志级别，一次是 logger.isDebugEnabled，另

一次是logger.debug。在log4j2中更好的实现方式是 :

logger.debug(\, user.getName(), user.getBirthdayCalendar()); 代码简洁了很多， 而且日志只有在debug 打印的时候才会构建日志内容中的字符串。

(3) Formatting Parameters

类似于java的Formatter， Formatter Loggers 可以提供简易的字符串格式化方式 : 例如：

1. publicstaticLogger logger =LogManager.getFormatterLogger(\); 2.

3. logger.debug(\, user.getName(),

user.getBirthdayCalendar());

4. logger.debug(\,

user.getName(), user.getBirthdayCalendar());

5. logger.debug(\,Integer.MAX_VALUE); 6. logger.debug(\,Long.MAX_VALUE);

要使用格式化日志，必须调用 LogManager getFormatterLogger的方法。

下面展示了例子中的结果内容 :

1. 2012-12-1211:56:19,633[main] DEBUG:UserJohnSmithwith birthday

java.util.GregorianCalendar[time=?,areFieldsSet=false,areAllFieldsSet=false,lenient=true,zone=sun.util.calendar.ZoneInfo[id=\,offset=-18000000,dstSavings=3600000,useDaylight=true,transitions=235,lastRule=java.util.SimpleTimeZone[id=America/New_York,offset=-18000000,dstSavings=3600000,useDaylight=true,startYear=0,startMode=3,startMonth=2,startDay=8,startDayOfWeek=1,startTime=7200000,startTimeMode=0,endMode=3,endMonth=10,endDay=1,endDayOfWeek=1,endTime=7200000,endTimeMode=0]],firstDayOfWeek=1,minimalDaysInFirstWeek=1,ERA=?,YEAR=1995,MONTH=4,WEEK_OF_YEAR=?,WEEK_OF_MONTH=?,DAY_OF_MONTH=23,DAY_OF_YEAR=?,DAY_OF_WEEK=?,DAY_OF_WEEK_IN_MONTH=?,AM_PM=0,HOUR=0,HOUR_OF_DAY=0,MINUTE=0,SECOND=0,MILLISECOND=?,ZONE_OFFSET=?,DST_OFFSET=?]

2. 2012-12-1211:56:19,643[main] DEBUG:UserJohnSmithwith birthday 0523,1995 3. 2012-12-1211:56:19,643[main] DEBUG:Integer.MAX_VALUE =2,147,483,647 4. 2012-12-1211:56:19,643[main] DEBUG:Long.MAX_VALUE

=9,223,372,036,854,775,807

(4) Mixing Loggers with Formatter Loggers

Formatter loggers是用来控制细粒度的输出格式的。但是缺点是必须指定正确的类型，例如给 %d 格式化参数传递了 Integer以外的类型，就会抛错。

如果你主要使用 {} 风格的参数， 但是偶尔要精确控制输出格式，可以使用 printf方法：

1. publicstaticLogger logger =LogManager.getLogger(\); 2.

3. logger.debug(\, someDataSource); 4. logger.printf(Level.INFO,\

birthday %2$tm %2$te,%2$tY\, user.getName(), user.getBirthdayCalendar());

(5) Java 8 lambda support for lazy logging

在2.4版本以后，Logger 支持了lambda表达式，在请求日志级别启动的时候，可以懒加载的打印这些信息而不用去显式检查日志是否要打印。 例如， 在以前版本中可能这样写 :

1. // pre-Java 8 style optimization: explicitly check the log level 2. // to make sure the expensiveOperation() method is only called if necessary 3. if(logger.isTraceEnabled()){

4. logger.trace(\,

expensiveOperation()); 5. }

在java8中可以使用 lambda表达式实现相同的效果，你可以不用显式的检查日志级别了：

1. // Java-8 style optimization: no need to explicitly check the log level: 2. // the lambda expression is not evaluated if the TRACE level is not enabled 3. logger.trace(\,()->

expensiveOperation());

(6)Logger Names

大部分日志实现使用为了使得 日志名称与日志配置匹配 使用一个分层的名称方案。在这个方案中Logger的名称是由 . 分隔的， 非常类似于 java包名的层次。 例如

:org.apache.logging

是 org.apache.logging.appender 与 org.apache.logging.filter 的父层。大多数情况下，应用命名他们的日志名称是通过在LogManager.getLogger中传入当前类名实现的。因为这个用法太常见，Log4j2在入参为空或者传入为Null的时候默认是提供当前类的名称。例如，下面的例子的 Logger的名称都是 \

1. packageorg.apache.test;

2.

3. publicclassMyTest{

4. privatestaticfinalLogger logger =LogManager.getLogger(MyTest.class); 5. }

1. packageorg.apache.test; 2.

3. publicclassMyTest{

4. privatestaticfinalLogger logger

=LogManager.getLogger(MyTest.class.getName()); 5. }

1. packageorg.apache.test; 2.

3. publicclassMyTest{

4. privatestaticfinalLogger logger =LogManager.getLogger(); 5. }

1. Flow Tracing

Logger 类提供了针对跟踪应用执行路径的很有用的方法 。这些方法可以从debug 日志中产生可以单独 过滤的logging events。以下情况鼓励使用这些方法： (1) 在不需要DEBUG的开发中帮助诊断问题 (2)在不需要DEBUG的生产中帮助诊断问题。

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说教育文库log4j2使用手册@zhangsf(4)在线全文阅读。