JBoss-IDE 1.2.2 教程 1

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) {