已经使用了一段时间的JAVA,期间也了解和用过一些JVM(Java Virtual machine)参数,但是没有仔细去整理过每个参数代表的意义,为此整理成文。
Java使用方式
java [options] classname [args]
java [options] -jar filename [args]
options: 命令行选项,空格分隔
classname: 启动的class名称
filename: Jar包名称(JAR)
args: main()方法参数,空格隔开
加载的class的main()方法必须定义为public static,并且无返回值,参数是字符串列表
public static void main(String[] args)
如果使用-jar选项,则args是JAR包包含的class。启动class必须通过Main-Class的manifest指定,示例如下:
jar {
manifest {
attributes 'Main-Class': 'com.xx.xx'
}
}
Java 命令行提供了以下几种类型的选项
标准选项
非标准选项
高级运行选项
高级JIT编译选项
高级垃圾回收选项
高级可用性选项
(1) 标准选项被所有类型的JVM支持。标准选项用来做常规操作,如查看版本,设定class path等。
(2) 非标准选项一般是指Java HotSpot Virtual Machine特定的选项,不能保证被所有类型的JVM支持,该类选项使用时,以-X开头。
(3) 高级选项是用于Java HotSpot Virtual Machine特定区域调优的选项,同样不能保证被所有的JVM支持。该类选择使用时,以-XX开头。对于Boolean类型的选项,通过使用+表示选项生效,- 来标示选项无效。如-XX:+OptionName表示选项OptionName生效,-XX:-OptionName表示选项OptionName无效。
所有类型的JVM均支持标准选项, 为此简单列举经常用到的几个选项。
-d32
将应用运行在32bit的环境,如果32bit环境未初始化或不支持,则报错。默认是运行在32bit环境。
-d64
将应用运行在64bit环境。如果64bit环境未初始化或不支持,则报错。默认是运行在32bit环境。
-help/-?
显示帮助文档
-verbose:class
显示每个加载的class
-verbose:gc
显示每次垃圾回收事件
-version
显示当前java 版本
-disableassertions[:[packagename]…|:classname] / -da[:[packagename]…|:classname]
禁用断言(assert),可以指定禁用断言的package和class。
-disablesystemassertions / -dsa
禁用全部断言(assert)
-enableassertions[:[packagename]…|:classname] / -ea[:[packagename]…|:classname]
启用断言,可以指定package和class。默认断言是禁用的。
-enablesystemassertions / -esa
启用全部断言(assert)
-server
选择Java HotSpot Server VM。64bit版本隐含设置-server。
-D[property]=value
定义系统属性值。property变量是一个字符串代表属性名,value代表设定的属性值。
以设置系统的文件编码为utf-8为例:
-Dfile.encoding=utf-8
非标准选项一般是指Java HotSpot Virtual Machine特定的选项。列举经常用到的几个选项。
-X
显示有效的-X选项的帮助信息
-Xbatch
禁用后台编译。默认情况下JVM是后台编译。该选项等同于 -XX:-BackgroundCompilation
-Xloggc:filename
将GC(garbage collection)信息重定向到filename。当-Xloggc和-verbose:gc同时给出时,-Xloggc将重载-verbose:gc
-Xmnsize
设置堆中年轻代(young generation)的初始值和最大值大小。单位是bytes,常用K,M,G (不区分大小写)
年轻代主要放置新对象,这块区域也是GC执行比较频繁的区域。如果该区域设置较小,可能导致频繁minor GC,如果设置过大,只有Full GC执行则每次GC耗时较长。Oracle建议的大小是整个堆大小的1/4 - 1/2之间。
以设置大小为256 MB为例:
-Xmn256m
不同于-Xmn同时设置初始值和最大值,可通过-XX:NewSize设置初始,-XX:MaxNewSize设置最大值。
-Xmssize
设置堆的初始值,该值必须是1024的倍数并且大于1MB。
以设置初始值6 MB的堆为例:
-Xms6m
如果该值不设置,则通过计算年轻代和老年代的和作为堆的初始值
-Xmxsize
指定应用的最大内存大小,该值必须是1024的倍数并且大于2MB。对于服务型应用,-Xms和-Xmx常设置为相同,至于原因涉及垃圾回收机制,如果两者设置相同则应用占据的内存不进行动态扩展。
以设置最大内存大小1G为例:
-Xmx1g
-Xmx等价于高级选项-XX:MaxHeapSize
-Xsssize
设置线程栈的大小。
以设置大小为1024KB的线程栈为例:
-Xss1024k
-Xss等价于高级选项-XX:ThreadStackSize
高级运行选项
该类选项控制Java HotSpot VM运行时的情况。列举经常用到的几个选项。
-XX:+DisableAttachMechanism
启用该选项会导致附件在JVM的工具类如jcmd, jstack,jmap jinfo无效。默认情况该选项无效,JVM提供的工具类可使用。
-XX:MaxDirectMemorySize=size
设置最大直接内存大小为size,对于新IO可以使用堆外内存(直接内存)构建对象,该选项是设置这块区域的大小。
以设置最大直接内存1MB为例:
-XX:MaxDirectMemorySize=1m
-XX:ThreadStackSize
设置线程栈大小,等价于-Xss选项。
该类选项提供收集系统信息和debug的能力。列举经常用到的几个选项。
-XX:+HeapDumpOnOutOfMemory
启用该选项,当出现java.lang.OutOfMemoryError异常时,Java的堆信息会dump到当前目录的文件中,文件命名为: java_pid[进程PID].hprof,可以通过-XX:HeapDumpPath指定dump文件路径。通过dump的文件我们利用工具,如MemoryAnalyzer,可以查看系统当时的情况,默认禁用。
-XX:HeapDumpPath=path
指定OutOfMemoryError异常时dump文件的路径,示例如下:
# 指定dump文件路径
-XX:HeapDumpPath=/var/log/java_heapdump.hprof
-XX:LogFile=path
设置log文件,默认情况下在当前目前,命名为hotspot.log。一般我们会利用slf4j工具设置日志,该选项倒不怎么使用。
该类选项是Java HotSpot VM 用来控制垃圾回收。
-XX:+AggressiveHeap
启用Java堆优化。基于服务器的情况自适应的进行堆优化。默认禁用。
-XX:+CMSClassUnloadingEnabled
启用类卸载当使用CMS(the concurrent mark-sweep)垃圾收集器时。默认启用。如果禁用该选择,设置为-XX:-CMSClassUnloadingEnabled
-XX:CMSInitiatingOccupancyFraction=precent
设置老年代占比当开始CMS垃圾收集时,数值在0-100之间。默认值-1。
以老年代占比70%为例:
-XX:CMSInitiatingOccupancyFraction=70
1
-XX:ConcGCThreads=threads
设置垃圾回收线程的个数在并发GC时。默认值为JVM中有效的CPU的个数。
以线程个数2为例:
-XX:ConcGCThreads=2
1
-XX:ParallelGCThreads=threads
设置垃圾回收线程的个数在并行GC时。默认值为JVM中有效的CPU的个数。
以线程个数2为例:
-XX:ParallelGCThreads=2
1
-XX:+DisableExplicitGC
启用该选项,程序中调用System.gc()的处理均无效。默认禁用该选项,即程序中显示调用System.gc()是执行的。
-XX:InitialHeapSize=size
设置应用内存初始大小,该值为0或为1024的倍数并且大于1 MB
以设置初始内存大小为6 MB为例:
-XX:InitialHeapSize=6m
-XX:InitialHeapSize=6144k
-XX:InitialHeapSize=62914561
如果设置为0,则初始值为老年代和新生代的和。
-XX:MaxHeapSize=size
设置应用内存最大值,该值为1024的倍数并且大于2 MB,该值通常与-XX:InitialHeapSize设置相同。
该选项等价于-Xmx
-XX:NewRatio=ratio
设置年轻代和老年代的比值,默认为2。
以比值为1为例:
-XX:NewRatio=1
-XX:NewSize=size
设置堆的年轻代的初始值大小,等价于选项 -Xmn
-XX:+PrintGCDetails
打印每一次GC的详细信息,默认禁用。
-XX:+PrintGCDateStamps
每次GC均显示时间戳,默认禁用
-XX:+PrintGCApplicationStoppedTime
打印GC延迟时长,默认禁用
-XX:+UseConCMarkSweepGC
启用该选项表示在老年代的垃圾回收采用CMS垃圾回收器。启用该选项之后,-XX:+UseParNewGC选项会自动启用,并且不能禁用。默认禁用。在JDK 8中,老年代使用CMS的组合方式,年轻代不使用ParNew,即-XX:-UseParNewGC和-XX:+UseConCMarkSweepGC被废弃。
-XX:+UseG1GC
启用G1(garbage-first)垃圾收集器。G1是一种服务器风格的垃圾收集器,针对具有大量RAM的多处理器机器。目标是减少GC延时并且保持吞吐量。建议在设置堆(>= 6 GB)较大时使用。默认禁用。
-XX:+UseParallelGC
启用Parallel Scavenge垃圾收集器,该垃圾收集器是多进程处理,目标是提高吞吐量。该选项启用后,-XX:+UseParallelOldGC会自动启用,除非显示禁用。默认禁用。
-XX:+UseParallelOldGC
启用该选项,在Full GC时使用Parallel Garbage 垃圾收集器。默认禁用。与-XX:+UseParallelGC配对使用。
-XX:+UseParNewGC
启用该选项,在年轻代采用并行线程垃圾回收器。默认禁用。在JDK 8中,年轻代使用ParNew,老年代不使用CMS的组合方式,即-XX:+UseParNewGC和-XX:-UseConCMarkSweepGC被废弃。
-XX:+UseSerialGC
启用单线程垃圾回收器。针对简单的小应用,不需要特别垃圾回收设置,该选项是一个交好的选择。默认禁用。
最后配张年轻代和老年代垃圾回收器的组合图,加深理解。
[1] jdk 1.8 帮助文档
[2] 深入理解Java虚拟机: JVM高级特性和最佳实践