Java启动命令(-, -X, -XX参数)_java 启动命令

Java启动命令是所有java应用程序的入口，通过它来启动Java运行时环境，并加载相关的class。

使用java命令行启动项目的一些参数总结
Java启动命令大观

Java启动参数分类

类别1: 其一是标准参数（-），所有的JVM实现都必须实现这些参数的功能，而且向后兼容；
类别2: 其二是非标准参数（-X），默认jvm实现这些参数的功能，但是并不保证所有jvm实现都满足，且不保证向后兼容；
类别3: 其三是非Stable参数（-XX），此类参数各个jvm实现会有所不同，将来可能会随时取消，需要慎重使用；
[root@master ~]# java -h
用法: java [-options] class [args…] (执行类)
或 java [-options] -jar jarfile [args…] (执行 jar 文件)
其中选项包括:
-d32 使用 32 位数据模型 (如果可用)
-d64 使用 64 位数据模型 (如果可用)
-server 选择 “server” VM，默认 VM 是 server，因为您是在服务器类计算机上运行。

-cp <目录和 zip/jar 文件的类搜索路径>
-classpath <目录和 zip/jar 文件的类搜索路径>
              用 : 分隔的目录, JAR 档案
              和 ZIP 档案列表, 用于搜索类文件。
-D<名称>=<值>
              设置系统属性
-verbose:[class|gc|jni]
              启用详细输出
-version      输出产品版本并退出
-version:<值>
              警告: 此功能已过时, 将在
              未来发行版中删除。
              需要指定的版本才能运行
-showversion  输出产品版本并继续
-jre-restrict-search | -no-jre-restrict-search
              警告: 此功能已过时, 将在
              未来发行版中删除。
              在版本搜索中包括/排除用户专用 JRE
-? -help      输出此帮助消息
-X            输出非标准选项的帮助
-ea[:<packagename>...|:<classname>]
-enableassertions[:<packagename>...|:<classname>]
              按指定的粒度启用断言
-da[:<packagename>...|:<classname>]
-disableassertions[:<packagename>...|:<classname>]
              禁用具有指定粒度的断言
-esa | -enablesystemassertions
              启用系统断言
-dsa | -disablesystemassertions
              禁用系统断言
-agentlib:<libname>[=<选项>]
              加载本机代理库 <libname>, 例如 -agentlib:hprof
              另请参阅 -agentlib:jdwp=help 和 -agentlib:hprof=help
-agentpath:<pathname>[=<选项>]
              按完整路径名加载本机代理库
-javaagent:<jarpath>[=<选项>]
              加载 Java 编程语言代理, 请参阅 java.lang.instrument
-splash:<imagepath>
              使用指定的图像显示启动屏幕
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

有关详细信息, 请参阅 http://www.oracle.com/technetwork/java/javase/documentation/index.html。

一、JVM标准参数(-)

获取方法: java -help

JVM的标准参数都是以”-“开头，通过输入”java -help”或者”java -?”，可以查看JVM标准参数列表。如

-client			 设置jvm使用client模式，特点是启动速度比较快，但运行时性能和内存管理效率不高，通常用于客户端应用程序或者PC应用开发和调试。
-server			 设置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相同；
-classpath classpath
-cp classpath
告知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=”space string”。
该参数通常用于设置系统级全局变量值，如配置文件路径，以便该属性在程序中任何地方都可访问。

