设置 Java 构建路径

本节描述如何设置 Java 构建路径(即,用于构建 Java 项目的类路径)。类路径是用于说明源代码或二进制格式的可用类型的类路径条目的数组,可使用它来查找可用类型。这些条目的排序定义了可用类型的优先权。

因为所有包片段根是直接从 Java 构建路径派生的(每个条目映射至一个或多个包片段根,参见 getPackageFragmentRoots),所以 Java 构建路径还会控制 Java 项目元素的结构。

本节未涉及 Java 运行时路径(它可以单独定义),参见讲述如何运行 Java 程序的相关章节。

更改构建路径

可以通过对相应项目的 Java 元素使用 setRawClasspath 来使用程序更改项目的构建路径,例如:

	IProject project = ... // get some project resource
	IJavaProject javaProject = JavaCore.create(project);
	IClasspathEntry[] newClasspath = ...;
	javaProject.setRawClasspath(newClasspath, someProgressMonitor);
	
注意,还存在 setRawClasspath 的变体,它允许同时定义 Java 构建路径和项目输出位置

Java 构建路径保存在项目位置下面的名为“.classpath”的文件中。此文件可用来提供一种方法来通过某些源代码资源库与其它项目共享 Java 构建路径设置。需要特别指出的是,由于此文件可能会毁坏,所以不应该手工编辑它。

类路径条目

可以使用在 JavaCore 上定义的 factory 方法来定义类路径条目,以便引用下列任何内容:

类路径解析

由于存在动态绑定的条目(类路径变量和容器),因此“JDT 核心”可区分原始类路径与已解析类路径的概念。原始类路径是最初使用 setRawClasspath 在 Java 项目上设置的类路径,且可以通过向项目请求 getRawClasspath 来进一步查询它。

还可以使用 getResolvedClasspath 来查询项目的已解析路径。如果需要,此操作将触发涉及到的变量和/或容器的初始化。注意,许多“Java 模型”操作会隐式地导致解析 Java 构建路径(例如,计算项目包片段根需要解析构建路径)。

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