先決條件

本文檔假定您已具備以下技術(shù)的一些基本知識(shí)或編程經(jīng)驗(yàn)：

• Java 編程
• NetBeans IDE

本教程所需的軟件

在學(xué)習(xí)本教程之前，您需要在計(jì)算機(jī)中安裝以下軟件：

• NetBeans IDE 5.5（下載）
• Java Standard Development Kit (JDK) 版本 5.0 或版本 6.0（下載）
• Sun Java System Application Server Platform Edition 9（下載）

在學(xué)習(xí)本教程之前，您需要在 IDE 中注冊(cè) Sun Java System Application Server 的本地實(shí)例。

教程練習(xí)

• 建立 Web 應(yīng)用程序項(xiàng)目
• 創(chuàng)建持久性單元
• 創(chuàng)建實(shí)體類
• 創(chuàng)建 Web 接口
• 運(yùn)行項(xiàng)目
• 疑難解答

1. 選擇“文件”>“新建項(xiàng)目”(Ctrl-Shift-N)。從 "Web" 類別中選擇“Web 應(yīng)用程序”，然后單擊“下一步”。
2. 將項(xiàng)目命名為 ZooApp，將服務(wù)器設(shè)置為 "Sun Java System Application Server"，將 Java EE 版本設(shè)置為 "Java EE 5"，然后單擊“下一步”。
3. 選中 "JavaServer Faces" 復(fù)選框，然后單擊“完成”。

小結(jié)

在本練習(xí)中，您創(chuàng)建了一個(gè)將包含實(shí)體類的 Java EE 5 Web 應(yīng)用程序。

創(chuàng)建持久性單元

1. 在“項(xiàng)目”窗口中右鍵單擊 "ZooApp" Web 應(yīng)用程序節(jié)點(diǎn)，然后選擇“新建”>“文件/文件夾”以打開“新建文件”向?qū)А?
2. 從“持久性”類別中，選擇“持久性單元”，然后單擊“下一步”。
3. 保留缺省的持久性單元名稱。
4. 對(duì)于“持久性提供程序”，使用 TopLink(default)。

   缺省提供程序是 TopLink Essential.jar。TopLink Essential.jar 包含了 Java 持久性的庫。并且實(shí)體管理器位于 TopLink Essential.jar 中。

5. 對(duì)于“數(shù)據(jù)源”，使用缺省的數(shù)據(jù)源 jdbc/sample。

   缺省數(shù)據(jù)源 jdbc/sample 用于連接到與 Sun Java System Application Server 捆綁在一起的 Java DB 數(shù)據(jù)庫。

6. 檢查是否為持久性單元選中了“使用 Java 事務(wù) API”，以及“表生成策略”是否設(shè)置為“創(chuàng)建”，以便在部署應(yīng)用程序時(shí)創(chuàng)建基于實(shí)體類的表。
7. 單擊“完成”。

單擊“完成”后，IDE 將創(chuàng)建 persistence.xml，并在源代碼編輯器中將其打開。通過單擊源代碼編輯器工具欄中的 "XML"，可以查看 persistence.xml 的 XML。此文件包含了 Java EE 5 容器管理應(yīng)用程序的實(shí)體和持久性所需的所有信息。

小結(jié)

在本練習(xí)中，您創(chuàng)建了一個(gè)持久性單元，用來指定數(shù)據(jù)源、要永久保存的實(shí)體類以及容器將用于管理實(shí)體生命周期的實(shí)體管理器。

創(chuàng)建 Animal 實(shí)體類

首先，我們將創(chuàng)建實(shí)體類 Animal。此類用于表示數(shù)據(jù)庫中的 ANIMAL 表。在創(chuàng)建實(shí)體類時(shí)，IDE 會(huì)添加 @Entity 標(biāo)注以將該類定義為實(shí)體類。創(chuàng)建類后，我們將在類中創(chuàng)建字段以表示表中所需的數(shù)據(jù)，并使用標(biāo)注提供有關(guān)一些字段的其他信息。

每個(gè)實(shí)體類都必須具有一個(gè)主鍵。在創(chuàng)建實(shí)體類時(shí)，IDE 會(huì)添加 @Id 標(biāo)注以聲明要用作主鍵的字段。此外，IDE 還會(huì)添加 @Generated 標(biāo)注以指定主 Id 的鍵生成策略。

要?jiǎng)?chuàng)建 Animal 類，請(qǐng)執(zhí)行以下操作：

1. 右鍵單擊 "ZooApp" 項(xiàng)目節(jié)點(diǎn)，然后選擇“新建”>“文件/文件夾”。
2. 從“持久性”類別中，選擇“實(shí)體類”，然后單擊“下一步”。
3. 鍵入 Animal 作為類名，鍵入 entity 作為包名，并將“主鍵類型”保留為 Long。單擊“完成”。

