JVM启动参数中标准参数列表速查手册

本文向大家介绍一下JVM启动参数的类别和具体用法，JVM启动参数可以分为三类，这里主要介绍一下标准参数，标准参数是所有的JVM实现都必须实现这些参数的功能，而且向后兼容。

JVM启动参数解析

JVM启动参数共分为三类；

其一是标准参数（-），所有的JVM实现都必须实现这些参数的功能，而且向后兼容；
    其二是非标准参数（-X），默认jvm实现这些参数的功能，但是并不保证所有jvm实现都满足，且不保证向后兼容；
    其三是非Stable参数（-XX），此类参数各个jvm实现会有所不同，将来可能会随时取消，需要慎重使用；
    本文主要描述标准参数部分，剩下的两个部分将会陆续推出。

JVM启动参数之标准参数列表如下：

-client

设置jvm使用client模式，特点是启动速度比较快，但运行时性能和内存管理效率不高，通常用于客户端应用程序或者PC应用开发和调试。

-server

此JVM启动参数中的标准参数用来设置jvm使server模式，特点是启动速度比较慢，但运行时性能和内存管理效率很高，适用于生产环境。在具有64位能力的jdk环境下将默认启用该模式，而忽略-client参数。

-agentlib:libname[=options]

用于装载本地lib包；
其中libname为本地代理库文件名，默认搜索路径为环境变量PATH中的路径，options为传给本地库启动时的参数，多个参数之间用逗号分隔。在Windows平台上jvm搜索本地库名为libname.dll的文件，在linux上jvm搜索本地库名为libname.so的文件，搜索路径环境变量在不同系统上有所不同，比如Solaries上就默认搜索LD_LIBRARY_PATH。

比如：-agentlib:hprof

用来获取jvm的运行情况，包括CPU、内存、线程等的运行数据，并可输出到指定文件中；windows中搜索路径为JRE_HOME/bin/hprof.dll。

-agentpath:pathname[=options]
按全路径装载本地库，不再搜索PATH中的路径；其他功能和agentlib相同；更多的信息待续，在后续的JVMTI部分会详述。

-classpathclasspath
-cpclasspath

此JVM启动参数中的标准参数用来告知jvm搜索目录名、jar文档名、zip文档名，之间用分号;分隔；使用-classpath后jvm将不再使用CLASSPATH中的类搜索路径，如果-classpath和CLASSPATH都没有设置，则jvm使用当前路径(.)作为类搜索路径。
jvm搜索类的方式和顺序为：Bootstrap，Extension，User。

Bootstrap中的路径是jvm自带的jar或zip文件，jvm首先搜索这些包文件，用System.getProperty("sun.boot.class.path")可得到搜索路径。
Extension是位于JRE_HOME/lib/ext目录下的jar文件，jvm在搜索完Bootstrap后就搜索该目录下的jar文件，用System.getProperty("java.ext.dirs")可得到搜索路径。
User搜索顺序为当前路径.、CLASSPATH、-classpath，jvm最后搜索这些目录，用System.getProperty("java.class.path")可得到搜索路径。

-Dproperty=value

设置系统属性名/值对，运行在此jvm之上的应用程序可用System.getProperty("property")得到value的值。如果value中有空格，则需要用双引号将该值括起来，如-Dname="spacestring"。
该参数通常用于设置系统级全局变量值，如配置文件路径，以便该属性在程序中任何地方都可访问。

-enableassertions[:<packagename>"..."|:<classname>]
-ea[:<packagename>"..."|:<classname>]

上述JVM启动参数就用来设置jvm是否启动断言机制（从JDK1.4开始支持），缺省时jvm关闭断言机制。用-ea可打开断言机制，不加<packagename>和classname时运行所有包和类中的断言，如果希望只运行某些包或类中的断言，可将包名或类名加到-ea之后。例如要启动包com.wombat.fruitbat中的断言，可用命令java-ea:com.wombat.fruitbat...<MainClass>。

-disableassertions[:<packagename>"..."|:<class;]
-da[:<packagename>"..."|:<classname>]

用来设置jvm关闭断言处理，packagename和classname的使用方法和-ea相同，jvm默认就是关闭状态。
该参数一般用于相同package内某些class不需要断言的场景，比如com.wombat.fruitbat需要断言，但是com.wombat.fruitbat.Brickbat该类不需要，则可以如下运行：
java-ea:com.wombat.fruitbat...-da:com.wombat.fruitbat.Brickbat<MainClass>。

-enablesystemassertions
-esa

激活系统类的断言。

-disablesystemassertions
-dsa

关闭系统类的断言。

-jar

指定以jar包的形式执行一个应用程序。
要这样执行一个应用程序，必须让jar包的manifest文件中声明初始加载的Main-class，当然那Main-class必须有publicstaticvoidmain(String[]args)方法。

-javaagent:jarpath[=options]

指定jvm启动时装入java语言设备代理。

Jarpath文件中的mainfest文件必须有Agent-Class属性。代理类也必须实现公共的静态publicstaticvoidpremain(StringagentArgs,Instrumentationinst)方法（和main方法类似）。当jvm初始化时，将按代理类的说明顺序调用premain方法；具体参见java.lang.instrument软件包的描述。

-verbose
-verbose:class

这个JVM启动参数中的标准参数用来输出jvm载入类的相关信息，当jvm报告说找不到类或者类冲突时可此进行诊断。

-verbose:gc

输出每次GC的相关情况。

-verbose:jni

输出native方法调用的相关情况，一般用于诊断jni调用错误信息。

-version

输出java的版本信息，比如jdk版本、vendor、model。

-version:release

指定class或者jar运行时需要的jdk版本信息；若指定版本未找到，则以能找到的系统默认jdk版本执行；一般情况下，对于jar文件，可以在manifest文件中指定需要的版本信息，而不是在命令行。

release中可以指定单个版本，也可以指定一个列表，中间用空格隔开，且支持复杂组合，比如：

-version:"1.5.0_041.5*&1.5.1_02+"

指定class或者jar需要jdk版本为1.5.0_04或者是1.5系列中比1.5.1_02更高的所有版本。

-showversion

输出java版本信息（与-version相同）之后，继续输出java的标准参数列表及其描述。

-?
-help

输出java标准参数列表及其描述。

-X

输出非标准的参数列表及其描述。

以上的这些JVM启动参数的标准参数我们经常会在很多情况下用到多个的组合，比如我们在用JProfiler进行跟踪监控时，需要在被监控java启动参数中加上如下配置：

-agentlib:jprofilerti=port=8849-Xbootclasspath/a:/usr/local/jprofiler5/bin/agent.jar
其中就用到两个-agentlib和-X参数，bootclasspath参数的详细信息将会在非标准参数中详细说明。