使用 NetBeans 開發與建構 GlassFish 專案完整指南

前言

Project GlassFish 是 Sun 在 Java.net 的開源應用伺服器專案，已配置為與 NetBeans 協同工作。其 30 個模組均為 NetBeans 專案。本文示範如何設定環境以使用 NetBeans 編輯、建構、執行 GlassFish，以及如何修改專案設定與新增模組。

適用版本：NetBeans 5.0 (NetBeans 4.1 請參考舊版說明)

環境建置

1. 安裝 NetBeans 5.0

2. 安裝 Maven 1.0.2

驗證：命令列執行 maven -v

3. 取得 GlassFish 原始碼

mkdir workspace
cd workspace
cvs -d :pserver:<java.net userid>@cvs.dev.java.net:/cvs login
cvs -d :pserver:<java.net userid>@cvs.dev.java.net:/cvs checkout glassfish/bootstrap

設定專案屬性

cd glassfish/bootstrap
# 編輯 project.properties
glassfish.os.name=[WINNT, Linux, SunOS, SunOS_X86]
glassfish.cvs.username=<your java.net userid>

取得、配置與測試 GlassFish 映像

下載完整 GlassFish (超過 60MB) 至 Maven 儲存庫，解壓至 glassfish.home：

maven bootstrap
maven configure-runtime
cd ..\..\publish\glassfish\bin
asadmin list-domains

在 NetBeans 中簽出、開啟與修改模組

以 admin-cli 模組為例：

cd workspace/glassfish/bootstrap
maven checkout -Dmodules=admin-cli,appserv-docs
cd ../appserv-docs
maven build

注意：admin-cli 依賴 appserv-docs，故須先建置後者。

在 NetBeans 開啟專案

檔案 > 開啟專案 (Ctrl+Shift+O)，選擇 /workspace/glassfish/admin-cli。資料夾圖示帶有 NetBeans 標記表示已識別為專案。

修改原始碼

1. 展開 commands/src/java 來源根目錄與 com.sun.enterprise.cli.commands 套件
2. 專案頁籤按 Ctrl+7 啟用快速搜尋，輸入 S1AS 開啟檔案
3. 按 Ctrl+7 輸入 val 跳轉至驗證方法
4. 在方法頂端輸入 sout + 空格展開 System.out.println("");，加入歡迎訊息

System.out.println("Welcome to Project GlassFish!");

建構與測試修改

• 按 F11 執行模組建構腳本，更新 glassfish.home 中的 JAR
• cd /workspace/publish/glassfish/bin 執行 asadmin list-domains 驗證

GlassFish NetBeans 專案架構說明

約 30 個模組，皆為自由形式專案類型。NetBeans 產生 nbproject/project.xml 輔助檔：

• 對應既有 Ant 目標至 IDE 指令
• 回報專案原始碼目錄
• 回報編譯器類路徑

Ant 目標對應 IDE 指令

專案屬性 建構與執行 中可見 建構 與 清除 已對應。

配置原始碼目錄

邏輯專案視圖顯示各模組來源目錄，如 Admin CLI 有 3 個來源根。

在專案屬性 Java 來源 中配置。

配置編譯器類路徑

NetBeans 編輯器無法從 Ant 腳本自動推導類路徑。GlassFish 使用解壓後的 glassfish.home 函式庫，路徑定義於 glassfish/project.properties。

手動編輯 project.xml 參考該屬性檔（避免絕對路徑）：

1. 匯入 glassfish/project.properties
2. 各來源根個別配置類路徑，如 cli-api/src/java 無相依；commands/src/java 相依 admin-cli.jar、appserv-admin.jar、appserv-rt.jar

若編輯器出現編譯錯誤，即為缺少 JAR，需補齊類路徑。

NetBeans 對 Maven 的支援現狀

NetBeans 有 Maven 外掛，但 GlassFish 專案尚未配置 Maven 預期的專案相依關係。目前 Maven 僅作為現有 Ant 的包裝器。未來 GlassFish 團隊將提供更完整的 Maven 支援。