JAVA啟動參數大全之一：標準參數

前段時間系統升級時遭遇了OOM，具體解決過程見 遭遇OutOfMemoryError；
為了鞏固對於java啟動各項參數的認識，決定將所有參數列舉出來，並一一解釋，以便後查；

java啟動參數共分為三類；
其一是標準參數（-），所有的JVM實現都必須實現這些參數的功能，而且向後相容；
其二是非標準參數（-X），預設jvm實現這些參數的功能，但是並不保證所有jvm實現都滿足，且不保證向後相容；
其三是非Stable參數（-XX），此類參數各個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相同；更多的資訊待續，在後續的JVMTI部分會詳述。

-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[:<package name>"..." | :<class name> ]
-ea[:<package name>"..." | :<class name> ]
 上述參數就用來設定jvm是否啟動斷言機制（從JDK 1.4開始支援），預設時jvm關閉斷言機制。
 用-ea 可開啟斷言機制，不加<packagename>和classname時運行所有包和類中的斷言，如果希望只運行某些包或類中的斷言，可將包名或類名加到-ea之後。例如要啟動包com.wombat.fruitbat中的斷言，可用命令java -ea:com.wombat.fruitbat...<Main Class>。

-disableassertions[:<package name>"..." | :<class ; ]
-da[:<package name>"..." | :<class name> ]
 用來設定jvm關閉斷言處理，packagename和classname的使用方法和-ea相同，jvm預設就是關閉狀態。
 該參數一般用於相同package內某些class不需要斷言的情境，比如com.wombat.fruitbat需要斷言，但是com.wombat.fruitbat.Brickbat該類不需要，則可以如下運行：
 java -ea:com.wombat.fruitbat...-da:com.wombat.fruitbat.Brickbat <Main Class>。
 
-enablesystemassertions
-esa
 啟用系統類別的斷言。
 
-disablesystemassertions
-dsa
 關閉系統類別的斷言。

-jar
 指定以jar包的形式執行一個應用程式。
 要這樣執行一個應用程式，必須讓jar包的manifest檔案中聲明初始載入的Main-class，當然那Main-class必須有public static void main(String[] args)方法。

-javaagent:jarpath[=options]
 指定jvm啟動時裝入java語言裝置代理程式。
 Jarpath檔案中的mainfest檔案必須有Agent-Class屬性。代理類也必須實現公用的靜態public static void premain(String agentArgs, Instrumentation inst)方法（和main方法類似）。當jvm初始化時，將按代理類的說明順序調用premain方法；具體參見java.lang.instrument軟體包的描述。

-verbose
-verbose:class
 輸出jvm載入類的相關資訊，當jvm報告說找不到類或者類衝突時可此進行診斷。
-verbose:gc
 輸出每次GC的相關情況。
-verbose:jni
 輸出native方法調用的相關情況，一般用於診斷jni調用錯誤資訊。
 
-version
 輸出java的版本資訊，比如jdk版本、vendor、model。
-version:release
 指定class或者jar運行時需要的jdk版本資訊；若指定版本未找到，則以能找到的系統預設jdk版本執行；一般情況下，對於jar檔案，可以在manifest檔案中指定需要的版本資訊，而不是在命令列。
 release中可以指定單個版本，也可以指定一個列表，中間用空格隔開，且支援複雜組合，比如：
 -version:"1.5.0_04 1.5*&1.5.1_02+"
 指定class或者jar需要jdk版本為1.5.0_04或者是1.5系列中比1.5.1_02更高的所有版本。

-showversion
 輸出java版本資訊（與-version相同）之後，繼續輸出java的標準參數列表及其描述。
 
-?
-help
 輸出java標準參數列表及其描述。

-X
 輸出非標準的參數列表及其描述。

以上的這些參數我們經常會在很多情況下用到多個的組合，比如我們在用JProfiler進行跟蹤監控時，需要在被監控java啟動參數中加上如下配置：
-agentlib:jprofilerti=port=8849  -Xbootclasspath/a:/usr/local/jprofiler5/bin/agent.jar
其中就用到兩個-agentlib和-X參數，bootclasspath參數的詳細資料將會在非標準參數中詳細說明。