Java记录器,自动确定调用者的类名

时间:2008-09-17 07:06:47

标签: java logging stack-trace

public static Logger getLogger() {
    final Throwable t = new Throwable();
    final StackTraceElement methodCaller = t.getStackTrace()[1];
    final Logger logger = Logger.getLogger(methodCaller.getClassName());
    logger.setLevel(ResourceManager.LOGLEVEL);
    return logger;
}

此方法将返回一个记录器,该记录器知道它正在记录的类。 反对它的任何想法?

许多年后:https://github.com/yanchenko/droidparts/blob/master/droidparts/src/org/droidparts/util/L.java

21 个答案:

答案 0 :(得分:22)

创建堆栈跟踪是一个相对较慢的操作。您的调用者已经知道它所属的类和方法,因此浪费了精力。解决方案的这方面效率低下。

即使您使用静态类信息,也不应为每条消息再次获取Logger。 Log4j的From the author,CekiGülcü:

  

包装类中最常见的错误是在每个日志请求上调用Logger.getLogger方法。这可以保证对您的应用程序的性能造成严重破坏。真!!!

这是在类初始化期间获取Logger的传统有效习惯用法:

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

请注意,这为层次结构中的每种类型提供了单独的Logger。如果您想出一个在实例上调用getClass()的方法,您将看到由基类型记录的消息显示在子类型的记录器下。也许这在某些情况下是可取的,但我发现它令人困惑(而且我倾向于赞成合成而不是继承)。

显然,通过getClass()使用动态类型将要求您每个实例至少获取一次记录器,而不是像使用静态类型信息的推荐习惯用法那样每个类获取一次。

答案 1 :(得分:20)

MethodHandles类(从Java 7开始)包含一个Lookup类,它可以从静态上下文中查找并返回当前类的名称。请考虑以下示例:

import java.lang.invoke.MethodHandles;

public class Main {
  private static final Class clazz = MethodHandles.lookup().lookupClass();
  private static final String CLASSNAME = clazz.getSimpleName();

  public static void main( String args[] ) {
    System.out.println( CLASSNAME );
  }
}

运行时会产生:

Main

对于记录器,您可以使用:

private static Logger LOGGER = 
  Logger.getLogger(MethodHandles.lookup().lookupClass().getSimpleName());

答案 2 :(得分:17)

我们实际上在LogUtils类中有类似的东西。是的,它有点狡猾,但就我而言,优点是值得的。我们希望确保我们没有任何开销,因为它被重复调用,所以我们(有点hackily)确保它只能从静态初始化器上下文调用,la:

private static final Logger LOG = LogUtils.loggerForThisClass();

如果从普通方法或实例初始化程序调用它(例如,如果“静态”不在上面),它将失败,以降低性能开销的风险。方法是:

public static Logger loggerForThisClass() {
    // We use the third stack element; second is this method, first is .getStackTrace()
    StackTraceElement myCaller = Thread.currentThread().getStackTrace()[2];
    Assert.equal("<clinit>", myCaller.getMethodName());
    return Logger.getLogger(myCaller.getClassName());
}

任何询问这有什么优势的人

= Logger.getLogger(MyClass.class);

可能从来没有必要与那些从其他地方复制并粘贴该行并忘记更改类名的人处理,让您处理将其所有内容发送到另一个记录器的类。

答案 3 :(得分:15)

我想这会为每个课程增加很多开销。每个班级都必须“抬头”。你可以创建新的Throwable对象......这些throwable不是免费的。

答案 4 :(得分:8)

假设您将静态引用保存到记录器,这里是一个独立的静态单例:

public class LoggerUtils extends SecurityManager
{
    public static Logger getLogger()
    {
        String className = new LoggerUtils().getClassName();
        Logger logger = Logger.getLogger(className);
        return logger;
    }

    private String getClassName()
    {
        return getClassContext()[2].getName();
    }
}

用法很干净:

Logger logger = LoggerUtils.getLogger();

答案 5 :(得分:4)

对于你使用它的每个类,无论如何你都必须查找Logger,所以你也可以在这些类中使用静态Logger。

private static final Logger logger = Logger.getLogger(MyClass.class.getName());

然后,当您需要执行日志消息时,只需引用该记录器。您的方法与静态Log4J Logger的功能完全相同,为什么要重新发明轮子?

