使用 NetBeans 开发和构建项目 GlassFish

NetBeans

下载并安装 NetBeans 5.0

Maven

下载并安装 Maven 1.0.2。请验证是否通过在命令提示符运行“maven -v”来安装。

创建 Workspace Home

1. 创建“workspace”目录。
2. cd workspace

获取源

1. 登录 CVS：
   cvs -d :pserver:<java.net userid>@cvs.dev.java.net:/cvs login
2. 签出 glassfish 模块：
   cvs -d :pserver:<java.net userid>@cvs.dev.java.net:/cvs checkout glassfish/bootstrap

设置项目属性

1. CD 到 glassfish/bootstrap
2. 在 project.properties 中设置以下属性：
   
   • glassfish.os.name=[WINNT, Linux, SunOS, SunOS_X86]
   • glassfish.cvs.username=<your java.net userid>

获取、配置和测试 GlassFish 图像

这里将下载并安装完整的 GlassFish 工作版本。GlassFish 图像将下载到 Maven 存储库中，然后从存储库解压缩到 glassfish.home，如在 glassfish/project.properties 文件中所配置的。构建对其他模块有依赖性的模块时，递增构建将使用 glassfish.home 的库来解决那些类路径依存关系。

1. 仍在 boostrap 目录中，运行“maven bootstrap”。请注意，GlassFish 图像超过 60 MB，因此该步需要几分钟的时间。
   
   
   
   
2. 运行“maven configure-runtime”
   
   
   
   
3. 将目录更改为 ..\..\publish\glassfish\bin 并运行“asadmin list-domains”。
   
   

对于本练习，我们将对 admin-cli 项目进行修改。

获得 admin-cli 源

1. cd 到 workspace/glassfish/bootstrap
2. 签出 admin-cli 模块：
   
   maven checkout -Dmodules=admin-cli,appserv-docs
   
   
3. cd ../appserv-docs
4. 运行“maven build”
   请注意，因为 admin-cli 模块取决于 appserv-docs，所以需要步骤 3 和 4。

在 NetBeans 中打开 Admin Cli 项目

1. 启动 NetBeans，然后选择 File > Open Project (Ctrl+Shift+0)。
2. 浏览到 /workspace/glassfish/admin-cli。请注意，文件夹图标上的 NetBeans 标记，表明 NetBeans 将其识别为一个项目。
   
   

修改 GlassFish 源

1. 展开 commands/src/java 源根和 com.sun.enterprise.cli.commands 包。
2. 焦点仍在 Projets 选项卡中，键入“S1AS”并按 Enter。这将打开 Quick Search，跳转到文件并打开文件。
   
   
   
   
3. 按 Ctrl+7，然后键入“val”并按 Enter。这将跳转到验证的选项方法。
4. 在方法的顶部进行添加，键入“sout”并按空格。将展开到 system.out.println("");。在引号之间键入“Welcome to GlassFish!”。
   
   System.out.println("Welcome to Project GlassFish!");
   

构建和测试所作的更改

1. 按 F11 启动模块的构建脚本。该构建脚本将更新 glassfish.home 中的 jar。
2. 将目录更改为 /workspace/publish/glassfish/bin 并运行“asadmin list-domains”。

大约有 30 个模块构成项目 GlassFish，每个模块作为自由形式项目类型的 NetBeans 项目进行设置。因为自由形式项目类型是为具有现有 Ant 脚本的项目设计的，所以 NetBeans 将创建名为 project.xml 的辅助文件，用于：

• 将现有 Ant 目标映射到 IDE 特定命令
• 向 NetBeans 报告项目的源目录
• 向 NetBeans 编辑器报告项目的类路径。

将在名为 nbproject 的子目录中找到 project.xml 文件。

将 Ant 目标映射到 IDE 命令

如果查看任一 GlassFish 模块项目的 Build and Run 属性，则会发现已映射了 Build and Clean 项目菜单条目。

有关该项目类型的详细信息，请参阅高级自由形式项目配。

配置项目的源目录

NetBeans 的逻辑 Projects 视图显示了 GlassFish 模块的各种源目录。在下面的示例中，Admin CLI 项目有 3 个已配置的源目录。

这些目录是在项目的 Java Sources 属性中进行配置的。

配置编译器的类路径

NetBeans 编辑器没有将类路径信息从 Ant 构建脚本中拉出。虽然将构建模块，但是在编辑器中看起来并不漂亮。例如，这里在配置类路径之前是 S1ASCommand.java。

GlassFish 构建脚本为其类路径使用解压缩的 GlassFish 图像的库。这些库的位置是在 glassfish 模块的 project.properties 文件中进行配置的（当获取源后，我们签出了上述 glassfish 模块）。

类似构建目标和源路经配置，也可以通过项目的属性编辑器实现上述操作。但是，使用属性编辑器将设置所需库的绝对路径，因此我们手动编辑了 project.xml 文件，这样当配置编辑器类路径时，我们可以参考 glassfish/project.properties。

首先，我们将 glassfish/project.properties 导入 project.xml 文件。

然后，参考映射到 jar 文件的 glassfish/project.properties。请注意，每个源根有其自己的类路径。因此在下列示例中，cli-api/src/java 中的源没有其他依存关系。但是，commands/src/java 中的源依赖于 admin-cli.jar、appserv-admin.jar 和 appserv-rt.jar 中的类。

在任一 GlassFish 模块中，如果未解决 NetBeans 编辑器中的编译错误，则向类路径中添加丢失的 jar 文件就是个问题。

注意从 NetBeans Project Property 编辑器进行查看时要适当解决的属性。

有关该项目类型的详细信息，请参阅高级自由形式项目配。

NetBeans 对 Maven 的支持

NetBeans 的确具有一个 Maven 的插件。但是，GlassFish Project 尚未设置 Maven 所期望的项目依存关系。在这个阶段，Maven 事实上被用作基于基础架构的 GlassFish 项目的现有 Ant 的包装。在未来的阶段，GlassFish 团队要提供更完全的 Maven 支持。