設定 Java 建置路徑

本章節說明如何設定 Java 建置路徑,亦即, 在建置 Java 專案時所用的類別路徑。 類別路徑是一個類別路徑項目的陣列, 用以說明可採原始檔或二進位形式(用以尋找可用的類型)的類型。 這些項目的排列順序將決定可用類型的優先順序。

Java 建置路徑也可用來管理 Java 專案元素的結構, 這是因為所有套件片段 root 皆直接衍生自 Java 建置路徑(每一個項目分別對映至一或多個套件片段 root, 請參閱 getPackageFragmentRoots)。

本章節未涵蓋可個別定義的 Java 執行時期路徑,有關如何執行 Java 程式的說明, 請參閱相關章節。

變更建置路徑

您可以透過程式設計方式, 將 setRawClasspath 用於對應專案的 Java 元素上,以變更專案的建置路徑;例如:

	IProject project = ... // 取得部份專案資源
	IJavaProject javaProject = JavaCore.create(project);
	IClasspathEntry[] newClasspath = ...;
	javaProject.setRawClasspath(newClasspath, someProgressMonitor);
	
請注意,setRawClasspath 亦存在一個變式,而可同時定義 Java 建置路徑與專案的輸出位置

Java 建置路徑會保存在專案位置下的一個 '.classpath' 檔中。此檔案的用途在於可藉以透過某些原始碼儲存庫, 讓其他人可共用 Java 建置路徑的設定值。 尤其是此檔案不應以手動方式編輯以免毀損。

類別路徑項目

您可使用 JavaCore 中所定義的 Factory 方法來定義類別路徑項目,以便參照下列任何項:

類別路徑的解析

由於存在動態連結項目(類別路徑變數與儲存器), JDT Core 會在原始類別路徑與已解析類別路徑的表示法間做一區分。原始類別路徑是指使用 setRawClasspath 原設定在 Java 專案中的類別路徑, 並且可藉由向專案要求 getRawClasspath, 而進行進一步查詢。

您也可以使用 getResolvedClasspath, 查詢專案之已解析的類別路徑。 必要時,此作業會觸發所呼叫之變數與(或)儲存器的起始設定。請注意, 有些 Java 模型作業會隱含造成要解析 Java 建置路徑, 例如,當計算專案套件片段 root 時,需要解析建置路徑。

 Copyright IBM Corporation and others 2000, 2002. All Rights Reserved.