答案 6 :(得分:3)

通过阅读本网站上的所有其他反馈,我创建了以下内容以用于Log4j:

package com.edsdev.testapp.util;

import java.util.concurrent.ConcurrentHashMap;

import org.apache.log4j.Level;
import org.apache.log4j.Priority;

public class Logger extends SecurityManager {

private static ConcurrentHashMap<String, org.apache.log4j.Logger> loggerMap = new ConcurrentHashMap<String, org.apache.log4j.Logger>();

public static org.apache.log4j.Logger getLog() {
    String className = new Logger().getClassName();
    if (!loggerMap.containsKey(className)) {
        loggerMap.put(className, org.apache.log4j.Logger.getLogger(className));
    }
    return loggerMap.get(className);
}
public String getClassName() {
    return getClassContext()[3].getName();
}
public static void trace(Object message) {
    getLog().trace(message);
}
public static void trace(Object message, Throwable t) {
    getLog().trace(message, t);
}
public static boolean isTraceEnabled() {
    return getLog().isTraceEnabled();
}
public static void debug(Object message) {
    getLog().debug(message);
}
public static void debug(Object message, Throwable t) {
    getLog().debug(message, t);
}
public static void error(Object message) {
    getLog().error(message);
}
public static void error(Object message, Throwable t) {
    getLog().error(message, t);
}
public static void fatal(Object message) {
    getLog().fatal(message);
}
public static void fatal(Object message, Throwable t) {
    getLog().fatal(message, t);
}
public static void info(Object message) {
    getLog().info(message);
}
public static void info(Object message, Throwable t) {
    getLog().info(message, t);
}
public static boolean isDebugEnabled() {
    return getLog().isDebugEnabled();
}
public static boolean isEnabledFor(Priority level) {
    return getLog().isEnabledFor(level);
}
public static boolean isInfoEnabled() {
    return getLog().isInfoEnabled();
}
public static void setLevel(Level level) {
    getLog().setLevel(level);
}
public static void warn(Object message) {
    getLog().warn(message);
}
public static void warn(Object message, Throwable t) {
    getLog().warn(message, t);
}

}

现在,您需要的代码就是

Logger.debug("This is a test");

Logger.error("Look what happened Ma!", e);

如果您需要更多地了解log4j方法,只需从上面列出的Logger类中委派它们。

答案 7 :(得分:3)

然后最好的事情是两个混合。

public class LoggerUtil {

    public static Level level=Level.ALL;

    public static java.util.logging.Logger getLogger() {
        final Throwable t = new Throwable();
        final StackTraceElement methodCaller = t.getStackTrace()[1];
        final java.util.logging.Logger logger = java.util.logging.Logger.getLogger(methodCaller.getClassName());
        logger.setLevel(level);

        return logger;
    }
}

然后在每个班级中:

private static final Logger LOG = LoggerUtil.getLogger();

代码:

LOG.fine("debug that !...");

你得到静态记录器,你可以在每个类中复制和粘贴,而且没有开销......

阿拉

答案 8 :(得分:2)

您无需创建新的Throwable对象。你可以打电话 Thread.currentThread().getStackTrace()[1]

答案 9 :(得分:2)

我更喜欢为每个类创建一个(静态)Logger(使用它的显式类名)。我按原样使用记录器。

答案 10 :(得分:2)

您当然可以使用具有适当模式布局的Log4J:

  

例如,对于类名“org.apache.xyz.SomeClass”,模式%C {1}将输出“SomeClass”。

http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/PatternLayout.html

答案 11 :(得分:1)

我在大多数班级的开头都有以下几行。

  private static final Logger log = 
     LoggerFactory.getLogger(new Throwable().getStackTrace()[0].getClassName());

是的,第一次创建该类的对象时会有一些开销,但我主要在webapps中工作,因此在20秒启动时添加微秒并不是真正的问题。

答案 12 :(得分:1)

Google Flogger日志记录API支持此功能

private static final FluentLogger logger = FluentLogger.forEnclosingClass();

有关更多详细信息,请参见https://github.com/google/flogger

答案 13 :(得分:0)

为什么不呢?

public static Logger getLogger(Object o) {
  final Logger logger = Logger.getLogger(o.getClass());
  logger.setLevel(ResourceManager.LOGLEVEL);
  return logger;
}

然后当你需要一个类的记录器时:

