1. 程式人生 > >AVA啟動引數大全之一:標準引數

AVA啟動引數大全之一:標準引數

前段時間系統升級時遭遇了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引數的詳細資訊將會在非標準引數中詳細說明。

--------------------- 本文來自 sfdev 的CSDN 部落格 ,全文地址請點選:https://blog.csdn.net/sfdev/article/details/2062042?utm_source=copy