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

  • disablesystemassertionsdsa
    禁用系统类(syetem class)断言

  • enablesystemassertionsesa
    启用系统类(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

你可能感兴趣的:(java,参数,命令行)