getLogger(this).debug("Some log message")

答案 14 :(得分:0)

除非确实需要您的Logger是静态的,否则您可以使用

final Logger logger = LoggerFactory.getLogger(getClass());

答案 15 :(得分:0)

这种机制在运行时付出了很多额外的努力。

如果您使用Eclipse作为IDE,请考虑使用Log4e。这个方便的插件将使用您最喜欢的日志框架为您生成记录器声明。在编码时花费更多的精力,但很多在运行时更少工作。

答案 16 :(得分:0)

请参阅我的静态getLogger()实现(在JDK 7上使用相同的“sun。*”magic作为默认的java Logger doit)

  • 注意静态日志记录方法(使用静态导入)没有丑陋的日志属性...

    import static my.pakg.Logger。*;

它们的速度相当于本机Java实现(使用100万条日志跟踪进行检查)

package my.pkg;

import java.text.MessageFormat;
import java.util.Arrays;
import java.util.IllegalFormatException;
import java.util.logging.Level;
import java.util.logging.LogRecord;

import sun.misc.JavaLangAccess;
import sun.misc.SharedSecrets;


public class Logger {
static final int CLASS_NAME = 0;
static final int METHOD_NAME = 1;

// Private method to infer the caller's class and method names
protected static String[] getClassName() {
    JavaLangAccess access = SharedSecrets.getJavaLangAccess();
    Throwable throwable = new Throwable();
    int depth = access.getStackTraceDepth(throwable);

    boolean lookingForLogger = true;
    for (int i = 0; i < depth; i++) {
        // Calling getStackTraceElement directly prevents the VM
        // from paying the cost of building the entire stack frame.
        StackTraceElement frame = access.getStackTraceElement(throwable, i);
        String cname = frame.getClassName();
        boolean isLoggerImpl = isLoggerImplFrame(cname);
        if (lookingForLogger) {
            // Skip all frames until we have found the first logger frame.
            if (isLoggerImpl) {
                lookingForLogger = false;
            }
        } else {
            if (!isLoggerImpl) {
                // skip reflection call
                if (!cname.startsWith("java.lang.reflect.") && !cname.startsWith("sun.reflect.")) {
                    // We've found the relevant frame.
                    return new String[] {cname, frame.getMethodName()};
                }
            }
        }
    }
    return new String[] {};
    // We haven't found a suitable frame, so just punt.  This is
    // OK as we are only committed to making a "best effort" here.
}

protected static String[] getClassNameJDK5() {
    // Get the stack trace.
    StackTraceElement stack[] = (new Throwable()).getStackTrace();
    // First, search back to a method in the Logger class.
    int ix = 0;
    while (ix < stack.length) {
        StackTraceElement frame = stack[ix];
        String cname = frame.getClassName();
        if (isLoggerImplFrame(cname)) {
            break;
        }
        ix++;
    }
    // Now search for the first frame before the "Logger" class.
    while (ix < stack.length) {
        StackTraceElement frame = stack[ix];
        String cname = frame.getClassName();
        if (isLoggerImplFrame(cname)) {
            // We've found the relevant frame.
            return new String[] {cname, frame.getMethodName()};
        }
        ix++;
    }
    return new String[] {};
    // We haven't found a suitable frame, so just punt.  This is
    // OK as we are only committed to making a "best effort" here.
}


private static boolean isLoggerImplFrame(String cname) {
    // the log record could be created for a platform logger
    return (
            cname.equals("my.package.Logger") ||
            cname.equals("java.util.logging.Logger") ||
            cname.startsWith("java.util.logging.LoggingProxyImpl") ||
            cname.startsWith("sun.util.logging."));
}

protected static java.util.logging.Logger getLogger(String name) {
    return java.util.logging.Logger.getLogger(name);
}

protected static boolean log(Level level, String msg, Object... args) {
    return log(level, null, msg, args);
}

protected static boolean log(Level level, Throwable thrown, String msg, Object... args) {
    String[] values = getClassName();
    java.util.logging.Logger log = getLogger(values[CLASS_NAME]);
    if (level != null && log.isLoggable(level)) {
        if (msg != null) {
            log.log(getRecord(level, thrown, values[CLASS_NAME], values[METHOD_NAME], msg, args));
        }
        return true;
    }
    return false;
}

protected static LogRecord getRecord(Level level, Throwable thrown, String className, String methodName, String msg, Object... args) {
    LogRecord record = new LogRecord(level, format(msg, args));
    record.setSourceClassName(className);
    record.setSourceMethodName(methodName);
    if (thrown != null) {
        record.setThrown(thrown);
    }
    return record;
}

private static String format(String msg, Object... args) {
    if (msg == null || args == null || args.length == 0) {
        return msg;
    } else if (msg.indexOf('%') >= 0) {
        try {
            return String.format(msg, args);
        } catch (IllegalFormatException esc) {
            // none
        }
    } else if (msg.indexOf('{') >= 0) {
        try {
            return MessageFormat.format(msg, args);
        } catch (IllegalArgumentException exc) {
            // none
        }
    }
    if (args.length == 1) {
        Object param = args[0];
        if (param != null && param.getClass().isArray()) {
            return msg + Arrays.toString((Object[]) param);
        } else if (param instanceof Throwable){
            return msg;
        } else {
            return msg + param;
        }
    } else {
        return msg + Arrays.toString(args);
    }
}

public static void severe(String msg, Object... args) {
    log(Level.SEVERE, msg, args);
}

public static void warning(String msg, Object... args) {
    log(Level.WARNING, msg, args);
}

public static void info(Throwable thrown, String format, Object... args) {
    log(Level.INFO, thrown, format, args);
}

public static void warning(Throwable thrown, String format, Object... args) {
    log(Level.WARNING, thrown, format, args);
}

public static void warning(Throwable thrown) {
    log(Level.WARNING, thrown, thrown.getMessage());
}

public static void severe(Throwable thrown, String format, Object... args) {
    log(Level.SEVERE, thrown, format, args);
}

public static void severe(Throwable thrown) {
    log(Level.SEVERE, thrown, thrown.getMessage());
}

public static void info(String msg, Object... args) {
    log(Level.INFO, msg, args);
}

public static void fine(String msg, Object... args) {
    log(Level.FINE, msg, args);
}

public static void finer(String msg, Object... args) {
    log(Level.FINER, msg, args);
}

public static void finest(String msg, Object... args) {
    log(Level.FINEST, msg, args);
}

public static boolean isLoggableFinest() {
    return isLoggable(Level.FINEST);
}

public static boolean isLoggableFiner() {
    return isLoggable(Level.FINER);
}

public static boolean isLoggableFine() {
    return isLoggable(Level.FINE);
}

public static boolean isLoggableInfo() {
    return isLoggable(Level.INFO);
}

public static boolean isLoggableWarning() {
    return isLoggable(Level.WARNING);
}
public static boolean isLoggableSevere() {
    return isLoggable(Level.SEVERE);
}

private static boolean isLoggable(Level level) {
    return log(level, null);
}

}

