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 设定系统属性值,比如编码-Dencoding=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<size> 设置Java堆的初始化大小。例如 -Xms1024m,Java堆的初始化大小就设置为1G。
- -Xmx<size> 设置Java堆的最大值。例如 -Xmx3072m,Java堆的最大值就设置为3G。
- -Xss<size> 设置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