先决条件

本文档假定您已具备以下技术的一些基本知识或编程经验：

• 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 页了。