“Java 构建路径”页面

此页面中的选项指示 Java 项目的构建路径设置。可以通过“新建 Java 项目”向导来访问此页面。

构建类路径是在构建项目时对于编译器可视的路径列表。

源选项卡

源文件夹是包含 .java 文件的包的根。编译器会将包含的文件转换为 .class 文件,而这些 .class 文件将写至输出文件夹。除非源文件夹指定自已的输出文件夹,否则每个项目都定义输出文件夹。每个源文件夹都可以定义排除过滤器以指定文件夹中的哪些资源对于编译器应该不可视。
除非编译器首选项页面(窗口 > 首选项 > Java > 编译器 > 构建)中的设置指定对存在于源文件夹中的资源进行过滤,否则也将这些资源复制至输出文件夹。

此树将项目显示为当切换至包资源管理器时的样子。可以对此树执行几个操作来更改项目的结构。

图标 选项 描述
添加至构建路径 添加至构建路径 允许将文件夹或包添加至 Java 构建路径并将它更改为源文件夹。源文件夹是项目层次结构中用作包的根的顶层文件夹。构建路径上的条目(如源文件夹)对于编译器和所有包含的资源(如用来构建该项目的 .java 文件)是可视的。源文件夹允许构造项目,例如,在两个源文件夹中将测试与应用程序隔开。在源文件夹内,可以通过使用包来完成更详细的构造。
从构建路径中除去 从构建路径中除去 允许将源文件夹从 Java 构建路径中除去并将它更改为正常文件夹。此文件夹中所有 包含的资源(如 .java 文件)对于编译器不再是可视的,当构建项目时将不会包括这些资源。
排除 排除 允许将资源添加至该资源的父源文件夹的排除过滤器。结果是此资源的所有子代对于编译器都不再是可视的。例如,如果项目中不再需要某些包并因此可以从编译器中隐藏这些包,则此操作很有用。
包括 包括 可以对已经排除的文件或文件夹执行此操作。在这种情况下,包括允许再次使此资源对编译器是可视的。
配置源文件夹属性 配置源文件夹属性 可以在两种情况下使用编辑:

  1. 通过定义字符串模式来定制包括和排除过滤器。如果包括或排除每一个资源将花费太长时间且只能使用某些简单的模式来完成作业,则此操作很有用。一个非常实用的运算符是定义更复杂模式(例如,排除以“Test*.java”开头的所有资源)的通配符运算符。
  2. 更改源文件夹的输出文件夹。结果是将在单独的输出文件夹而不是在项目的输出文件夹中生成所有从此源文件夹中的 .java 文件生成的 .class 文件。
注意,此高级操作只能对单个的所选对象执行。

撤销所有更改 撤销所有更改 本向导中已应用到项目中的所有更改都将被取消,将重新构造项目的原始状态。
将其它源链接至项目 将其它源链接至项目 当创建项目时,在文件系统的某个位置可能已经存在也可以用于此新项目的某些代码段或其它资源。要将此源代码添加至项目,可以在文件系统中创建一个链接至该文件夹的源文件夹,并使其内容对于编译器是可视的。注意,将仅创建该文件夹的链接。这意味着对该文件夹中资源的任何修改也会对使用此资源的其它项目有影响。
无图标 允许将输出文件夹用作源文件夹 显示/隐藏源文件夹的“输出文件夹”属性。如果未显示输出文件夹,则这意味着项目的缺省输出文件夹用于生成的 .class 文件。

注意,所有操作的简短描述在项目树底部是可视的(用“描述”进行了标记)。将仅显示对项目上的当前选择有效的描述。有经验的用户也可以关闭描述区以查看放大的项目结构。

项目选项卡

构建路径上的必需项目列表中,可以通过选择要添加至此新项目构建路径的其它工作台项目来添加项目依赖性。可以使用全部选中全部不选按钮来将所有其它项目添加至构建路径或者从构建路径中除去所有其它项目。

添加必需的项目会间接地添加其所有标记为“已导出”的类路径条目。将类路径条目设置为“已导出”是在“排序和导出”选项卡中完成的。

在此处选择的项目会自动添加到引用的项目列表中。引用的项目列表用来确定构建顺序。项目总是在构建了它的所有引用的项目之后才构建的。

库选项卡

在此页上,可以将库添加到构建路径中。可以添加:

JAR 文件还可以间接作为类路径变量添加。

缺省情况下,库列表包含表示 Java 运行时库的条目。此条目指向选择作为缺省 JRE 的 JRE。缺省 JRE 是在已安装的 JRE 首选项页面(窗口 > 首选项 > Java > 已安装的 JRE)中配置的

库选项卡选项
选项 描述
添加 JAR 允许您浏览工作台层次结构并选择要添加至构建路径的 JAR 文件。
添加外部 JAR 允许您浏览文件系统(在工作台外部)并选择要添加至构建路径的 JAR 文件。
添加变量 允许您将类路径变量添加至构建路径。类路径变量间接指向 JAR,好处是避免了类路径中有本地文件系统路径。这在小组中共享项目时是必需的。
可以在类路径变量首选项页(窗口 > 首选项 > Java > 构建路径 > 类路径变量)中创建和编辑变量
添加库 允许添加预定义库,如 JRE 系统库。这样的库可以代表任意数目的条目(显示成库节点的子节点)
添加类文件夹 允许浏览工作台层次结构和选择构建路径的类文件夹。选择对话框还允许创建新文件夹。
编辑 允许修改当前选择的库条目或条目属性
除去 从构建路径除去所选的元素。这不会删除资源。

 库具有下列属性(显示成库条目子节点):

库条目属性
属性 描述
Javadoc 位置 指定可以在何处找到库的 Javadoc 文档。如果指定此项,则可以对这个库的元素使用 Shift+F2 来打开它的文档。
源代码连接 指定可以在何处找到库的源代码。

“排序和导出”选项卡

构建类路径顺序列表中,可以单击向上向下按钮来将所选路径条目在这个新项目的构建路径顺序中向上或向下移动。

选择的列表条目被标记为“已导出”。已导出的条目对于需要该项目的项目是可视的。使用全部选中全部不选来更改所有条目的选择状态。源文件夹总是处于“已导出”状态,不能取消对它的选择。

缺省输出文件夹

在此页面的底部,缺省输出文件夹字段允许输入指向此项目的编译输出将驻留的文件夹路径的路径。对于没有指定自已的输出文件夹的源文件夹,使用缺省输出。使用浏览来从当前项目中选择现有路径。

相关概念

构建类路径
类路径变量

相关任务

使用构建路径
将源代码附加至变量
将源连接至 JAR 文件

相关参考

有关 JDT 的常见问题
“类路径变量”首选项
Java 编译器属性