先決條件

本文檔假定您已具備以下技術的一些基本知識或編程經驗：

• Java 編程
• NetBeans IDE

本教程所需的軟件

在學習本教程之前，您需要在計算機中安裝以下軟件：

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

在學習本教程之前，您需要在 IDE 中注冊 Sun Java System Application Server 的本地實例。

教程練習

• 建立 Web 應用程序項目
• 創建持久性單元
• 創建實體類
• 創建 Web 接口
• 運行項目
• 疑難解答

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

小結

在本練習中，您創建了一個將包含實體類的 Java EE 5 Web 應用程序。

創建持久性單元

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

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

5. 對于“數據源”，使用缺省的數據源 jdbc/sample。

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

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

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

小結

在本練習中，您創建了一個持久性單元，用來指定數據源、要永久保存的實體類以及容器將用于管理實體生命周期的實體管理器。

創建 Animal 實體類

首先，我們將創建實體類 Animal。此類用于表示數據庫中的 ANIMAL 表。在創建實體類時，IDE 會添加 @Entity 標注以將該類定義為實體類。創建類后，我們將在類中創建字段以表示表中所需的數據，并使用標注提供有關一些字段的其他信息。

每個實體類都必須具有一個主鍵。在創建實體類時，IDE 會添加 @Id 標注以聲明要用作主鍵的字段。此外，IDE 還會添加 @Generated 標注以指定主 Id 的鍵生成策略。

要創建 Animal 類，請執行以下操作：

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

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

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

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

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

       @Column(name="animalName")

5. 我們還希望 Animal 表中的 pavilion 列具有多對一的關系。通過在 pavilion 聲明之上添加以下標注，可以實現這一目的：

       @ManyToOne

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

在下一步中，我們將創建 Pavilion 實體類。

創建 Pavilion 實體類

現在我們將創建實體類 Pavilion，它用于表示數據庫中的 PAVILION 表。我們將再次在類中使用標注指定一些字段的對象關系映射。要創建 Pavilion 類，請執行以下操作：

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

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

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

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

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

       @Column(name="pavilionName")

4. 在 animals 聲明之上添加以下標注，為實體指定一對多的關系：

       @OneToMany(mappedBy="pavilion")

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

小結

在本練習中，您創建了兩個實體類并定義了字段，而且還使用標注定義了在部署應用程序時將在表中生成的某些列的屬性。

使用“新建 - 通過實體類創建 JSF 頁”向導時的問題

使用該向導通過實體類創建 JSF 頁時，您可能會在向導中看到以下錯誤消息：

"This wizard can only be used in a web project with JSF support."（此向導只能在具有 JSF 支持的 Web 項目中使用。）

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

1. 在“項目”窗口中，右鍵單擊 Web 應用程序節點，然后選擇“屬性”。
2. 在“項目屬性”對話框的“類別”窗格中選擇“框架”，然后單擊“添加”。
3. 在“選擇框架”對話框中，選擇 "Java Server Faces"，然后單擊“確定”。
4. 在“項目屬性”對話框中，單擊“確定”以關閉窗口。

將 JSF 框架添加到項目屬性后，您應該能夠使用該向導創建 JSF 頁了。