TestNG - Logger类的使用

最新推荐文章于 2024-03-02 12:33:32 发布

sruru

最新推荐文章于 2024-03-02 12:33:32 发布

阅读量1w

点赞数 1

CC 4.0 BY-SA版权

分类专栏： java logging testng

本文链接：https://blog.youkuaiyun.com/sruru/article/details/46849021

java 同时被 3 个专栏收录

4 篇文章

订阅专栏

logging

1 篇文章

订阅专栏

testng

1 篇文章

订阅专栏

本文介绍了TestNG内置的日志系统，该系统类似Log4j，具有TRACE到FATAL六级日志级别。默认使用System.out和System.err进行输出，且不可通过编程方式动态控制。当首次调用日志API时，会查找log4testng.properties配置文件。如果没有找到，日志级别默认为WARN。文章详细解析了配置文件的格式，并提供了一个实践案例，解释了如何设置不同类的日志级别，以及log4testng.debug属性的作用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

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.");
      }
    }

  }