Java環境變量Classpath
Classpath是一個參數,它的值可以通過命令行指定,或者通過環境變量來指定。Classpath這個參數的值,被Java虛擬機或者Java編譯器所使用,它告訴Java虛擬機機,Java編譯器,去哪里尋找用戶定義的類和包。
Overview and architecture
與傳統的動態載入行為類似,當執行一個Java程序的時候,Java虛擬機會尋找和載入類(但是,只有當這個類被用到的時候,Java虛擬機才會載入它。Classpath這個值,告訴Java虛擬機或者編譯器,在文件系統中,哪些文件是定義了要用到的類的。
Java虛擬機按照下述流程來尋找和載入類:
-
系統導入類:這些類對Java平臺是起基礎性作用的,它們由以下類組成:Java類庫的公共類部分;為Java類庫服務的私有類。
-
擴展類:存在于JRE或者JDK擴展目錄下的包,如jre/lib/ext/。
-
用戶定義的包和類庫
在默認情況下,只有JDK的標準API包和擴展包,是不用額外設定變量的,Java虛擬機或者Java編譯器知道怎樣找到它們。所有用戶自定義的包或者類庫,它們的存放路徑,必須通過命令行來指定或者通過相關的Manifest文件來設定(每一個Manifest文件與一個Jar文件相關聯,Jar文件包含了用戶自定義的包或者類庫)。這樣,在指定了自定義的包或者類庫的存放路徑之后,Java虛擬機或者Java編譯器,就知道怎么去找到這些類或者包。
在執行Java程序的時候指定路徑
基本用法
假設,我們擁有一個叫做org.mypackage的包,它包含以下內容:
- HelloWorld (main class)
- SupportClass
- UtilClass
然后,定義這些類的文件,存放在以下位置:D:myprogram(在Window系統下);/home/user/myprogram(在Linux系統下)。
文件的路徑結構如下:
在這個例子中,當我們啟用Java這個工具(用于載入某個java程序到虛擬機中去執行)的時候,我們指定要運行的java程序為org.mypackage.HelloWorld。當然,我們還要告訴Java這個工具,它去什么地方找我們自己定義的要載入Java虛擬機運行的包和類。所以,要啟動運行這個程序,我們使用以下的命令:
Linux:
- java -classpath /home/user/myprogram org.mypackage.HelloWorld
- -classpath D:myprogram 這個參數,指定了程序中要用到的包所在的路徑。(在Linux系統中,是這樣表達, -classpath /home/user/myprogram)
- org.mypackage.HelloWorld 這是主類的名稱
添加一個目錄下的所有JAR文件
在Java 6和更高版本的Java中,我們可以將一個指定目錄下的所有JAR文件添加進來,設定一個包含通配符的路徑值,將該路徑值賦值給classpath.
Windows系統下運行的例子:
- java -classpath ".;c:mylib*" MyApp
在Linux系統下運行的例子:
- java -classpath '.:/mylib/*' MyApp
通過環境變量來設定路徑值
環境變量CLASSPATH,可以替代classpath的功能,用CLASSPATH來存放要載入的類的定義文件的路徑值。上面的例子,我們可以用下面的內容來代替(在Windows系統中):
有時候,您還要查一下JAVA_HOME的值,該值,表示正在使用的JDK的存放路徑。
- set CLASSPATH=D:myprogram
java org.mypackage.HelloWorld
設置Jar文件的存放路徑
現在,假設,我們要運行的程序,使用了一個輔助的類庫,該類庫包含在一個Jar文件中,該Jar文件存放在D:myprogramlib.
現在文件存放結構是:
基于上面的文件結構,那么,我們就要使用以下的命令:
在Manifest文件中設定路徑
假設我們的程序的源代碼包含在一個名為helloWorld.jar的jar文件中,并且該文件存放在D:myprogram目錄下。于是,我們擁有下面的文件系統結構:
helloWorld.jar文件中的Manifest文件,是這樣定義的:
- Main-Class: org.mypackage.HelloWorld
- Class-Path: lib/supportLib.jar
注意:manifest文件以換行符結束或者以return鍵結束。
然后,要注意在這個例子中,描述supportLib.jar的存放路徑,是相對路徑,是相對于helloWorld.jar文件的存放路徑,用的并不是絕對路徑(在命令行中,-classpath的值,就要用到絕對路徑)。只要上述二者的相對位置結構保持不變,那么,jar文件的實際存放位置和它需要的類庫的實際存放位置是不相關的。
要運行jar文件中的程序,我們可以使用下面的命令:
- java -jar D:myprogramhelloWorld.jar
不需要再在命令行中指定Classpath的值,因為,它的值已經在manifest文件中定義了。
注意:沒有必要在載入程序(java)處定義主類,因為在manifest文件中,必須要有具有以下形式的一行:
- Main-Class: classname
要獲取更多關于jar選項的信息,可以查看 JavaDoc.
在manifest文件中設定多個JAR文件的存放路徑,用空格將每個路徑區別開:
- Class-Path: lib/supportLib.jar lib/supportLib2.jar