Java系统工具jps原理解析

Posted by Drifting Fish Blog on May 25, 2016

Java系统工具jps原理解析


简介

当我们需要获取当前正在运行的Java进程时,我们可以通过操作系统自带的工具来筛选,如ps和netstat等。不过Java也提供了通用的工具来实现该功能,而且能够提供更加详细的信息。jps是Java Virtual Machine Process Status Too的简称,可以用来获取当前用户系统中的Java进程。

使用

jps的命令格式为 jps [ options ] [ hostid ],具体形式如下:

usage: jps [-help]
       jps [-q] [-mlvV] [<hostid>]

Definitions:
    <hostid>:      <hostname>[:<port>]

其中的参数解释如下(其中mlvV可以组合使用):

  • q:只显示Java进程的lvmid,不显示class名称、jar文件名和传递给main 方法的参数等
  • m:输出传递给main方法的参数
  • l:输出应用程序入口函数的完整package名或者应用程序的jar文件完整路径名
  • v:输出传递给JVM的参数
  • V:通过标识文件来输出传递给JVM的参数(即.hotspotrc文件或者由参数-XX:Flags=确定的文件)
  • hostid:需要查看Java进程的系统,由主机名和端口号来确定

注:查看本地Java进程不需要hostid参数,如果要查看远程进程,需要在远程主机提供jstatd服务和RMI绑定,稍后会介绍jstatd

jps的输出结果格式为 lvmid [ [ classname | JARfilename | "Unknown"] [ arg* ] [ jvmarg* ] ],下面是在Ubuntu系统中进行的测试实例:

shenjie@ubuntu:~$ jps
3540 org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar
3669 Main
4535 Jps

shenjie@ubuntu:~$ jps -m
4548 Jps -m
3540 org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar -os linux -ws gtk -arch x86_64 -showsplash /usr/share/eclipse//plugins/org.eclipse.platform_4.4.2.v20150204-1700/splash.bmp -launcher /usr/share/eclipse/eclipse -name Eclipse --launcher.library /usr/share/eclipse//plugins/org.eclipse.equinox.launcher.gtk.linux.x86_64_1.1.200.v20150204-1316/eclipse_1607.so -startup /usr/share/eclipse//plugins/org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar --launcher.appendVmargs -exitdata 220011 -product org.eclipse.epp.package.java.product -vm /usr/bin/java -vmargs -Dosgi.requiredJavaVersion=1.6 -XX:MaxPermSize=256m -Xms40m -Xmx512m -jar /usr/share/eclipse//plugins/org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar
3669 Main

shenjie@ubuntu:~$ jps -l
4738 sun.tools.jps.Jps
3540 /usr/share/eclipse//plugins/org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar
3669 local.Main

shenjie@ubuntu:~$ jps -v
3540 org.eclipse.equinox.launcher_1.3.0.v20140415-2008.jar -Dosgi.requiredJavaVersion=1.6 -XX:MaxPermSize=256m -Xms40m -Xmx512m
3669 Main -Dfile.encoding=UTF-8
4907 Jps -Dapplication.home=/usr/lib/jvm/jdk1.8.0_45 -Xms8m

原理

下面解析一下jps如何实现的,参看的代码来自openjdk7。我们从入口类Jps.java看起,这个类中就一个Main方法,核心的代码如下图所示,首先从特定的主机上获取正在运行的Java进程,然后对这些进程进行输出,如果有参数的话还要额外输出参数需要输出的信息。从主机获取Java进程主要有分为两种,一种是本地的,另一种通过RMI远程调用的。

            HostIdentifier hostId = arguments.hostId();
            MonitoredHost monitoredHost =
                    MonitoredHost.getMonitoredHost(hostId);

            // 从特定主机上获取Java进程
            Set jvms = monitoredHost.activeVms();

            for (Iterator j = jvms.iterator(); j.hasNext(); /* empty */ ) {
                StringBuilder output = new StringBuilder();
                Throwable lastError = null;

                int lvmid = ((Integer)j.next()).intValue();

                output.append(String.valueOf(lvmid));

                if (arguments.isQuiet()) {
                    System.out.println(output);
                    continue;
                }

                MonitoredVm vm = null;
                String vmidString = "//" + lvmid + "?mode=r";

                String errorString = null;

                // 处理其他参数
            }

