1创建、导入和配置Java项目本指南将简要介绍NetBeansIDE中的一些用于设置和配置Java项目的主要功能。此外,还将提供有关如何对IDE生成的生成脚本进行定制配置的信息。要学完本教程,您需要具备以下软件和资源。目录项目基本概念o项目oAnt创建项目导入项目o导入Eclipse工作区o基于现有源代码设置Java项目o基于现有源代码设置JavaFX项目o基于现有源代码设置Web项目o自由格式项目配置类路径和其他项目设置o设置主项目o设置项目中的目标JDKo管理项目的类路径o管理项目之间的依赖关系o共享项目库o使JDK的Javadoc在IDE中可用o启用JavaWebStart生成应用程序o生成项目、包和文件o在保存时编译o修复编译错误o过滤输出文件运行应用程序o运行项目和文件o定制运行时选项o设置运行时类路径o设置主类和运行时参数o设置JVM参数定制生成脚本o编辑和运行Ant脚本o编写定制Ant任务2另请参见软件或资源要求的版本NetBeansIDE版本6.7、6.8或6.9JavaDevelopmentKit(JDK)版本6项目基本概念此部分将简要介绍一些有关IDE项目系统的背景信息。项目在IDE中,您始终在项目内工作。除了源文件以外,IDE项目还包含meta数据,这些数据说明类路径上所包含的内容以及如何生成和运行项目等。IDE将项目信息存储在一个项目文件夹中,该文件夹包括一个Ant生成脚本和一个属性文件(它们用于控制生成和运行设置),还包括一个project.xml文件(该文件用于将Ant目标映射到IDE命令)。注意:虽然缺省情况下IDE将源目录放置在项目文件夹内,但是源目录并非必须位于项目文件夹中。AntApacheAnt是基于Java的生成工具,用于使开发的生成环境和运行环境标准化和自动化。IDE的项目系统直接基于Ant。所有项目命令(如“清理并生成项目”和“调试”)均调用项目Ant脚本中的目标。因此,您可以在IDE外部生成和运行项目,这与在IDE内部生成和运行项目完全相同。无需了解Ant即可使用IDE。您可以在项目的“项目属性”对话框中设置所有基本的编译和运行时选项,IDE会自动更新项目的Ant脚本。如果您熟悉Ant,则可以定制标准项目的Ant脚本,或者为项目编写您自己的Ant脚本。创建项目创建新项目:选择“文件”“新建项目”(Ctrl-Shift-N)。在出现“新建项目”向导时,为项目选择合适的模板并完成向导中的其余步骤。在NetBeansIDE6.7以后的发行版中,项目模板图标可能会灰显,表示尚未激活该项目类型。继续创建项目,将在IDE中激活该功能。IDE包含以下用于创建Java桌面和Web应用程序的标准项目模板:Java应用程序。创建带有主类的框架JavaSE项目。有关使用此模板的简明教程,请参见开发和部署常规Java应用程序。Java桌面应用程序。基于Swing应用程序框架创建应用程序。对于基本桌面应用程序以及使用Bean绑定库和Java持久性API库的数据库应用程序,均提供了框架。有关使用此模板的示例,请参见生成Java桌面数据库应用程序。3Java类库。创建不带主类的框架Java类库。有关使用此模板的简明教程,请参见开发和部署常规Java应用程序。基于现有源代码的Java项目。基于您自己的Java源代码创建JavaSE项目。请参见下面的基于现有源代码设置Java项目部分。Web应用程序。创建框架Web应用程序,其中包括用于添加各种Web框架的选项。有关使用此模板的示例,请参见Web应用程序开发简介。基于现有源代码的Web应用程序。基于您自己的Web源代码和Java源代码创建Web项目。请参见下面的基于现有源代码设置Web项目部分。此外,IDE还包含用于创建EJB模块、企业应用程序和JavaME应用程序等的模板。Java和Web项目类别还具有自由格式项目模板。通过自由格式模板,可以将现有Ant脚本用于项目,但需要手动进行配置。请参见下面的自由格式项目部分。创建完项目后,该项目在IDE中打开,并在“项目”窗口中显示其逻辑结构,同时在“文件”窗口中显示其文件结构:“项目”窗口是项目源的主入口点。它将显示重要项目内容(如Java包和Web页)的逻辑视图。通过右键单击任意项目节点,可以访问一个包含各种命令的弹出式菜单,这些命令用于生成、运行和调试项目,以及打开“项目属性”对话框。通过选择“窗口”“项目”(Ctrl-1),可以打开“项目”窗口。“文件”窗口显示了基于目录的项目视图,其中包括“项目”窗口中未显示的文件和文件夹。在“文件”窗口中,可以打开并编辑项目配置文件,如项目的生成脚本和属性文件。此外,还可以查看生成输出,如编译的类、JAR文件、WAR文件和生成的Javadoc文档。通过选择“窗口”“文件”(Ctrl-2),可以打开“文件”窗口。注意:如果需要访问项目目录之外的文件和目录,则可以使用“收藏夹”窗口。通过选择“窗口”“收藏夹”(Ctrl-3),可以打开“收藏夹”窗口。要将某个文件夹或文件添加到“收藏夹”窗口,请在“收藏夹”窗口中单击鼠标右键,然后选择“添加到收藏夹”。导入项目此部分将介绍最初在IDE中导入项目时所执行的操作。导入Eclipse工作区对于Eclipse项目,可以使用“导入Eclipse项目”向导帮助您基于Eclipse工作区中的项目创建NetBeans项目,并导入项目类路径和其他设置。在使用“导入Eclipse项目”向导时,无需手动创建和配置NetBeans项目。通过选择“文件”“导入项目”“Eclipse项目”,可以打开该向导。有关该向导的工作方式以及如何同时处理Eclipse项目和NetBeans项目的信息,请参见将Eclipse项目导入NetBeansIDE。基于现有源代码设置Java项目4对于在NetBeans外部开发的其他Java项目,可以使用“新建项目”向导中的“现有源代码”模板创建NetBeans项目。在向导中,您可以标识源代码的位置并指定NetBeans项目meta数据的位置。然后,可以使用“项目属性”对话框配置项目。为现有Java应用程序设置NetBeans项目:选择“文件”“新建项目”(Ctrl-Shift-N)。选择Java“基于现有源代码的Java项目”。单击“下一步”。在向导的“名称和位置”页中,执行以下步骤:o键入项目名称。o(可选)更改项目文件夹的位置。o(可选)更改IDE使用的生成脚本的名称。如果已存在用于生成源代码的生成脚本build.xml,则可能需要执行此操作。o(可选)选中“使用专用文件夹存储库”复选框,并指定库文件夹的位置。有关此选项的详细信息,请参见共享项目库。o(可选)选中“设置为主项目”复选框。如果选中此选项,则可以对该项目应用“清理并生成主项目”(Shift-F11)等命令的快捷键。单击“下一步”以转至该向导的“现有源代码”页。在“源包文件夹”窗格中单击“添加文件夹”。然后,导航至源并选择源根目录。在添加包含源代码的文件夹时,添加的文件夹必须包含包树中的最高层文件夹。例如,对于com.mycompany.myapp.ui包,添加的文件夹应包含com文件夹。(可选)在“测试包文件夹”窗格中,单击“添加文件夹”以选择包含JUnit包文件夹的文件夹。(可选)在该向导的“包括和排除”页中,为应包括在项目中或应从项目中排除的任何文件输入文件名模式。缺省情况下,会包括源根目录中的所有文件。单击“完成”。将同时在“项目”窗口和“文件”窗口中显示该项目。基于现有源代码设置JavaFX项目可以基于在NetBeansIDE外部开发的现有JavaFX应用程序创建JavaFX项目。如果您安装了JavaFX插件,或者您使用的是IDE的JavaFX下载选项,则可以执行此操作。为现有JavaFX应用程序设置NetBeans项目:选择“文件”“新建项目”(Ctrl-Shift-N)。选择Java“JavaFXScript应用程序”,然后单击“下一步”。在向导的“名称和位置”页中,执行以下步骤:o键入项目名称。5o(可选)指定项目文件夹的位置。o选中“来自源”选项按钮。o单击“添加文件夹”,然后指定包含现有JavaFX应用程序源文件的文件夹。o(可选)选中“设置为主项目”复选框。如果选中此选项,则可以对该项目应用“清理并生成主项目”(Shift-F11)等命令的快捷键。单击“完成”。将同时在“项目”窗口和“文件”窗口中显示JavaFX项目。基于现有源代码设置Web项目对于在NetBeans外部开发的Web项目,可以使用“新建项目”向导中的“现有源代码”模板创建NetBeans项目。在向导中,您可以标识源代码的位置并指定NetBeans项目meta数据的位置。然后,可以使用“项目属性”对话框配置项目。注意:如果项目最初是在Eclipse中开发的,则可以使用“导入Eclipse项目”向导而不是“新建项目”向导,这样可以节省时间。使用“导入Eclipse项目”向导可以同时导入多个项目,包括这些项目的配置。请参见将Eclipse项目导入NetBeansIDE。为现有Web应用程序设置NetBeans项目:选择“文件”“新建项目”(Ctrl-Shift-N)。选择JavaWeb“基于现有源代码的Web应用程序”。单击“下一步”。在向导的“名称和位置”页中,执行以下步骤:o在“位置”字段中,输入包含Web应用程序的源根文件夹和Web页文件夹的文件夹。o键入项目名称。o(可选)更改项目文件夹的位置。(可选)选中“使用专用文件夹存储库”复选框,并指定库文件夹的位置。有关此选项的详细信息,请参见在NetBeansIDE中共享项目库。(可选)选中“设置为主项目”复选框。如果选中此选项,则可以对该项目应用“清理并生成主项目”(Shift-F11)等命令的快捷键。单击“下一步”以转至该向导的“服务器和设置”页。(可选)将项目添加到现有企业应用程序。选择要部署到的服务器。如果未显示所需的服务器,请单击“添加”以在IDE中注册该服务器。(可选)选中“使用专用库文件夹存储服务器JAR文件”复选框。仅当在该向导的上一页为库指定了专用文件夹时,此选项才可用。6将源代码级别设置为运行应用程序时要使用的Java版本。(可选)调整上下文路径。缺省情况下,上下文路径基于项目名称。单击“下一步”以转至该向导的“现有源代码和库”页。验证该页上的所有字段,如“Web页文件夹”和“源包文件夹”的值。单击“完成”。将同时在“项目”窗口和“文件”窗口中显示该项目。自由格式项目对于自由格式项目,也提供了项目模板。在自由格式项目中,IDE使用现有Ant脚本中的目标生成、运行、清理、测试和调试应用程序。如果Ant脚本不包含用于实现其中某些功能的目标,则将无法对该项目使用这些功能。要实现这些功能,您需要在Ant脚本或辅助Ant脚本中编写目标。通常情况下,最好使用标准的“基于现有源代码”项目模板导入项目。对于Eclipse项目,最好使用“导入项目”功能,通过该功能可以创建和配置标准项目。标准项目便于长期维护。但是,如果您具有一个基于Ant的现有项目,且该项目包含无法在标准项目中复制的复杂或特殊配置,则自由格式项目模板会非常有用。例如,如果要导入一个包含多个源根目录的项目,且每个源根目录都具有不同的类路径,同时您无法将这些源根目录拆分为不同的项目,则可能需要使用自由格式项目模板。本指南重点介绍标准项目。有关设置自由格式项目的详细信息,请参见自由格式项目的高级配置。配置类路径和其他项目设置此部分将介绍在设置项目时需要执行的一些最常见任务,如设置项目的目标JDK、设置类路径、创建项目之间的依赖关系以及在项目之间和用户之间共享库。设置主项目在开发由很多源文件夹组成的大型应用程序时,经常会将代码拆分为若干个单独的项目。通常,其中的一个项目会作为应用程序的入口点。为了让IDE知道哪个项目是应用程序