答案 17 :(得分:0)

查看Logger中的jcabi-log课程。它完全符合您的需求,提供了一系列静态方法。您不再需要将记录器嵌入到类中:

import com.jcabi.log.Logger;
class Foo {
  public void bar() {
    Logger.info(this, "doing something...");
  }
}

Logger将所有日志发送到SLF4J,您可以在运行时将其重定向到任何其他日志记录工具。

答案 18 :(得分:0)

一个很好的选择是使用(一个)lombok日志注释: https://projectlombok.org/features/Log.html

它使用当前类生成相应的日志语句。

答案 19 :(得分:0)

从Java 7开始执行此操作的一种好方法:

private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());

记录器可以是static,就可以了。 这里使用SLF4J API

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

但是原则上可以与任何日志记录框架一起使用。如果记录器需要字符串参数,请添加toString()

答案 20 :(得分:0)

简单而琐碎的旧学校:

只需创建自己的类,然后在其中传递类名,方法名+注释(如果更改了类/方法,则会自动将其重构为Shift + F6)

public class MyLogs {    
    public static void LOG(String theClass, String theMethod, String theComment) {
        Log.d("MY_TAG", "class: " + theClass + " meth : " + theMethod + " comm : " + theComment);
    }
}

只需在应用程序中的任何位置使用它(无需上下文,无需初始化,无需额外的库且无需查找)-可以用于任何编程语言!

MyLogs.LOG("MainActivity", "onCreate", "Hello world");

这将在您的控制台中打印:

  

MY_TAG类:MainActivity方法:onCreate comm:Hello world