从java进程里dump出类的class文件的小工具--dumpclass

Serviceability Agent

想要查看一些被增强过的类的字节码,或者一些AOP框架的生成类,就需要dump出运行时的java进程里的字节码。

从运行的java进程里dump出运行中的类的class文件的方法,所知道的有两种

  • 用agent attatch 到进程,然后利用InstrumentationClassFileTransformer就可以获取 到类的字节码了。

  • 使用sd-jdi.jar里的工具

sd-jdi.jar 里自带的的sun.jvm.hotspot.tools.jcore.ClassDump就可以把类的class内容dump到文件里。

ClassDump里可以设置两个System properties:

  • sun.jvm.hotspot.tools.jcore.filter Filter的类名
  • sun.jvm.hotspot.tools.jcore.outputDir 输出的目录

sd-jdi.jar 里有一个sun.jvm.hotspot.tools.jcore.PackageNameFilter,可以指定Dump哪些包里的类。PackageNameFilter里有一个System property可以指定过滤哪些包:sun.jvm.hotspot.tools.jcore.PackageNameFilter.pkgList

所以可以通过这样子的命令来使用:

1
sudo java -classpath "$JAVA_HOME/lib/sa-jdi.jar" -Dsun.jvm.hotspot.tools.jcore.filter=sun.jvm.hotspot.tools.jcore.PackageNameFilter -Dsun.jvm.hotspot.tools.jcore.PackageNameFilter.pkgList=com.test  sun.jvm.hotspot.tools.jcore.ClassDump

显然,这个使用起来太麻烦了,而且不能应对复杂的场景。

dumpclass

dumpclass这个小工具做了一些增强,更加方便地使用。

  • 支持? *的匹配
  • 支持多个ClassLoader加载了同名类的情况。

比如多个classloader加载了多份的logger,如果不做区分,则dump出来时会被覆盖掉,也分析不出问题。

dumpclass可以在maven仓库里下载到:
http://search.maven.org/#search%7Cga%7C1%7Cdumpclass

dumpclass的用法很简单,比如:

1
2
3
4
5
6
7
Usage:
java -jar dumpclass.jar <pid> <pattern> [outputDir] <--classLoaderPrefix>

Example:
java -jar dumpclass.jar 4345 *StringUtils
java -jar dumpclass.jar 4345 *StringUtils /tmp
java -jar dumpclass.jar 4345 *StringUtils /tmp --classLoaderPrefix

对于多个ClassLoader的情况,可以使用--classLoaderPrefix,这样子在输出.class文件时,会为每一个ClasssLoader创建一个目录,比如:sun.jvm.hotspot.oops.Instance@955d26b8。并且会在目录下放一个classLoader.text文件,里面是ClassLoader.toString()的内容,方便查看具体ClassLoader是什么。

源码和文档:

https://github.com/hengyunabc/dumpclass

HSDB

sa-jdi.jar里,还有一个图形化的工具HSDB,也可以用来查看运行的的字节码。

1
sudo java -classpath "$JAVA_HOME/lib/sa-jdi.jar" sun.jvm.hotspot.HSDB

参考

http://rednaxelafx.iteye.com/blog/727938
https://docs.oracle.com/javase/7/docs/api/java/lang/instrument/ClassFileTransformer.html
http://openjdk.java.net/groups/hotspot/docs/Serviceability.html

横云断岭/hengyunabc wechat
欢迎您扫一扫上面的微信公众号,订阅横云断岭的专栏