JBoss-IDE 1.2.2 快速開始:
前言:
JBoss-IDE 是 Eclipse 裏的一個 plugin, 現在支援 Eclipse 2.1.x 系列和 Eclipse 3.0.x 系列, 請先下載及安裝 Eclipse (www.eclipse.org).
起動 JBoss
JBoss-IDE 可以令你在 Eclipse 或遠程遙控裏更方便及快速地起動 JBoss 伺服器, 主要功能有:
l 可同時配置多個伺服器
l 在 Eclipse 或遠程遙控裏啟動, 關閉或終止伺服器
l 可取得伺服器中控制台的輸出資料及可監控其日誌檔案
Launcher 用法
在主菜單列中按 ‘Windows’ -> ‘Show View’ -> ‘Other’ -> ‘JBoss-IDE’ -> ‘Server Navigator’.
而 Server Navigator 是一個監控及控制中心, 在 Eclipse 的右下角視窗. 在 ‘Windows’ -> ‘Preferences’ -> ‘JBoss IDE’ 中, 選 ‘Launcher’, 在 ‘Default Server’ 選已安裝的 JBoss 伺服器版本.
如你想將伺服器放在工具列中, 在 ‘Windows’ -> ‘Customize Perspective’ -> ‘Other’, 選 ‘Default Server’ 按 ‘OK’ 就可以了.
配置伺服器
Eclipse 要在 Package Explorer 環境底下, 在主菜單列中按’Run’ -> ‘Debug’, 或在 ‘Server Navigator’ 右擊, 選 ‘configuration’
之後選擇已安裝好 JBoss 的版本, 選 ‘New’, 再填入 JBoss 及 JDK 的設置資料, 再按 ‘Apply’, 再按 ‘Close’.
如配置 3.x.x 版本的 JBoss, 設置設預設的 JRE 會有警告, 最好是設置在JDK 中.
除蟲
如果你是用 Sun 的 JDPA (Java Platform Debugger Architecture) 經 JDWP (Java Debugging Wireless Protocol) 在運行 Java 的虛擬器中除蟲, 這和在 Eclipse 中啟動除蟲系統是一樣的. 而在 Eclipse 裏啟動除蟲系統的分別在於你有接口去監視及控制應用系統的生命週期和控制台的輸入輸出.
在除蟲環境下啟動 JBoss
在實際的應用環境下我們不會用 Eclipse 來啟動 JBoss 伺服器, 所以我們要手動來啟動, 詳細資料可參考 jdpa doc3. 以下是用 Java 1.3.x 及 1.4.x 來啟動 JBoss 3.x.x
l Java 1.3.x: java -Djboss.home={jboss-home} -classpath {jboss-home}/bin/run.jar -Xdebug -Xrunjdwp:transport= dt_socket,server=y,suspend=n,address=10250 org.jboss.Main
l Java 1.4.x: java -Djboss.home={jboss-home} -classpath {jboss-home}/bin/run.jar -Xdebug -Xrunjdwp:transport= dt_socket,server=y,suspend=n,address=10250 org.jboss.Main
Address 只是任意的數值.
在應用中的伺服器除蟲
Java 1.4 以前, 在除蟲環境中起動一個應用系統是要關閉 ‘JIT’ 或 ‘HotSpot’, 但在 1.4 以後就有所不同.
現時 Java HotSpot[TM] 的虛擬器用到了 ‘full-speed debugging’. 在 HotSpot 較早的版本, 當除蟲環境開啟後, 程式只能在編譯器裏運行. 現在的 HotSpot 版本已沒有這個限制, 這樣會令到除蟲更容易及更快速. 設定斷點時會阻止編輯運行, 而編譯器會繼續負責執行程式當除蟲程式依然進行中, 如方法進入/退出, 觀察點等.
Java 1.4.1 可同時支援 Java HotSpot 客戶端及伺服器端用 ‘full-speed debugging’, 而 Java 1.4.1 只可支援客戶端.
這是一個好消息在應用的伺服器裏運行除蟲程式, 但當中的限制是只有一個除蟲器可連接到伺服器裏的除蟲環境.
XDoclet 支援
XDoclet 支援包括有 ‘Code Assist’, ‘Template’ 和 ‘Variables’
Code Assist
當你編寫 Java 時在寫 javadoc 的環境中, 已可啟用 ‘Code Assist’, 就是按 ‘CTRL-Space’ 鍵 (筆者按: 因為我的作業系統中的中文輸入切換鍵也是 ‘CTRL-Space’, 所以我會用 ‘@’ 然後等 ‘Code Assist’ 自動彈出). 而 ‘Code Assist’ 在浮標停在有效的 XDoclet 結構下會自動出現, 如果是在無效的, 會自動傳到 Eclipse 的自動完成處理器. 而如果浮標停在有效的 XDoclet 結構下但已沒有自動完成處理部份, 將不會發生任何事情及會有 ‘beep’ 的一聲. 例子可看下圖:
你輸入的資料會影響 ‘Code Assist’ 所彈出的內容, 而 ‘Code Assist’ 裏的內容會在 XDoclet 的 ‘xtags.xml’ 裏定義, 所以如果有多個 ‘xtags.xml’ 檔案而裏面的內容有矛盾的話, 會導致 ‘Code Assist’ 出錯.
而 ‘Code Assist’ 裏屬性的數值可以是變數. 如你想生成一個 EJB 而其中的 jndi-name 想用 class 的名稱寫入, 你可設置在 ‘Code Assist’ 裏, 詳情請看以下的 ‘Variables’ 部份.
Templates
你可定義你的 Templates 在主菜單列中 ‘Windows’ -> ‘Preferences’ -> ‘JBoss-IDE’ -> ‘XDoclet’ -> ‘Assist’ -> ‘Templates’. 留意當中的內容會應用在不同的條件中, 如方法或類中.
Variables
你可定義 Variables在主菜單列中 ‘Windows’ -> ‘Preferences’ -> ‘JBoss-IDE’ -> ‘XDoclet’ -> ‘Assist’ -> ‘Variables’. 你可以根據一些慣例的表達方式來設置, 但要小心的是你的設定會不會和系統中的變數有衝突.
一般設定
JBoss-IDE 有一個十分好用的 XDoclet 設置介面, 一個項目中可能有很多可自動生成的配置文檔要設定, 你可以在 JBoss-IDE 的 XDoclet 設定中選啟用或停用這些設定. 可看下圖例子:
要定義一個設定時, 在上方的視窗右擊選 ‘Add’ (加上自設的設定) 或 ‘Add Standard’ (加上預設的設定).
所有設定會自轉成 Ant 的 build 文檔, 你可以在 Eclipse 裏或以外去運行. 執行時右擊項目, 選 ‘Run XDoclet’:
封裝支援
JBoss-IDE 的封裝支援可以:
l 用圖像介面設置封裝的設定
l 定義封合或散開的封裝設定
l 封裝可包括所有檔案或資料夾
l 能夠設置封裝的規劃字首
l 能夠簡單地選擇啟用或停用設定 (Check boxes)
封裝設定
JBoss-IDE 在項目中有一個很好的介面去設置封裝的設定. 一個項目可以有多個封裝的設定, 而每一個設定你可以簡單地選擇啟用或停用. 下圖是一個例子:
要定義一個設定時, 在右方的視窗右擊選 ‘Add Archive’ (加上自設的設定), ‘Add Std. Archive’ (加上預設的設定), ‘Add File’ 或 ‘Add Folder’ 等.
所有設定會自轉成 Ant 的 build 文檔, 你可以在 Eclipse 裏或以外去運行. 執行時右擊項目, 選 ‘Run Packaging’:
部署支援
JBoss-IDE 的部署支援可以:
l 用圖像介面設置部署的設定
l JBoss 除蟲起動設置會自動定義檔案系統的目標
l 定義使用者的自設設定
l 能夠簡單地選擇 部署/重新部署/放棄部署
l 會有裝飾圖像顯示己部署的資源
部署設定
JBoss-IDE 在項目中有一個很好的介面去設置封裝的設定. 在主菜單列中 ‘Windows’ -> ‘Preferences’ -> ‘JBoss-IDE’ -> ‘Deployer’ 去設定:
去設定一個部署的目標, 可用右手邊的鍵組.
要部署一個資源 (如 .ear 檔案), 右擊此資源, 選擇 ‘Deploy To…’, 再選擇要部署的目標, 如下圖:
部署完成後, 在 workspace 中你會看到己部署的資源會有裝飾圖像顯示, 如下圖:
出處:
http://prdownloads.sourceforge.net/jboss/QuickStart-1.2.2.pdf?download
