Java启动参数设置

时间:2024-03-05 10:19:39
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[:"..."|:]

-ea[:"..."|:] 
上述JVM启动参数就用来设置jvm是否启动断言机制(从JDK1.4开始支持),缺省时jvm关闭断言机制。用-ea可打开断言机制,不加和classname时运行所有包和类中的断言,如果希望只运行某些包或类中的断言,可将包名或类名加到-ea之后。例如要启动包com.wombat.fruitbat中的断言,可用命令java-ea:com.wombat.fruitbat...。 
-disableassertions[:"..."|:"..."|:] 
用来设置jvm关闭断言处理,packagename和classname的使用方法和-ea相同,jvm默认就是关闭状态。

该参数一般用于相同package内某些class不需要断言的场景,比如com.wombat.fruitbat需要断言,但是com.wombat.fruitbat.Brickbat该类不需要,则可以如下运行:

java-ea:com.wombat.fruitbat...-da:com.wombat.fruitbat.Brickbat。 
-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报告说找不到类或者类冲突时可此进行诊断。

格式:java [jvmargs] class [arguments]

 

Java虚拟机启动参数
一、标准参数
1.-server 
-client
虚拟机服务器模式/客户机模式,使用server模式可以提高性能,启动比client模式慢,长期运行则比client模式快。当该参数不指定时,虚拟机启动检测主机是否为服务器,如果是则以server模式启动,否则以client模式启动,J2SE5.0检测的根据是至少2个CPU和最低2GB内存
2.-agentlib: <lib-name></lib-name> = <options></options> 
-agentpath: <lib-path></lib-path> = <options></options> 
本地类库加载,当你的部分类包含一些本地方法时,需要自己编写本地代码并位于操作系统加载共享包(dll)的路径上,如果你不喜欢将该包放在操作系统识别的加载上,则可以通过指定这个参数来加载自己的本地共享包(dll)。不同之处在于-agentlib中仅指定包名,根据操作系统的不同虚拟机在一定路径上搜索该包,譬如对于windows平台虚拟机在PATH路径上搜索该包,而lib-path则是指定全路径,例如
-agentlib:hprof 在windows平台虚拟机会在启动时到PATH路径上搜索hprof.dll并加载
虚拟机在加载代理包之后有一个启动的操作(详细参见JDK参考), <options></options> 指的是代理包的启动参数
3.-classpath classpath
-c classpath
指定类路径,系统应用类加载器(ClassLoader)会到该路径下加载类
4.-Dproperty=value
设置系统属性,可以通过System.getProperty(property)获得
5.-enableassertions[: <package></package> "..." | :<class></class> ]
-ea[: <package></package> "..." | :<class></class> ]
-disableassertions[: <package></package> "..." | :<class></class>
-da[: <package></package> "..." | :<class></class> ] 
启用和停用断言,默认是停用断言。断言指的是从JDK1.4开始在支持的关键字assert,assert(booleanvalue),当 booleanvalue为false时,抛出java.lang.AssertionError,必须指出的是,代码编译必须是1.4及其以上顺从的, 即编译时使用如下参数
java -source 1.4
一般仅在开发阶段启用断言,而在运行阶段不使用
其使用包括如下几种情况
java -ea //启动断言
java -ea:pkname... //在包pkname及其子包下起用断言
java -ea:pkname.classname //对类 pkname.classname启用断言
停用断言与启用设置类似
6.-enablesystemassertions
-esa 
-disablesystemassertions
-dsa 
启用和停用系统类断言
7.-jar
运行包含在一个jar包里的程序,一般在jar包的/META-INF/MANIFEST.MF文件中指定Main-Class值为要运行的主函数,譬如 Main-Class:ayufox.ejb3.Test
8.-javaagent:<classname></classname>[<=options>]
加载java语言代理,该功能是JDK5新增加的,可以通过该设置在JVM运行主函数(main)之前做一些预处理工作,其中classname中必须包含有静态方法
public static void premain(String agentArgs, Instrumentation inst) { ... }
上面的options即是传入该函数的代理参数agentArgs,关于Instrumentation详细参见包java.lang.instrument
9.-verbose
-verbose:class
-verbose:gc
-verbose:jni 
在运行时
class:将类加载情况在控制台中打印出来
gc:将虚拟机的垃圾回收事件信息打印
jni:放本地方法调用信息打印
-verbose与-verbose:class一样
10.-version
-showversion
显示版本信息,不同在于第一种显示版本后虚拟机结束退出
11.-?
-help
显示帮助信息并退出 
12.-X
显示非标准参数(见下面介绍)并退出

二、非标准参数(以-X开头)
1.-Xint
所有字节码以解析模式运行。第一代虚拟机即是以这种方式运行,由于需要Java解析器解析运行,所以效率比较低;第二代虚拟机则采用将字节码编译成本地代 码的方式,效率大大提高;第三代虚拟机也叫自适应(HotSpot)虚拟机,通过监测代码的执行情况检测出代码被频繁执行的部分,将其尽量优化成本地代码 方式运行,而对于普通部分,则采用解析的模式运行。
2.-Xbatch
禁止后台编译,一般HotSpot虚拟机在检测到一段代码为频繁执行代码需要将其编译成本地代码时,会启动一个后台线程完成这个工作,而同时采用解析的方式继续运行字节码。如果设置了该参数,则会停止继续执行字节码,先将其编译成本地代码,然后再继续执行。
3.-Xdebug 
-Xnoagent
-Xrun
-Xrunjdwp
启用调试模式,见前面的《利用JPDA构建调试平台》这篇文章,后面将在一个独立的文章中详细介绍
4.-Xbootclasspath:bootclasspath 
-Xbootclasspath/a:path 
-Xbootclasspath/p:path 
设置启动根Classpath,即使启动类加载器将在何处加载对象,关于类启动加载器,参见《JVM类 加载器体系结构》说明,分号后面的值指定路径,以分号隔开。其区别在于,-Xbootclasspath:bootclasspath将新的根加载路径覆 盖默认的路径(\jre\lib\rt.jar),-Xbootclasspath/a:path将新的根加载路径和原有的根加载路径相结 合,-Xbootclaspath/p:path将新的根加载路径与原有的根加载路径相结合,加载类时优先搜索该加载路径
5.-Xcheck:jni
对本地调用(JNI)采用更严格的检测方式,在进行JNI调用之前检测数据和传入参数,如果碰到不合法的数据则强制结束掉虚拟机,对运行性能有损害
6.-Xfuture
对类格式(class文件格式)采用更严格的检测方式,以便向后兼容,最好在开发时采用该参数
7.-Xnoclassgc
不使用垃圾回收
8.-Xloggc:file
与-verbose:gc功能一样,不同在于-Xloggc:file将信息记录到一个文件,而-verbose:gc将其输出到控制台
9.-Xincgc
-Xmsn
-Xmxn
-Xssn 
跟内存分配和垃圾回收相关,-Xincgc表示采用渐进式垃圾回收,-Xmsn设置初始内存池大小,-Xmxn表示内存池允许的最大大小,-Xssn是线程栈大小,n是要设置的值,必须是1024的倍数,譬如
-Xms6291456 -Xmx83886080
-Xms6144k -Xmx81920k
-Xms6m -Xmx80m
该部分对虚拟机的性能非常重要,在后面将有独立的篇章详细介绍
10.-Xprof
-Xrunhprof[:help][:<suboption></suboption>=<value></value>,...]
在运行时剖析运行情况,并将剖析结果打印到控制台,其中后一个可以指定特定剖析对象,譬如cpu,堆(heap)等,可以运行java -Xrunhprof:help获得可以剖析的对象和取值
11.-Xrs
减少JVM对操作系统信号量的使用,J2SE1.3.1开始引入。
SUN在J2SE1.3.0中增加了Java应用程序关闭时的回调钩子(Hook),以便当JVM意外终止时用户可以做一些资源清除工作。JVM监视控制台事件以实现JVM意外终止时的回调。JVM明确地注册了一个控制台控制处理器,当JVM接收到CTRL_C_EVENT, CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT, 或CTRL_SHUTDOWN事件时,该处理器介入关闭回掉钩子(HOOK)的处理。
如果虚拟机以服务的方式运行(譬如WEB服务器)当其收到CTRL_LOGOFF_EVENT事件,由于系统并不会因此终止JVM进程,故JVM不可以进行终止的操作,然而这与如上产生了冲突(不结束却又调用关闭回调钩子),为了避免这个问题,从J2SE1.3.1使用-Xrs以使JVM不再监测控制台事件。