我们主要看一下从本地获取Java进程的代码,monitoredHost.activeVms()方法最后通过LocalVmManager中的activeVms()来实现。通过看下面的代码,我们容易发现最后返回的lvmid集合jvmSet中的元素都是通过类似PerfDataFile.getLocalVmId(files[j])的方法添加的,而这些files的文件夹也是通过类PerfDataFile中的函数PerfDataFile.getTempDirectory(userName)得来的。细心的同学应该发现文件夹的结构会根据有无用户名而发生变化,而通过PerfDataFile中的代码可以发现该文件夹下的文件名也有着两种不同的标准。接下去我们继续看类PerfDataFile。

public synchronized Set<Integer> activeVms() {
        /*
         * This method is synchronized because the Matcher object used by
         * fileFilter is not safe for concurrent use, and this method is
         * called by multiple threads. Before this method was synchronized,
         * we'd see strange file names being matched by the matcher.
         */
        Set<Integer> jvmSet = new HashSet<Integer>();

        if (! tmpdir.isDirectory()) {
            return jvmSet;
        }

        if (userName == null) {
            /*
             * get a list of all of the user temporary directories and
             * iterate over the list to find any files within those directories.
             */
            File[] dirs = tmpdir.listFiles(userFilter);

            for (int i = 0 ; i < dirs.length; i ++) {
                if (!dirs[i].isDirectory()) {
                    continue;
                }

                // get a list of files from the directory
                File[] files = dirs[i].listFiles(fileFilter);

                if (files != null) {
                    for (int j = 0; j < files.length; j++) {
                        if (files[j].isFile() && files[j].canRead()) {
                            jvmSet.add(new Integer(
                                    PerfDataFile.getLocalVmId(files[j])));
                        }
                    }
                }
            }
        } else {
            /*
             * Check if the user directory can be accessed. Any of these
             * conditions may have asynchronously changed between subsequent
             * calls to this method.
             */

            // get the list of files from the specified user directory
            File[] files = tmpdir.listFiles(fileFilter);

            if (files != null) {
                for (int j = 0; j < files.length; j++) {
                    if (files[j].isFile() && files[j].canRead()) {
                        jvmSet.add(new Integer(
                                PerfDataFile.getLocalVmId(files[j])));
                    }
                }
            }
        }

        // look for any 1.4.1 files
        File[] files = tmpdir.listFiles(tmpFileFilter);
        if (files != null) {
            for (int j = 0; j < files.length; j++) {
                if (files[j].isFile() && files[j].canRead()) {
                    jvmSet.add(new Integer(
                            PerfDataFile.getLocalVmId(files[j])));
                }
            }
        }

        return jvmSet;
    }
}

类PerfDataFile提供了Java进程与文件相互转换的方法。从该类中可以找到各系统下这些文件的对应位置,如方法getTempDirectory所示,该临时目录的路径如下: tmpDirName + dirNamePrefix + user + File.separator,其中tmpDirName为Java io对应的临时文件,dirNamePrefix固定为”hsperfdata_“,user是系统用户名,File.separator是文件分隔符。在Windows系统下,默认路径为 C:\Users\username\AppData\Local\Temp\hsperfdata_username,而在Linux系统下,默认路径为/tmp/hsperfdata_username。在这些文件夹下的文件会在对应的Java进程结束被清除。方法getLocalVmId是用来从进程文件得到lvmid,可以看出1.4.2版本及以后的HotSpot虚拟机直接以lvmid为名字,之前的版本中拥有分隔符。

注:Windows中的临时文件可能为隐藏文件

    public static String getTempDirectory(String user) {
        return tmpDirName + dirNamePrefix + user + File.separator;
    }
    
    public static int getLocalVmId(File file) {
        int lvmid = 0;

        try {
            // try 1.4.2 and later format first
            return Integer.parseInt(file.getName());
        } catch (NumberFormatException e) { }

        // now try the 1.4.1 format
        String name = file.getName();
        if (name.startsWith(dirNamePrefix)) {
            int first = name.indexOf('_');
            int last = name.lastIndexOf('_');
            try {
                if (first == last) {
                    return Integer.parseInt(name.substring(first + 1));
                } else {
                    return Integer.parseInt(name.substring(first + 1, last));
                }
            } catch (NumberFormatException e) { }
        }
        throw new IllegalArgumentException("file name does not match pattern");
    }

总结

本文主要讲解了jps的使用方法及它的实现原理是什么。进一步可以思考如下一些问题:

  1. 这些进程对应的文件是什么时候写入对应文件夹中的?
  2. jps的参数是如何解析文件中的内容的?

感兴趣的同学可以继续通过阅读源码来深入了解。

  • 本文由 DRFish(http://www.drfish.me/)原创,转载请写明原链接,谢谢。