本文將展示如何結合使用NetBeans集成開發環境(IDE) 和JBoss應用服務器。
Getting Started with JBoss 4.0的第四章描述了如何安裝、編譯、部署及運行一個示例J2EE應用程序。本教程將對如何使用NetBeans IDE來執行那些步驟提供說明。
本教程介紹以下主題：
入門
安裝軟件
安裝示例代碼
注冊 JBoss 應用服務器
創建項目
浏覽源代碼
構建和部署示例應用程序
調試示例應用程序
進一步研究
項目文件
映射 Ant 命令
項目類型
擴展 IDE
注意：本教程僅用於介紹。NetBeans IDE 可以用於構建使用各種技術(由 JBoss 應用服務器提供)的應用程序。包括 Java Management Extensions (JMX)、Enterprise Java Beans (EJBs) 和 web 服務。更多信息請參考進一步研究部分。
安裝並設置就緒後，本示例可以在 30 分鐘內構建。
入門
安裝軟件
開始之前，需要在計算機上安裝如下軟件：
NetBeans IDE 5.0，beta 版或更高版本(下載)。
JBoss Application Server v4(下載)。本教程是使用 JBoss 應用服務器 v4.0.2 開發的，應該也可以使用其他版本進行開發。
Java Standard Development Kit (JDKTM) version 1.4.2(下載)或 5.0(下載)。
安裝示例代碼
Getting Started with JBoss v4.0 使用 J2EE 教程中的 Duke 銀行示例程序。因此，必須安裝 J2EE 教程示例代碼。
安裝 J2EE 1.4 教程(下載)。解壓縮歸檔文件將創建一個 j2eetutorial 文件夾。
從此頁面下載 startguide40.zip (單擊 JBoss AS Getting Started Guide 條目旁邊的 Download 按鈕)。startguide40.zip 文件包含 jbossj2ee-src.zip。jbossj2ee-src.zip 包含 J2EE 教程配合 JBoss 應用服務器使用所需的輔助源文件。將 jbossj2ee-src.zip 文件解壓縮到 j2eetutorial 文件夾。
j2eetutorial/examples/bank/nbproject 文件夾包含本教程不需要的 NetBeans IDE 項目文件，實際上這些文件將引起沖突，因為這些文件未指定由 JBoss 提供的 Ant 腳本。因此請刪除 j2eetutorial/examples/bank/nbproject 文件夾及其所有內容。
編輯 j2eetutorial/jboss-build.properties 並指定 JBoss 應用服務器的安裝位置。這是解壓縮 JBoss 應用服務器歸檔文件時創建的文件夾。例如：
jboss.home=C:/tools/jboss-4.0.2
注冊JBoss應用服務器
在結合使用 JBoss 和 NetBeans IDE 之前，必須注冊 JBoss 應用服務器的本地實例。
在 NetBeans IDE 中，從主窗口選擇 Tools > Server Manager。
單擊 Add Server。選擇 JBoss Application Server 4.0，並為該服務器命名。然後單擊 Next。
指定應用服務器本地實例的位置。然後單擊 Next。
指定服務器域。本教程是使用 default 域開發。然後單擊 Finish。
創建項目
NetBeans IDE 中的大部分工作是從項目開始的。在 NetBeans IDE 中創建項目時，定義了 Java 代碼的類型和結構。IDE 的項目系統是基於 Ant 的，且 NetBeans IDE 可以創建和維護 Ant 構建腳本。另一方面，對於已具有 Ant 構建腳本的現有代碼，NetBeans IDE 可以創建使用該構建腳本的項目。
選擇 File > New Project(Ctrl-Shift-N 或 Macintosh 下的 Command-Shift-N)。在 Categories 下，選擇 Web。在 Projects 下，選擇 Web Application with Existing Ant Script。單擊 Next。
指定 j2eetutorial/examples/bank 文件夾作為 Location。IDE 將使用在 j2eetutorial/examples/bank 文件夾中找到的 build.xml 文件來填充 Build Script 字段。對於本項目，將需要由 JBoss 提供的 Ant 構建腳本，因此單擊 Build Script 字段旁邊的 Browser 按鈕，然後選擇 jboss-build.xml 文件。
指定 JBossDukesBank 作為 Project Name。Project Location 的默認值就不錯，因此不必進行修改。示例如下所示(單擊可獲得最大尺寸的圖像)：
單擊 Next 按鈕。
稍後，在映射 Ant 命令部分您將了解更多關於映射 IDE 命令到 Ant 構建腳本中的目標的 IDE 功能。現在，僅需再次單擊 Next 按鈕，以向前越過 Build and Run actions。
指定 web 作為 Web Pages，並指定 /bank 作為 Context Path。示例如下所示：
單擊 Next 按鈕。
可以添加其他的源包文件夾，但是沒必要，因此再次單擊 Next 按鈕以向前越過 Source Package Folders。
為了使用 IDE 更高級編輯功能(代碼完成、重構等)，編輯器需要應用所使用的 .jar 文件的 Classpath 信息。有四個 .jar 文件隨 JBoss 應用服務器一起安裝，因此需要添加到 Java Source Classpath：
server/default/lib/jboss-j2ee.jar
server/default/lib/javax.servlet.jar
server/default/lib/javax.servlet.jsp.jar
client/jboss-jaxrpc.jar
使用 Add JAR/Folder 按鈕將 .jar 文件添加到 Java Source Classpath;示例如下所示(單擊可獲得最大尺寸的圖像)：
單擊 Next 按鈕。
如果需要支持 JSP 文件中的代碼完成，可以添加其他的 .jar 文件，但是在本項目中沒有必要。因此僅需單擊 Finish 按鈕。IDE 將創建項目並在 Projects 窗口中進行顯示。示例如下所示：
浏覽源代碼
使用 NetBeans IDE 的優勢之一就是具有一個提供語法高亮顯示、代碼完成、重構支持和許多其他功能的編輯器。可以使用 IDE 的編輯器來浏覽 Duke 銀行示例應用的源代碼。
選擇 Window > Navigator 顯示 IDE 的 Navigator 窗口。
展開 JBossDukesBank 項目下的 src 節點。
展開 com.sun.ebank.web 包。
單擊 Dispatcher.java 條目。請注意，Navigator 窗口如何進行更新以顯示 Dispatcher 類的方法。
在 Navigator 窗口中，雙擊 doPost 條目。IDE 的編輯器會打開 Dispatcher.java 文件並顯示 doPost 方法，如下所示(單擊可獲得最大尺寸的圖像)：
花一些時間來浏覽一下 Duke 銀行示例應用中的其他源文件。有幾個便利的特性使得浏覽源代碼更容易，包括：
源代碼行數。選擇 View > Show Line Numbers。
類層次指示器。doPost 方法第一行旁邊的左邊空白處的向上箭頭表示這個方法重寫了一個其他類的方法。將鼠標光標指向向上箭頭可以發現更多信息。
超鏈接。在 doPost 方法中，有一個 AccountHistoryBean 類的參考。按下 Control 鍵(在 Macintosh 上，使用 Command 鍵)，然後將鼠標光標指向 AccountHistoryBean。編輯器將其顏色更改為藍色並標有下劃線，如下所示。標有下劃線時單擊 AccountHistoryBean 將打開 AccountHistoryBean.java 源文件。
向後/向前。在編輯器中的文件之間移動時，您可以像使用 web 浏覽器一樣進行導航。編輯器工具欄上的箭頭按鈕可用於向前或向後導航。也可以使用鍵盤快捷鍵，Alt-K 用於向後，Alt-L 用於向前。
構建和部署示例應用程序
jboss-build.xml Ant腳本包含了准備、構建和部署示例應用程序的目標。因為NetBeans IDE的項目系統是基於Ant的，所以激活這些目標非常容易。
在 Getting Started with JBoss v4 的 4.1.2 部分，告訴您要運行的第一個 Ant 目標是 compile。使用 NetBeans IDE 創建 JBossDukesBank 項目時，IDE 的 Build Project 命令被映射到 jboss-build.xml 中的 compile 目標。因此要激活 compile 目標，僅需右鍵單擊 JBossDukesBank 項目並從上下文菜單中選擇 Build Project。
在IDE底部將出現一個Output窗口，且其最後一行應以BUILD SUCCESSFUL開始。
繼續使用 Getting Started with JBoss v4 中的 4.1.3 部分，您需要運行以下四個目標，按此順序：package-ejb、package-web、package-client 和 assemble-app。NetBeans IDE 使上述操作非常簡單(有關使用 Ant 的更多選項，請參見下面的映射 Ant 命令)。在 Projects 窗口中選擇 jboss-build.xml 條目。IDE 的 Navigator 窗口將顯示全部 Ant 目標。示例如下所示：
若要激活 Ant 目標，請右鍵單擊 Navigator 窗口中的目標，然後從上下文菜單選擇 Run Target。或者右鍵單擊目標時不選擇 Run Target，而選擇 Create Shortcut 並創建一個工具欄按鈕、菜單按鈕或鍵盤快捷鍵。這樣的話，您可以將目標集成到 IDE 中。不論選擇使用哪種方法，請確保每次激活這四個目標中的一個目標：package-ejb、package-web、package-client 和 assemble-app。
Getting Started with JBoss v4 的 4.1.7 部分描述了設置與 JBossof 綁定的 Hypersonic 數據庫。進行操作之前，請確保 JBoss 應用服務器正在運行。若要從 NetBeans IDE 中開始操作，請單擊 Runtime 窗口的圖標，然後展開 Servers 條目。您將在服務器列表中看到 JBoss 條目。如下面的示例所示。
如果應用服務器正在運行，在其名稱旁邊會有一個綠色箭頭圖標()，
如果 JBoss 應用服務器未運行，則右鍵單擊其條目，然後選擇 Start。
Getting Started with JBoss v4 的 4.1.7.1 部分描述了必須對 JBoss 應用服務器的 hsqldb-ds.xml 文件進行的更改。您可以使用 NetBeans IDE 進行那些更改。選擇 File > Open File，然後導航到 JBoss 安裝程序的 server/default/deploy 文件夾，該文件夾包含 hsqldb-ds.xml 文件。選擇該文件，然後單擊 Open 按鈕。IDE 將在編輯器窗口中打開該文件。有兩處需要更改。在文件的頂部，需要修改 connection-url 以使用 tcp 連接。在文件的底部，用於 tcp 連接的 mbean 需要取消注釋。有關完整詳細信息，請參考 4.1.7.1 部分。進行更改後，選擇 File > Save。
激活這些 Ant 目標，按此順序：db-create-table、db-insert 和 db-list。在 IDE 的 Output 窗口中，db-list 目標應顯示數據，示例如下所示。
繼續使用 Getting Started with JBoss v4 的 4.1.8 部分，下一步是部署示例應用程序的 .ear 文件。若要執行上述操作，您可以直接調用 deploy Ant 目標。或者，由於 IDE 的 Deploy Project 命令被映射到 deploy Ant 目標，您可以右鍵單擊 JBossDukesBank 項目條目，然後從上下文菜單中選擇 Redeploy Project。
在您的浏覽器中，指定應用程序登錄屏幕的 URL：http://localhost:8080/bank/main。請注意，如果您配置的 JBoss 應用服務器的端口號不是 8080，則使用配置的端口號。如下面的示例所示。
若要使用該應用，請指定 200 作為 Customer，j2ee 作為 Password。
Getting Started with JBoss v4 的 4.1.8 部分指導您調用的最後一個 Ant 目標是 run-client。run-client 目標啟動一個獨立的客戶端應用程序。創建 JBossDukesBank 項目後，NetBeans IDE 將其 Run Project 命令映射到 run-client 目標，因此可以僅右鍵單擊 JBossDukesBank，然後從上下文菜單中選擇 Run Project 啟動獨立的客戶端應用程序。客戶端服務器啟動後，選擇其 Customer Admin > View Customer Information 選項，然後指定 200 作為 Customer ID。將顯示用戶的信息，如下例所示。
調試示例應用程序
使用 NetBeans IDE 的另一個優勢是它提供了完整功能的調試器。
如果登錄了示例基於浏覽器的應用程序，則單擊應用程序用戶界面右上角的 Logoff 鏈接退出。如果正在運行獨立的應用程序，則單擊其右上角的 X 圖標關閉應用程序。
在 NetBeans IDE 中，需要將要調試的 .jar 和 .war 文件添加到項目所創建的輸出列表中。若要執行上述操作，請在 Projects 窗口中右鍵單擊 JBossDukesBank 條目，然後從上下文菜單中選擇 Properties。
選擇 Output 類別，然後單擊 Add JAR/Folder 按鈕。
選擇 jar 文件夾，然後選擇 app-client.jar、bank-ejb.jar 和 web-client.war 文件。再單擊 Open 按鈕。
單擊 Runtime 選項卡以查看已安裝服務器的列表。右鍵單擊 JBoss 應用服務器條目，然後選擇 Stop。如下面的示例所示。
注意：在 NetBeans v5.0 的 beta 版本中，有一些配置錯誤，該步驟需要執行兩次。如果 IDE 顯示 timeout 錯誤消息，則取消錯誤對話框，然後重復執行該步驟。
在 Runtime 選項卡中，右鍵單擊 JBoss 應用服務器條目，然後選擇 Start in Debug Mode。
打開 Dispatcher.java，並將光標放在 doGet 方法上，以在設置 com.sun.ebank.web.Dispatcher 類的 doGet 方法中設置斷點。然後選擇 Run > Toggle Breakpoint。設置斷點的快捷方式是單擊要放置斷點的行旁邊的左邊空白處。無論哪種方法，IDE 將以紅色背景顯示此行;示例如下所示(單擊可獲得最大尺寸的圖像)。
選擇 Run > Debug Main Project。由於本項目使用自己現有的 Ant 構建腳本，因此 NetBeans IDE 將其作為自由形式項目引用。正如所預料的，項目的 Ant 構建腳本不包含可用於啟動 IDE 調試器的目標。因此，NetBeans IDE 建議創建適合的目標，所顯示的對話框的示例如下所示。
NetBeans IDE將打開兩個編輯器窗口。一個用於ide-targets.xml。該文件包含僅用於IDE的Ant目標。這使得IDE可以為您的項目添加Ant目標，而無需修改您的Ant腳本(在本項目中是jboss-build.xml)。第二個編輯器窗口用於debug.properties。修改debug.properties中的jpda.address和client.url條目，以匹配下面所示的值。
jpda.address=8787
client.url=http://localhost:8080/bank/main
將您的更改保存到 debug.properties，然後選擇 Run > Debug Main Project。
IDE 調試器啟動後，您的浏覽器將自動設置到應用程序登錄屏幕：http://localhost:8080/bank/main。通過指定 200 作為 Customer，j2ee 作為 Password 來登錄應用程序。
單擊應用程序的 Submit 按鈕後，調試器將應用程序停止在先前在 servlet 中設置的斷點處。示例如下所示(單擊可獲得最大尺寸的圖像)：
花一些時間來試驗調試器的功能。若要控制調試器，請從 Run 菜單選擇命令。若要顯示調試器窗口，請選擇 Window > Debugging。完成調試後，請選擇 Run > Finish Debugger Session。
進一步研究
項目文件
Projects 窗口僅顯示了在常規基礎上最可能進行修改的文件的高層邏輯視圖。若要查看項目文件夾中的全部文件，請單擊 Files 選項卡。作為示例，web.xml 文件位於 dd/web 文件夾中，如下列所示。
如果右鍵單擊 web.xml 條目並選擇 Open the IDE 將顯示自定義部署描述符編輯器。
映射 Ant 命令
本教程描述了使用現有 Ant 構建腳本創建自由形式項目。為了讓 NetBeans IDE 使用現有 Ant 構建腳本，必須將其本身的命令映射到該構建腳本的目標。通過右鍵單擊項目並選擇 Properties，您可以控制如何操作該映射。然後單擊 Build and Run。如下面的示例所示。
項目模板
本教程中創建了 Web Application 項目。NetBeans IDE 支持很多其他項目模板。示例應用程序不僅由 web 組件構成：有 Enterprise Java Beans (EJBs) 和一個獨立的應用客戶端。NetBeans IDE 可為每種可交付使用組件的類型創建其他項目。作為示例，可創建一個 EJB Module with Existing Ant Script 項目。IDE 將提供一組重要的 EJB 相關功能，以 EJB 的邏輯視圖開始，如下所示。
擴展 IDE
NetBeans IDE 提供了使用 JBoss 所需的全部標准功能。但是，如果有 IDE 不符合的特定要求，則可以利用 IDE 對創建擴展(稱為模塊)的全面支持。通過創建模塊，您可以輕松增強 IDE 以提供其他 JBoss 功能。例如，可能要將 JBoss 的項目示例添加到 New Project 向導。或者，也許要為 JBoss 部署描述符的創建提供特殊的文件模板。在第一種情況下，將使用 Project Template 向導。在第二種情況下，將使用 Wizard 向導，如下所示(單擊可獲得最大尺寸的圖像)。
這些 File Types 可用於模塊項目：僅需選擇 New > File/Folder。
