TestNG - Logger类的使用

TestNG提供了类似于Log4j的logging系统，为了控制logging，你需要增加一个名字为"log4testng.properties"的文件到你的classpath中国，TestNg的logging一共有六个级别： TRACE， DEBUG， INFO， WARN， ERROR 和FATAL，logging框架有如下的特性：

1. 所有的logging都是用System.out(levels < ERROR） 和System.err来完成，没有办法改变输出源

2. 不可以通过动态编程的方式来控制logging(我理解为，只能通过log4testng.properties文件中的属性来控制)

3.在第一次call logging API的时候，会在classpath中查找log4testng.properties 资源文件，如果没有找到，logging设置默认级别为WARN

log4testng.properties文件包含的内容格式如下所示:

# log4testng will log its own behavior (generally used for debugging this package only). log4testng会输出它自身的行为(通常用于调试logging系统自生)
log4testng.debug=true

# Specifies the root Loggers logging level. Will log DEBUG level and above 指定root Loggers的logging lvel，下面的设置将输出>=DEBUG级别的信息
log4testng.rootLogger=DEBUG

# The org.testng.reporters.EmailableReporter Logger will log TRACE level and above  //org.testng.reporters.EmailableReporter Logger输出>=TRACE级别的信息
log4testng.logger.org.testng.reporters.EmailableReporter=TRACE

# All Logger in packages below org.testng will log WARN level and above //包中的所有Logger将输出>=WARN级别的信息
log4testng.logger.org.testng=WARN

接下来，我将结合自身实践和Logger的source code做出一些解读，首先来看一个例子：

package com.spring.test;import org.testng.log4testng.Logger;public class TestngLoggerDemo {public static Logger logger = Logger.getLogger(TestngLoggerDemo.class);public static void Test() {logger.debug("ssssssssssssss");}public static void main(String[] args) {System.out.println(logger.isDebugEnabled());logger.debug("ffffffffffffff");logger.trace("dddddddd");//logger.error("ddddd");}}

package com.spring.test;import org.testng.log4testng.Logger;public class TestngLoggerDemo2 {public static void main(String[] args) {TestngLoggerDemo.logger.trace("dddddddddddd");Logger logger2 = Logger.getLogger(TestngLoggerDemo2.class);logger2.debug("vvvvvvvvvv");}}

"log4testng.properties"文件内容如下所示：

log4testng.debug=true log4testng.rootLogger=DEBUG log4testng.logger.com.spring.TestngLoggerDemo=TRACE

1） 首先来看第一条 log4testng.debug=true

[log4testng] [debug] log4testng.debug set to true
[log4testng] [debug] Root level logger set to DEBUG level.
[log4testng] [debug] logger log4testng.logger.com.spring.TestngLoggerDemo set to 0 level.
[log4testng] [debug] Getting level for logger com.spring.test.TestngLoggerDemo
[log4testng] [debug] Found level 1 for root logger
true
[TestngLoggerDemo] [DEBUG] ffffffffffffff

以[log4testng] [debug] tag开头的信息，都是因为这条语句的设置而输出的，它展示给用户当前的logging系统的信息，log4testng.debug设置为false，那么只有最后两条语句会被输出,查看Logger类的源代码就会得出原因，带有[log4testng][debug]tag的信息，都是

  /**   * Logs the message to System.out of debug is on.   * @param pmessage the message to log to the console   */  private static void loglog4testng(String pmessage) {    if(debug) {      out.println("[log4testng] [debug] " + pmessage);    }  }

log4testng(String pmesage)中的debug开关是在下面的函数中设定

  private static void checkProperties(Properties pProperties) {    {      // See if we want to debug log4testng      String debugStr= pProperties.getProperty(DEBUG_PROPERTY);      if(debugStr != null) {        if(debugStr.equalsIgnoreCase("true")) {          debug= true;        }        else if(debugStr.equalsIgnoreCase("false")) {          ...}

checkProperties函数在getLogger函数张被调用

2) 接下来来看语句 log4testng.rootLogger=DEBUG， 他设定logger的默认logging levei为DEBUG在getLogger的时候，如果properties文件中没有显示的为当前类设定logging level，那么当前类的logging level默认为DEBUG，这也验证了文章一开头所说的框架属性的第三条。查看下面的函数就可以从代码中找到佐证

private static void checkProperties(Properties pProperties) {    {      {      // Set the value of the root logger (if any).      String rootLevelStr= pProperties.getProperty(ROOT_LOGGER);      if(rootLevelStr != null) {        Integer ilevel= levelMap.get(rootLevelStr.toUpperCase());        if(ilevel == null) {          throw new IllegalArgumentException("Unknown level for log4testng.rootLogger "                                             + rootLevelStr + " in log4testng.properties");        }        rootLoggerLevel= ilevel.intValue();        loglog4testng("Root level logger set to " + rootLevelStr + " level.");      }    }  }