本文將展示如何結合使用 NetBeans 集成開發環境 (IDE) 和 JBoss 應用服務器
Getting Started with JBoss 的第四章描述了如何安裝編譯部署及運行一個示例 JEE 應用程序本教程將對如何使用 NetBeans IDE 來執行那些步驟提供說明
本教程介紹以下主題
安裝軟件
安裝示例代碼
注冊 JBoss 應用服務器
創建項目
浏覽源代碼
構建和部署示例應用程序
調試示例應用程序
項目文件
映射 Ant 命令
項目類型
擴展 IDE
注意本教程僅用於介紹NetBeans IDE 可以用於構建使用各種技術(由 JBoss 應用服務器提供)的應用程序包括 Java Management Extensions (JMX)Enterprise Java Beans (EJBs) 和 web 服務更多信息請參考進一步研究部分
安裝並設置就緒後本示例可以在 分鐘內構建
安裝軟件
開始之前需要在計算機上安裝如下軟件
NetBeans IDE beta 版或更高版本(下載)
JBoss Application Server v(下載)本教程是使用 JBoss 應用服務器 v 開發的應該也可以使用其他版本進行開發
Java Standard Development Kit (JDKTM) version (下載)或 (下載)
安裝示例代碼
Getting Started with JBoss v 使用 JEE 教程中的 Duke 銀行示例程序因此必須安裝 JEE 教程示例代碼
安裝 JEE 教程(下載)解壓縮歸檔文件將創建一個 jeetutorial 文件夾
從此頁面下載 startguidezip (單擊 JBoss AS Getting Started Guide 條目旁邊的 Download 按鈕)startguidezip 文件包含 jbossjeesrczipjbossjeesrczip 包含 JEE 教程配合 JBoss 應用服務器使用所需的輔助源文件將 jbossjeesrczip 文件解壓縮到 jeetutorial 文件夾
jeetutorial/examples/bank/nbproject 文件夾包含本教程不需要的 NetBeans IDE 項目文件實際上這些文件將引起沖突因為這些文件未指定由 JBoss 提供的 Ant 腳本因此請刪除 jeetutorial/examples/bank/nbproject 文件夾及其所有內容
編輯 jeetutorial/jbossbuildproperties 並指定 JBoss 應用服務器的安裝位置這是解壓縮 JBoss 應用服務器歸檔文件時創建的文件夾例如
jbosshome=C:/tools/jboss
注冊 JBoss 應用服務器
在結合使用 JBoss 和 NetBeans IDE 之前必須注冊 JBoss 應用服務器的本地實例
在 NetBeans IDE 中從主窗口選擇 Tools > Server Manager
單擊 Add Server選擇 JBoss Application Server 並為該服務器命名然後單擊 Next
指定應用服務器本地實例的位置然後單擊 Next
指定服務器域本教程是使用 default 域開發然後單擊 Finish
創建項目
NetBeans IDE 中的大部分工作是從項目開始的在 NetBeans IDE 中創建項目時定義了 Java 代碼的類型和結構IDE 的項目系統是基於 Ant 的且 NetBeans IDE 可以創建和維護 Ant 構建腳本另一方面對於已具有 Ant 構建腳本的現有代碼NetBeans IDE 可以創建使用該構建腳本的項目
選擇 File > New Project(CtrlShiftN 或 Macintosh 下的 CommandShiftN)在 Categories 下選擇 Web在 Projects 下選擇 Web Application with Existing Ant Script單擊 Next
指定 jeetutorial/examples/bank 文件夾作為 LocationIDE 將使用在 jeetutorial/examples/bank 文件夾中找到的 buildxml 文件來填充 Build Script 字段對於本項目將需要由 JBoss 提供的 Ant 構建腳本因此單擊 Build Script 字段旁邊的 Browser 按鈕然後選擇 jbossbuildxml 文件
指定 JBossDukesBank 作為 Project NameProject 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/jbossjeejar
server/default/lib/javaxservletjar
server/default/lib/javaxservletjspjar
client/jbossjaxrpcjar
使用 Add JAR/Folder 按鈕將 jar 文件添加到 Java Source Classpath;示例如下所示(單擊可獲得最大尺寸的圖像)
單擊 Next 按鈕
如果需要支持 JSP 文件中的代碼完成可以添加其他的 jar 文件但是在本項目中沒有必要因此僅需單擊 Finish 按鈕IDE 將創建項目並在 Projects 窗口中進行顯示示例如下所示
浏覽源代碼
使用 NetBeans IDE 的優勢之一就是具有一個提供語法高亮顯示代碼完成重構支持和許多其他功能的編輯器可以使用 IDE 的編輯器來浏覽 Duke 銀行示例應用的源代碼
選擇 Window > Navigator 顯示 IDE 的 Navigator 窗口
展開 JBossDukesBank 項目下的 src 節點
展開 comsunebankweb 包
單擊 Dispatcherjava 條目請注意Navigator 窗口如何進行更新以顯示 Dispatcher 類的方法
在 Navigator 窗口中雙擊 doPost 條目IDE 的編輯器會打開 Dispatcherjava 文件並顯示 doPost 方法如下所示(單擊可獲得最大尺寸的圖像)
花一些時間來浏覽一下 Duke 銀行示例應用中的其他源文件有幾個便利的特性使得浏覽源代碼更容易包括
源代碼行數選擇 View > Show Line Numbers
類層次指示器doPost 方法第一行旁邊的左邊空白處的向上箭頭表示這個方法重寫了一個其他類的方法將鼠標光標指向向上箭頭可以發現更多信息
超鏈接在 doPost 方法中有一個 AccountHistoryBean 類的參考按下 Control 鍵(在 Macintosh 上使用 Command 鍵)然後將鼠標光標指向 AccountHistoryBean編輯器將其顏色更改為藍色並標有下劃線如下所示標有下劃線時單擊 AccountHistoryBean 將打開 AccountHistoryBeanjava 源文件
向後/向前在編輯器中的文件之間移動時您可以像使用 web 浏覽器一樣進行導航編輯器工具欄上的箭頭按鈕可用於向前或向後導航也可以使用鍵盤快捷鍵AltK 用於向後AltL 用於向前
構建和部署示例應用程序
jbossbuildxml Ant 腳本包含了准備構建和部署示例應用程序的目標因為 NetBeans IDE 的項目系統是基於 Ant 的所以激活這些目標非常容易
在 Getting Started with JBoss v 的 部分告訴您要運行的第一個 Ant 目標是 compile使用 NetBeans IDE 創建 JBossDukesBank 項目時IDE 的 Build Project 命令被映射到 jbossbuildxml 中的 compile 目標因此要激活 compile 目標僅需右鍵單擊 JBossDukesBank 項目並從上下文菜單中選擇 Build Project
在 IDE 底部將出現一個 Output 窗口且其最後一行應以 BUILD SUCCESSFUL 開始
繼續使用 Getting Started with JBoss v 中的 部分您需要運行以下四個目標按此順序packageejbpackagewebpackageclient 和 assembleappNetBeans IDE 使上述操作非常簡單(有關使用 Ant 的更多選項請參見下面的映射 Ant 命令)在 Projects 窗口中選擇 jbossbuildxml 條目IDE 的 Navigator 窗口將顯示全部 Ant 目標示例如下所示
若要激活 Ant 目標請右鍵單擊 Navigator 窗口中的目標然後從上下文菜單選擇 Run Target或者右鍵單擊目標時不選擇 Run Target而選擇 Create Shortcut 並創建一個工具欄按鈕菜單按鈕或鍵盤快捷鍵這樣的話您可以將目標集成到 IDE 中不論選擇使用哪種方法請確保每次激活這四個目標中的一個目標packageejbpackagewebpackageclient 和 assembleapp
Getting Started with JBoss v 的 部分描述了設置與 JBossof 綁定的 Hypersonic 數據庫進行操作之前請確保 JBoss 應用服務器正在運行若要從 NetBeans IDE 中開始操作請單擊 Runtime 窗口的圖標然後展開 Servers 條目您將在服務器列表中看到 JBoss 條目如下面的示例所示
如果應用服務器正在運行在其名稱旁邊會有一個綠色箭頭圖標()
如果 JBoss 應用服務器未運行則右鍵單擊其條目然後選擇 Start
Getting Started with JBoss v 的 部分描述了必須對 JBoss 應用服務器的 hsqldbdsxml 文件進行的更改您可以使用 NetBeans IDE 進行那些更改選擇 File > Open File然後導航到 JBoss 安裝程序的 server/default/deploy 文件夾該文件夾包含 hsqldbdsxml 文件選擇該文件然後單擊 Open 按鈕IDE 將在編輯器窗口中打開該文件有兩處需要更改在文件的頂部需要修改 connectionurl 以使用 tcp 連接在文件的底部用於 tcp 連接的 mbean 需要取消注釋有關完整詳細信息請參考 部分進行更改後選擇 File > Save
激活這些 Ant 目標按此順序dbcreatetabledbinsert 和 dblist在 IDE 的 Output 窗口中dblist 目標應顯示數據示例如下所示
繼續使用 Getting Started with JBoss v 的 部分下一步是部署示例應用程序的 ear 文件若要執行上述操作您可以直接調用 deploy Ant 目標或者由於 IDE 的 Deploy Project 命令被映射到 deploy Ant 目標您可以右鍵單擊 JBossDukesBank 項目條目然後從上下文菜單中選擇 Redeploy Project
在您的浏覽器中指定應用程序登錄屏幕的 //localhost:/bank/main請注意如果您配置的 JBoss 應用服務器的端口號不是 則使用配置的端口號如下面的示例所示
若要使用該應用請指定 作為 Customerjee 作為 Password
Getting Started with JBoss v 的 部分指導您調用的最後一個 Ant 目標是 runclientrunclient 目標啟動一個獨立的客戶端應用程序創建 JBossDukesBank 項目後NetBeans IDE 將其 Run Project 命令映射到 runclient 目標因此可以僅右鍵單擊 JBossDukesBank然後從上下文菜單中選擇 Run Project 啟動獨立的客戶端應用程序客戶端服務器啟動後選擇其 Customer Admin > View Customer Information 選項然後指定 作為 Customer ID將顯示用戶的信息如下例所示
調試示例應用程序
使用 NetBeans IDE 的另一個優勢是它提供了完整功能的調試器
如果登錄了示例基於浏覽器的應用程序則單擊應用程序用戶界面右上角的 Logoff 鏈接退出如果正在運行獨立的應用程序則單擊其右上角的 X 圖標關閉應用程序
在 NetBeans IDE 中需要將要調試的 jar 和 war 文件添加到項目所創建的輸出列表中若要執行上述操作請在 Projects 窗口中右鍵單擊 JBossDukesBank 條目然後從上下文菜單中選擇 Properties
選擇 Output 類別然後單擊 Add JAR/Folder 按鈕
選擇 jar 文件夾然後選擇 appclientjarbankejbjar 和 webclientwar 文件再單擊 Open 按鈕
單擊 Runtime 選項卡以查看已安裝服務器的列表右鍵單擊 JBoss 應用服務器條目然後選擇 Stop如下面的示例所示
注意在 NetBeans v 的 beta 版本中有一些配置錯誤該步驟需要執行兩次如果 IDE 顯示 timeout 錯誤消息則取消錯誤對話框然後重復執行該步驟
在 Runtime 選項卡中右鍵單擊 JBoss 應用服務器條目然後選擇 Start in Debug Mode
打開 Dispatcherjava並將光標放在 doGet 方法上以在設置 comsunebankwebDispatcher 類的 doGet 方法中設置斷點然後選擇 Run > Toggle Breakpoint設置斷點的快捷方式是單擊要放置斷點的行旁邊的左邊空白處無論哪種方法IDE 將以紅色背景顯示此行;示例如下所示(單擊可獲得最大尺寸的圖像)
選擇 Run > Debug Main Project由於本項目使用自己現有的 Ant 構建腳本因此 NetBeans IDE 將其作為自由形式項目引用正如所預料的項目的 Ant 構建腳本不包含可用於啟動 IDE 調試器的目標因此NetBeans IDE 建議創建適合的目標所顯示的對話框的示例如下所示
NetBeans IDE 將打開兩個編輯器窗口一個用於 idetargetsxml該文件包含僅用於 IDE 的 Ant 目標這使得 IDE 可以為您的項目添加 Ant 目標而無需修改您的 Ant 腳本(在本項目中是 jbossbuildxml)第二個編輯器窗口用於 debugproperties修改 debugproperties 中的 jpdaaddress 和 clienturl 條目以匹配下面所示的值
jpdaaddress=
//localhost:/bank/main
將您的更改保存到 debugproperties然後選擇 Run > Debug Main Project
IDE 調試器啟動後您的浏覽器將自動設置到應用程序登錄屏幕//localhost:/bank/main通過指定 作為 Customerjee 作為 Password 來登錄應用程序
單擊應用程序的 Submit 按鈕後調試器將應用程序停止在先前在 servlet 中設置的斷點處示例如下所示(單擊可獲得最大尺寸的圖像)
花一些時間來試驗調試器的功能若要控制調試器請從 Run 菜單選擇命令若要顯示調試器窗口請選擇 Window > Debugging完成調試後請選擇 Run > Finish Debugger Session
項目文件
Projects 窗口僅顯示了在常規基礎上最可能進行修改的文件的高層邏輯視圖若要查看項目文件夾中的全部文件請單擊 Files 選項卡作為示例webxml 文件位於 dd/web 文件夾中如下列所示
如果右鍵單擊 webxml 條目並選擇 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
From:http://tw.wingwit.com/Article/program/Java/ky/201311/28137.html
