JBoss-IDE 1.2.2 教程 1:
前言:
JBoss-IDE 是 Eclipse 裏的一個 plugin, 現在支援 Eclipse 2.1.x 系列和 Eclipse 3.0.x 系列, 請先下載及安裝 Eclipse (www.eclipse.org).
介紹:
這個教程的主要的目的是演示怎樣簡單地運用 JBoss-IDE/Eclipse 去開發 J2EE 的應用項目. 而當中的實例是在 J2EE 的項目中用一個會話(Session) EJB 和一個 Servlet 去計算斐波納契數列 (Fibonacci, 即一種整數數列,其中每數等於前面兩數之和).
教程會分開幾部份:
l 項目: 這部份會顯示開發項目前的預備 (來源和建立的路徑)
l EJB: 這部份會顯示怎樣一起用 XDoclet 的 javadoc 標籤來寫 EJB
l 生成 EJB 檔案: 這部份顯示怎樣設置 XDoclet 的生成設定來生成所有有關 EJB 的檔案
l Servlet 和 Web-App: 這部份顯示怎樣一起用 XDoclet 的 javadoc 標籤來寫 Servlet
l 生成 Servlet 檔案: 這部份顯示怎樣設置 XDoclet 的生成設定來生成所有有關 Web 的檔案
l J2EE 應用項目: 這部份顯示怎樣新增遺留的檔案
l 封裝: 這部份顯示怎樣封裝 J2EE 的應用項目
l JBoss 設置: 這部份顯示怎樣在 Eclipse 裏在除蟲設定去起動 JBoss
l 部署: 這部份顯示怎樣部署 J2EE 的應用項目
l 除蟲: 這部份顯示怎樣設置斷點在部署好的項目中除蟲
需求:
要運行這個教程的實例, 你先要有:
l Java Development Kit 1.3.0 或以上版本 (JDK 是為了起動 JBoss 3.x)
l Eclipse 2.1.0 (http://www.eclipse.org) 或以上版本
l JBoss 伺服器 3.0.x 或 3.2.x
你亦需要一些在 Eclipse 裏開發和除蟲的知識. 可在 Eclipse 的網頁內看到更多的資訊.
項目:
這部份會顯示開發項目前的預備, 我們會新增一個來源的資料夾, 輸入庫和建立路徑.
在 Eclipse 裏新增一個 Java 項目. 名字輸入 ‘Tutorial’.
新增一個來源資料夾 ‘src’. 而預設的輸出資料夾為 ‘bin’, 然後按 ‘Finish’.
在 package explorer, 你應會看到此圖:
在 JBoss 的資料夾裏複製兩個檔案放在項目的根目錄裏:
l Javax.servlet.jar (在 JBoss 的 server/default/lib 中)
l Jboss-j2ee.jar (在 JBoss 的 server/default/lib 中)
我們需要將這兩個 jar 檔案放在建立路徑中, 右擊項目選 ‘Properties’ -> ‘Java Build Path’ -> ‘Add jars…’, 再選這兩個 jar 檔案, 再按 ‘OK’:
記錄設定後, 你應會看到此圖:
EJB:
下一步是新增一個 EJB. 為了簡化程式, 會是新增一個沒有狀態的會話 (Stateless Session) bean, 其他類型的 EJB 也是很容易寫的.
新增一個 Java Class. Package 填入 ‘tutorial.ejb’ 和名稱填入 ‘FiboBean’. 按 ‘Add…’ 加上 ‘SessionBean’ interface. 選 ‘Constructors from superclass’ 和 ‘Inherited abstract methods’.
記錄設定後, 你應會看到此圖:
開啟 ‘FiboBean.java’ 檔案. 我們要新增一個沒有參數的 ‘ejbCreate’ 方法去定義沒有狀態的會話 bean.
public void ejbCreate() throws CreateException {
}
再新增一個計算斐波納契數列的方法, compute, 返回一個 double 列.
public double[] compute(int number) {
if (number < 0) {
throw new EJBException("Argument should be positive");
}
double[] suite = new double[number + 1];
suite[0] = 0;
if (number == 0) {
return suite;
}
suite[1] = 1;
for (int i = 2; i <= number; i++) {
suite[i] = suite[i - 1] + suite[i - 2];
}
return suite;
}
下一步是加插 EJB XDoclet 的 javadoc 相關的標籤. 在 Java 的編輯視窗 javadoc 的段落上輸入 ‘@ejb’ 再按 ‘CTRL + Space’ (筆者按: 筆者是用中文作業系統, 而切換中/英輸入的鍵組正是 ‘CTRL + Space’, 所以這個功能不是太可行, 而我的解決方法是輸入 ‘@’ 再等一下便會出現自動完成代碼功能), 便會看到自動完成功能的視窗彈出:
選擇 ‘Stateless Session EJB’ 後完成 XDoclet 的標籤, 如下:
*
* @ejb.bean name = "Fibo"
* display-name = "Fibo EJB"
* description = "EJB that computes Fibonacci suite"
* view-type = "remote"
* jndi-name = "ejb/tutorial/Fibo"
*/
public class FiboBean implements SessionBean {
而 ‘ejbCreate’ 方法的 XDoclet 標籤代碼如下:
/**
* Default create method
* @throws CreateException
* @ejb.create-method
*/
public void ejbCreate() throws CreateException {
‘compute’ 方法的 XDoclet 標籤代碼如下:
/**
* @param number
* @return
*
* @ejb.interface-method view-type = "remote"
*/
public double[] compute(int number) {
