Java启动命令和可选项

背景

Java启动命令是所有java应用程序的入口，通过它来启动Java运行时环境，并加载相关的class。不过由于IDE的盛行，我们Java程序员中的大多数并不是非常的了解Java启动命令。本文希望做一个Java启动命令的汇总，和各位同道分享，也便于日后作为自己的参考。

Java启动命令语法

Java启动命令有两个，java以及javaw，它们的唯一区别是javaw不会启动一个控制台窗口(启动失败的时候会弹出附有错误信息的窗口)，而java会。不希望有控制台的时候用javaw，其它时候用java。它们的语法结构都一样，只需要记住其中一个即可。调用程序有两种方式，指定Class以及指定jar文件，具体的语法如下：

• java [options] class [arguments]
• java [options] -jar file.jar [arguments]
• javaw [options] class [arguments]
• javaw [options] -jar file.jar [arguments]

其中[options]表示Java运行环境的可选配置信息，会影响java运行环境，是性能调优的关键所在，可以传多个可选项。class表示的是包含main函数的class名称(含包名)。-jar和file.jar配对使用，-jar表示用jar方式启动，而file.jar表示的是jar文件的名称，替换为自己的jar文件名字即可。[arguments]表示的是程序自身的参数，会被传到main函数的参数数组里面，为程序自己所使用。

Java启动命令可选项(options)

Java启动命令可选项(options)大致可分为标准和非标准两种，非标准的可选项不保证在所有平台上都实现，并且未来的版本中可能会被修改且不告知，总之就是不稳定(Unstable)。不过有的非标准可选项还是非常有用的，后面我们会谈到。

标准可选项(Standard options)

• -client 与 -server
  以clien或者server模式启动，二选一，Java运行时环境会依场景来优化自己的配置策略。值得指出的是64位的Java不支持client模式，默认就是server。不同平台的默认配置可以参考Server-Class Machine Detection

• -cp 和 -classpath
  最重要的可选项之一，指定Java运行时环境搜索class的路径。-cp只是-classpath的简写，做相同的事情，用其中之一即可。多个路径用英文里面的分号分隔。如果-cp和-classpath都没有使用，CLASSPATH环境变量也没用设定，那么就是当前路径(.)。

• -Dproperty=value
  设定系统属性值，比如编码-Dfile.encoding=UTF-8。可以设定一些系统使用的属性，也可以用来向程序传递值，比如程序的根目录。 可以通过System.getProperty("keyname")来获取属性。

• -help与-?
  都是要求显示帮助信息

• disableassertions[:packagename…|:classname]与da[:packagename…|:classname]
  禁用断言，可以指定包名(注意包后面的三个点)或者class的名称。默认就是禁用的。da只是disableassertions的缩写，使用方法完全一样。 禁用包: da:org.slf4j...
  禁用类: da:org.slf4j.LoggerFactory

• enableassertions[:packagename…|:classname]与ea[:packagename…|:classname]
  启用断言，可以指定包名(注意包后面的三个点)或者class的名称。ea只是enableassertions的缩写，使用方法完全一样。 启用包: ea:org.slf4j...
  启用类: ea:org.slf4j.LoggerFactory

• disablesystemassertions与dsa
  禁用系统类(syetem class)断言

• enablesystemassertions与esa
  启用系统类(syetem class)断言

• -version 与 -showversion
  这两个都显示Java的版本信息，不过后者会把help的信息也显示出来。

• verbose:class, verbose:gc, “verbose:jni”
  verbose:class显示class加载信息，verbose:gc显示Java垃圾回收的信息。verbose:jni显示JNI(Java Native Interface)信息。

• -agentlib:agentlibname[=options]与-agentpath:pathtoagent[=options]
  都是加载本地代理库(Native Agent Library)，-agentlib只需要library的名称，且会根据不同的操作系统转为对应的文件(Windows为DLL)。 -agentpath指定library的绝对路径。

非标准可选项(Nonstandard Options)

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

• -X
  显示所有非标准选项的信息。看看都有些什么非标准选项吧。java -X。

• -Xms
  设置Java堆的初始化大小。例如 -Xms1024m，Java堆的初始化大小就设置为1G。

• -Xmx
  设置Java堆的最大值。例如 -Xmx3072m，Java堆的最大值就设置为3G。

• -Xss
  设置Java线程栈的值。例如 -Xss128m，Java线程栈的值就设置为128兆。

• -Xnoclassgc
  禁用Java垃圾回收器。

• -Xincgc
  启用Java增量式垃圾回收器。

• -Xmixed
  解释模式和编译模式混合执行

• -Xint
  仅解释模式执行

• -Xshare:on，-Xshare:off，-Xshare:auto 设定类数据共享CDS(Class data sharing)是否开启。-Xshare:on要求一定要用共享的类数据；-Xshare:auto表示让系统自己判断 是否有类共享数据，有就用，没有不用；-Xshare:off禁用共享类数据。

• -Xcheck:jni
  针对JNI函数做额外的检查

不稳定(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
  显示类加载以及卸载的信息

程序参数(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;
	}

参考

• Launches Java application
• Server-Class Machine Detection
• IBM User Guide for Java