-enableassertions[:”…” | : ]
-disableassertions[:”…” | :

-ea[:”…” | : ]
上述参数就用来设置jvm是否启动断言机制（从JDK 1.4开始支持），缺省时jvm关闭断言机制。
用-ea 可打开断言机制，不加和classname时运行所有包和类中的断言，如果希望只运行某些包或类中的断言，可将包名或类名加到-ea之后。例如要启动包com.wombat.fruitbat中的断言，可用命令java -ea:com.wombat.fruitbat…。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

二、JVM非标准参数(-X)

非标准的可选项都以-X开始，其中的部分选项如下:

获取方法: java -X

非标准参数又称为扩展参数，其列表如下：

-Xint								设置jvm以解释模式运行，所有的字节码将被直接执行，而不会编译成本地码。
-Xbatch								关闭后台代码编译，强制在前台编译，编译完成之后才能进行代码执行；默认情况下，jvm在后台进行编译，若没有编译完成，则前台运行代码时以解释模式运行。
-Xbootclasspath:bootclasspath		让jvm从指定路径（可以是分号分隔的目录、jar、或者zip）中加载bootclass，用来替换jdk的rt.jar；若非必要，一般不会用到；
-Xbootclasspath/a:path				将指定路径的所有文件追加到默认bootstrap路径中；
-Xbootclasspath/p:path				让jvm优先于bootstrap默认路径加载指定路径的所有文件；
-Xcheck:jni							对JNI函数进行附加check；此时jvm将校验传递给JNI函数参数的合法性，在本地代码中遇到非法数据时，jmv将报一个致命错误而终止；使用该参数后将造成性能下降，请慎用。
-Xfuture				让jvm对类文件执行严格的格式检查（默认jvm不进行严格格式检查），以符合类文件格式规范，推荐开发人员使用该参数。
-Xnoclassgc				关闭针对class的gc功能；因为其阻止内存回收，所以可能会导致OutOfMemoryError错误，慎用；
-Xincgc	   				开启增量gc（默认为关闭）；这有助于减少长时间GC时应用程序出现的停顿；但由于可能和应用程序并发执行，所以会降低CPU对应用的处理能力。
-Xloggc:file			与-verbose:gc功能类似，只是将每次GC事件的相关情况记录到一个文件中，文件的位置最好在本地，以避免网络的潜在问题。若与verbose命令同时出现在命令行中，则以-Xloggc为准。

-Xms					指定jvm堆的初始大小，默认为物理内存的1/64，最小为1M；可以指定单位，比如k、m，若不指定，则默认为字节。
-Xmx				    指定jvm堆的最大值，默认为物理内存的1/4或者1G，最小为2M；单位与-Xms一致。
-Xss				    设置单个线程栈的大小，一般默认为512k。
-Xprof					输出 cpu 配置文件数据
-Xrs					减少jvm对操作系统信号（signals）的使用，该参数从1.3.1开始有效；
从jdk1.3.0开始，jvm允许程序在关闭之前还可以执行一些代码（比如关闭数据库的连接池），即使jvm被突然终止；
jvm关闭工具通过监控控制台的相关事件而满足以上的功能；更确切的说，通知在关闭工具执行之前，先注册控制台的控制handler，然后对CTRL_C_EVENT, CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT, and CTRL_SHUTDOWN_EVENT这几类事件直接返回true。
但如果jvm以服务的形式在后台运行（比如servlet引擎），他能接收CTRL_LOGOFF_EVENT事件，但此时并不需要初始化关闭程序；为了避免类似冲突的再次出现，从jdk1.3.1开始提供-Xrs参数；当此参数被设置之后，jvm将不接收控制台的控制handler，也就是说他不监控和处理CTRL_C_EVENT, CTRL_CLOSE_EVENT, CTRL_LOGOFF_EVENT, or CTRL_SHUTDOWN_EVENT事件。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

上面这些参数中，比如-Xmsn、-Xmxn……都是我们性能优化中很重要的参数；
-Xprof、-Xloggc:file等都是在没有专业跟踪工具情况下排错的好手；

三、不稳定(Unstable)的选项

不稳定的选项当然是非标准的，都以-XX开头。这一类参数有很多，暂时只列其中的几个:

-XX:PermSize<=size>和-XX:MaxPermSize<=size>
设置Java永久保存区域(Permanent Generation Space)的大小。PermSize设置初始值，MaxPermSize设置最大值。 该区域主要存储class的信息，且不会被 垃圾回收器回收，如果加载的class过多，就会报错:java.lang.OutOfMemoryError: PermGen space。 -XX:PermSize=64m -XX:MaxPermSize=128m，表示Java永久保存区域大小初始化问为64兆，最大为128兆。

-XX:+UseParallelGC
开启并行Java回收器

-XX:+PrintGCDetails
显示比-verbose:gc更多更准确的垃圾回收信息

-XX:+TraceClassLoading
显示类加载以及卸载的信息
1
2
3
4
5
6
7
8
9
10
11

程序参数 (arguments)

class或者jar文件之后的字符串会传给main函数的String[] args参数，多个参数用空格隔开。如果某一个参数包含多个单词，那么需要用引号包起来。当有很多程序参数，且有的必填，有的可选的时候，如果不设计好，顺序是很头疼的问题。一种解法是传键值对 (key=value) ，完全不用在意参数的顺序。在main函数里面把键值对解析成Map，然后再校验以及使用。简单的示例代码如下:

public static void main(String[] args) {
		Map<String, String> arguments = getArguments(args);
		for (String key : arguments.keySet()) {
			System.out.println(key + "=" + arguments.get(key));
		}
	}
 
	public static Map<String, String> getArguments(String[] args) {
		Map<String, String> arguments = new HashMap<String, String>();
 
		if (args == null || args.length == 0) {
			return arguments;
		}
 
		for (String arg : args) {
			int index = arg.indexOf("=");
			// 没有=，或者=是第一个，都出错。
			if (index < 1) {
				throw new RuntimeException("param must be key value pair");
			}
 
			String key = arg.substring(0, index);
			String value = arg.substring(index + 1);
			arguments.put(key, value);
		}
 
		return arguments;
	}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

Don’t be blinded by the present and stop, come on!