网站首页 > java教程 正文
在 Java 中,有四种方法可以获取当前正在执行方法体的方法名称,分别是:
- 使用 Thread.currentThread().getStackTrace() 方法
- 使用异常对象的 getStackTrace() 方法
- 使用匿名内部类的 getClass().getEnclosingMethod() 方法
- Java 9 的 Stack-Walking API
本文将根据以上四种方法来给大家进行具体讲解,不过不知道大家有没有想过,获取当前执行方法体的方法名称有什么用嘞?
它可以用于日志记录、异常处理、测试框架等方面。例如我们可以在方法的开始和结束时打印出当前方法名和参数,以便追踪程序的执行流程和性能。在介绍完以上四种方法后,就会给大家揭晓面试题答案。
1.使用 Thread.currentThread().getStackTrace()方法
使用 Thread.currentThread().getStackTrace() 方法。这个方法会返回一个表示当前线程堆栈转储的 StackTraceElement 数组,每个元素代表一个堆栈帧。数组的第一个元素是 getStackTrace() 方法本身,第二个元素是调用 getStackTrace() 的方法,以此类推。因此,要获取当前方法的名称,可以使用 Thread.currentThread().getStackTrace()[1].getMethodName()。
// 获取当前方法名
String methodName = Thread.currentThread().getStackTrace()[1].getMethodName();
// 打印当前方法名
System.out.println("当前方法名:" + methodName);
这种方法的优点是简单易用,不需要创建额外的对象。缺点是性能较低,因为 Thread.currentThread().getStackTrace() 方法获取堆栈跟踪信息需要遍历整个调用栈,而且需要保证线程安全性。
2.使用异常对象的 getStackTrace()方法
使用 new Throwable().getStackTrace() 方法。这个方法和上一个方法类似,只是使用了一个 Throwable 对象来获取堆栈信息。
// 获取当前方法名
String methodName = new Throwable().getStackTrace()[0].getMethodName();
// 打印当前方法名
System.out.println("当前方法名:" + methodName);
这个方法的优点是比 Thread.currentThread().getStackTrace() 更快,因为 Throwable 对象已经知道它是针对调用线程的,不需要保持线程安全性。缺点是仍然需要遍历堆栈,而且需要创建一个 Throwable 对象,可能会增加内存开销。
3.匿名内部类的 getClass().getEnclosingMethod()方法
使用 new Object(){}.getClass().getEnclosingMethod().getName() 方法。这个方法会创建一个匿名内部类,并调用它的 getClass() 方法来获取类对象,然后调用 getEnclosingMethod() 方法来获取当前方法对象,最后调用 methodName() 方法来获取当前方法名
// 获取当前方法名
String methodName = new Object(){}.getClass().getEnclosingMethod().getName();
// 打印当前方法名
System.out.println("当前方法名:" + methodName);
这种方法的优点是不需要获取堆栈跟踪信息,而且不会创建异常对象,因此性能和可读性都较好。缺点是需要创建一个匿名内部类,可能会增加内存开销和类加载时间。
4.Java 9 的 Stack-Walking API
Java 9 引入了 Stack-Walking API,以惰性且高效的方式遍历 JVM 堆栈帧。可以使用这个 API 找到当前正在执行的方法,具体的代码如下:
StackWalker walker = StackWalker.getInstance();
Optional<String> optional = walker.walk(frames -> frames
.findFirst()
.map(StackWalker.StackFrame::getMethodName));
System.out.println("当前方法名:" + optional.get());
首先,我们使用 StackWalker.getInstance() 工厂方法获取 StackWalker 实例。然后我们使用 walk() 方法从上到下遍历栈帧:
- walk() 方法可以将堆栈帧转化为 Stream 流
- findFirst() 方法从 Stream 流中的获取第一个元素,也就是堆栈的顶部帧,顶部帧就代表当前正在执行的方法
- map() 方法用于获取顶部帧 StackFrame 的当前方法名称
Stack-Walking API 的优点
与以上方法相比,Stack-Walking API 有很多优点:
- 线程安全
- 无需创建匿名内部类实例 - new Object().getClass(){}
- 无需创建异常 - new Throwable()
- 无需急切地捕获整个堆栈跟踪,这可能成本很高 - Thread.currentThread()
StackWalker 是以一种懒惰的方式逐一遍历堆栈。在需要获取当前方法名称时,我们可以只获取顶部帧,而不需要捕获整个堆栈跟踪。
经典例子:Logback
Logback 是一个流行的 Java 日志框架,它是 Log4j 的继承者,由 Log4j 的创始人设计。Logback 有以下特点:
高性能:Logback 比其他日志框架更快,更节省空间,有时甚至大得多。
灵活配置:Logback 支持 XML 和 Groovy 两种配置方式,可以实现动态修改配置,无需重启应用。
丰富功能:Logback 提供了多种输出目标,如控制台、文件、数据库、邮件等,还支持滚动策略、过滤器、异步日志等高级功能。
与 SLF4J 集成:Logback 是 SLF4J 的原生实现,可以与其他基于 SLF4J 的日志框架无缝切换。
不知道大家有没有想过,我们在使用 Logback 日志框架中打印日志时,是如何获取当前执行方法体的方法名称的嘞?在 Spring 项目中,我们一般是通过 Logback 的 xml 文件 parttern 属性来配置日志格式的。xml 配置如下:
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<springProperty scope="context" name="appName" source="spring.application.name" defaultValue="dev"/>
<property name="logPath" value="/home/logs/${appName}"/>
<property name="pattern"
value="%d{yyyy-MM-dd HH:mm:ss.SSS} [%X{request_id}] [%thread] [%-5level] %logger{36}:%L %M - %msg%n"/>
<!-- 控制台输出 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<!-- encoder 默认配置为PatternLayoutEncoder -->
<encoder>
<pattern>${pattern}</pattern>
</encoder>
</appender>
<!-- 记录日志到文件 -->
<appender name="INFO" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>${logPath}/info.log</file>
<encoder>
<pattern>${pattern}</pattern>
</encoder>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>${logPath}/run.%d{yyyy-MM-dd}.log</fileNamePattern>
</rollingPolicy>
</appender>
...
</configuration>
可以看到我们配置的日志输出格式是 %d{yyyy-MM-dd HH:mm:ss.SSS} [%X{request_id}] [%thread] [%-5level] %logger{36}:%L %M - %msg%n,Logback 在打印日志时,会解析这个日志输出格式,最后将 %M 占位符替换为当前方法名称。
解析日志格式的源码就在 FormattingConverter 类的 write() 方法中,write() 方法中会执行 convert() 方法,这个方法就是执行占位符替换的。源码截图如下,
如上图根据类名我们可以看到红线框起来的 MethodOfCallerConverter 类就是用来执行 %M 占位符替换逻辑的,代码如下,
public class MethodOfCallerConverter extends ClassicConverter {
public String convert(ILoggingEvent le) {
StackTraceElement[] cda = le.getCallerData();
if (cda != null && cda.length > 0) {
// 返回当前方法名称
return cda[0].getMethodName();
} else {
return CoreConstants.NA;
}
}
}
方法逻辑如下,
- StackTraceElement[] cda = le.getCallerData() 获取当前堆栈顶部帧
- cda[0].getMethodName() 根据顶部帧获取当前方法名称。
如上,我们只需要看下 le.getCallerData() 方法的堆栈是从哪里获取来的,就能知道本题的答案了。
进入 LoggingEvent 源码类中,我们可以发现堆栈获取逻辑,源码如下,
public class LoggingEvent implements ILoggingEvent {
public StackTraceElement[] getCallerData() {
if (callerDataArray == null) {
// 堆栈初始化
callerDataArray = CallerData.extract(new Throwable(), fqnOfLoggerClass,
loggerContext.getMaxCallerDataDepth(), loggerContext.getFrameworkPackages());
}
return callerDataArray;
}
...
}
- 如果当前堆栈为空,进行堆栈信息初始化。这里就可以看到堆栈信息初始化来自 CallerData.extract(new Throwable(), fqnOfLoggerClass,loggerContext.getMaxCallerDataDepth(), loggerContext.getFrameworkPackages()) 方法。
- 如果堆栈信息不为空,直接返回当前堆栈。这里是为了避免浪费,针对在一个方法中重复获取堆栈信息的情况。
Ok,到这里离胜利就只差一步了。进一步查看 CallerData.extract(new Throwable(), fqnOfLoggerClass,loggerContext.getMaxCallerDataDepth(), loggerContext.getFrameworkPackages()) 方法,源码如下,
public class CallerData {
public static StackTraceElement[] extract(Throwable t, String fqnOfInvokingClass, final int maxDepth,
List<String> frameworkPackageList) {
if (t == null) {
return null;
}
StackTraceElement[] steArray = t.getStackTrace();
StackTraceElement[] callerDataArray;
...
callerDataArray = new StackTraceElement[desiredDepth];
for (int i = 0; i < desiredDepth; i++) {
callerDataArray[i] = steArray[found + i];
}
return callerDataArray;
}
...
}
为了突出源码逻辑的重点,这里我删去了一部分代码,是为了让大家更好的看清楚 Logback 中堆栈信息的初始化,其实用的就是异常对象的 getStackTrace() 方法。也就是上面源码中 StackTraceElement[] steArray = t.getStackTrace() 方法所体现的。
那么到这里我就可以下一个结论了, Logback 日志框架中打印日志时,就是使用异常对象的 getStackTrace() 方法来获取当前执行方法的方法名称的。
总结
本文有介绍四种方法获取当前执行方法名称,一般情况下大家使用异常对象的 getStackTrace() 方法以及匿名内部类的 getClass().getEnclosingMethod() 方法都是可以的,它们的性能都 OK,代码书写复杂程度都大差不差。在 Java 9 以后推荐使用 Stack-Walking API,它的功能更为强大,与程序里的堆栈语意也跟为契合,性能 OK,并且还是线程安全的。
猜你喜欢
- 2024-10-12 Java好用的时间类,别再用Date了(java时间工具包)
- 2024-10-12 一文详解Java LocalDateTime(一文详解国资委79号文)
- 2024-10-12 Java时间类从此变得清晰明了(java时间属性)
- 2024-10-12 JAVA8时间操作总结(java8时间处理)
- 2024-10-12 用java中的时间类实现一个日历(java中如何实现日期类)
- 2024-10-12 python获取时间戳(10位和13位)(py获取当前时间戳)
- 2024-10-12 Java修炼终极指南:68. 计算给定日期的季度
- 2024-10-12 让大学生写的一个计算时间的方法,有人看得出来是在做什么吗?这
- 2024-10-12 6种快速统计代码执行时间的方法,真香
- 2024-10-12 switch case 求输入年月日,输出该天为该年的第几天
你 发表评论:
欢迎- 最近发表
- 标签列表
-
- java反编译工具 (77)
- java反射 (57)
- java接口 (61)
- java随机数 (63)
- java7下载 (59)
- java数据结构 (61)
- java 三目运算符 (65)
- java对象转map (63)
- Java继承 (69)
- java字符串替换 (60)
- 快速排序java (59)
- java并发编程 (58)
- java api文档 (60)
- centos安装java (57)
- java调用webservice接口 (61)
- java深拷贝 (61)
- 工厂模式java (59)
- java代理模式 (59)
- java.lang (57)
- java连接mysql数据库 (67)
- java重载 (68)
- java 循环语句 (66)
- java反序列化 (58)
- java时间函数 (60)
- java是值传递还是引用传递 (62)
本文暂时没有评论,来添加一个吧(●'◡'●)