單擊“完成”后，將在源代碼編輯器中打開新建的實(shí)體類 Animal.java。在源代碼編輯器中，請(qǐng)執(zhí)行以下操作：

1. 將以下字段聲明添加到類中：

     String name;
       String kind;
       String weight;
       Pavilion pavilion;
       

2. 在源代碼編輯器中單擊鼠標(biāo)右鍵，然后選擇“重構(gòu)”>“封裝字段”以便為每個(gè)字段生成 getter 和 setter。在“封裝字段”對(duì)話框中，確保選中所有字段的 getter 和 setter 復(fù)選框。
3. 在“封裝字段”對(duì)話框中單擊“下一步”，然后在“輸出”窗口的“重構(gòu)”標(biāo)簽中單擊“執(zhí)行重構(gòu)”。
4. 現(xiàn)在我們希望更改將在 Animal 表中創(chuàng)建的其中一列的名稱。我們希望該列的名稱是 animalName 而不是 name。通過在 name 字段聲明之上添加以下標(biāo)注，可以使用標(biāo)注來指定生成列的名稱：

       @Column(name="animalName")

5. 我們還希望 Animal 表中的 pavilion 列具有多對(duì)一的關(guān)系。通過在 pavilion 聲明之上添加以下標(biāo)注，可以實(shí)現(xiàn)這一目的：

       @ManyToOne

6. 按 Alt-Shift-F 組合鍵為類生成所有必要的 import 語句。
7. 保存您所做的更改。

在下一步中，我們將創(chuàng)建 Pavilion 實(shí)體類。

創(chuàng)建 Pavilion 實(shí)體類

現(xiàn)在我們將創(chuàng)建實(shí)體類 Pavilion，它用于表示數(shù)據(jù)庫中的 PAVILION 表。我們將再次在類中使用標(biāo)注指定一些字段的對(duì)象關(guān)系映射。要?jiǎng)?chuàng)建 Pavilion 類，請(qǐng)執(zhí)行以下操作：

1. 右鍵單擊 "ZooApp" 項(xiàng)目節(jié)點(diǎn)，然后選擇“新建”>“文件/文件夾”。
2. 從“持久性”類別中，選擇“實(shí)體類”，然后單擊“下一步”。
3. 鍵入 Pavilion 作為類名，鍵入 entity 作為包名，并將“主鍵類型”保留為 Long。單擊“完成”。

單擊“完成”后，將在源代碼編輯器中打開新建的實(shí)體類 Pavilion.java。在源代碼編輯器中，請(qǐng)執(zhí)行以下操作：

1. 將以下字段聲明添加到類中：

     String name;
       String address;
       Collection <Animal> animals;

2. 選擇“重構(gòu)”>“封裝字段”以便為字段生成 getter 和 setter。
3. 在 name 聲明之上添加以下標(biāo)注以更改生成列的名稱：

       @Column(name="pavilionName")

4. 在 animals 聲明之上添加以下標(biāo)注，為實(shí)體指定一對(duì)多的關(guān)系：

       @OneToMany(mappedBy="pavilion")

5. 按 Alt-Shift-F 組合鍵生成所有缺少的 import 語句。
6. 保存您所做的更改。

小結(jié)

在本練習(xí)中，您創(chuàng)建了兩個(gè)實(shí)體類并定義了字段，而且還使用標(biāo)注定義了在部署應(yīng)用程序時(shí)將在表中生成的某些列的屬性。

使用“新建 - 通過實(shí)體類創(chuàng)建 JSF 頁”向?qū)r(shí)的問題

使用該向?qū)ㄟ^實(shí)體類創(chuàng)建 JSF 頁時(shí)，您可能會(huì)在向?qū)е锌吹揭韵洛e(cuò)誤消息：

"This wizard can only be used in a web project with JSF support."（此向?qū)е荒茉诰哂?JSF 支持的 Web 項(xiàng)目中使用。）

如果看到此消息，則需要檢查是否已將 Java Server Faces 框架添加到項(xiàng)目屬性中。通過執(zhí)行以下操作，可以將 Java Server Faces 支持添加到 Web 項(xiàng)目中：

1. 在“項(xiàng)目”窗口中，右鍵單擊 Web 應(yīng)用程序節(jié)點(diǎn)，然后選擇“屬性”。
2. 在“項(xiàng)目屬性”對(duì)話框的“類別”窗格中選擇“框架”，然后單擊“添加”。
3. 在“選擇框架”對(duì)話框中，選擇 "Java Server Faces"，然后單擊“確定”。
4. 在“項(xiàng)目屬性”對(duì)話框中，單擊“確定”以關(guān)閉窗口。

將 JSF 框架添加到項(xiàng)目屬性后，您應(yīng)該能夠使用該向?qū)?chuàng)建 JSF 頁了。