通过数据库生成 JavaServer Faces CRUD 应用程序

查看数据库结构

要查看是否已经正确创建了表，展开数据库连接节点下的“表”节点。您可以展开表节点来查看表的列、索引和任意外键。可以右键单击一列并选择“属性”来查看关于该列的其他信息。

如果在“表”节点下没看到任何表，右键单击“表”节点并选择刷新。

从 consult 数据库的结构可看出该数据库包含含有各种关系和各种字段类型的表。通过数据库创建实体类时，IDE 会为各种字段类型自动生成相应的代码。

下表描述了 consult 数据库中的表

consult 数据库包含各种关系。通过数据库创建实体类时，IDE 会自动生成表关系的代码，将相应的标注添加到实体类的字段中。下表描述了 consult 数据库中的表关系。（未显示逆向关系）

创建数据库之后，您可以创建 Web 应用程序，并使用“通过数据库创建实体类”向导来生成基于数据库表的实体类。

编辑 Address.java

打开“Address”实体类并进行以下更改。

1. 修改 toString 方法的 return 语句以返回完整的地址：

   return line1 + ", " + line2 + ", " + city + ", " + region + ", " + country + ", " + postalCode;

   可以使用 IDE 的代码完成功能来帮助您添加字段。

   
2. 如有必要，修复导入并保存更改。

编辑 Billable.java

打开 Billable 实体类并进行以下更改。

1. 修改 toString 方法的 return 语句，以返回 description、consultant id 和 project：

   public String toString() {
           return description + ", " + consultantId + ", " + project;

2. 如有必要，修复导入并保存更改。

编辑 Client.java

1. 修改 recruiterCollection 字段的 @OneToMany 标注，改为一对一关系，将字段由 Collection 改为 Recruiter recruiter。

   @OneToOne(mappedBy = "client")
   private Recruiter recruiter;

2. 根据字段名的变化修改 Collection<Recruiter> recruiterCollection 的 getter 和 setter 方法。新的 getter 和 setter 方法如下所示：

   public Recruiter getRecruiter() {
       return recruiter;
   }
   
   public void setRecruiter(Recruiter recruiter) {
       this.recruiter = recruiter;
   }

   使用“插入代码”对话框删除 Collection<Recruiter> recruiterCollection 的 getter 和 setter 方法然后为 Recruiter recruiter 生成新的 getter 和 setter 方法会更加容易。要创建新的 getter 和 setter 方法，请右键单击源代码，选择“插入代码（Alt-Insert）”然后选择 “Getter 和 Setter”。在“生成 Getter 和 Setter”对话框中选择 recruiter，并单击“生成”。

   
3. 修改 toString 方法的 return 语句，以返回 String.valueOf(clientPK)。

   public String toString() {
       return String.valueOf(clientPK);
   }

4. 如有必要，修复导入并保存更改。

编辑 ClientPK.java

1. 修改 toString 方法的 return 语句以返回 client name 和 department number。

   public String toString() {
       return clientName + ", " + "Dept. " + clientDepartmentNumber;
   }

2. 如有必要，修复导入并保存更改。

编辑 Consultant.java

1. 修改 toString 方法的 return 语句以返回 email。

   public String toString() {
       return email;
   }

2. 如有必要，修复导入并保存更改。

编辑 ConsultantStatus.java

1. 修改 toString 方法的 return 语句以返回 status ID 和 description。

   public String toString() {
       return statusId + ", " + description;
   }

2. 如有必要，修复导入并保存更改。

编辑 Project

1. 修改 toString 方法的 return 语句以返回以下内容：

   public String toString() {
       return (projectPK == null ? "(unnamed project)" : projectPK.getProjectName()) + ", " + client;
   }

2. 如有必要，修复导入并保存更改。

编辑 Recruiter.java

1. 修改 client 字段的 @ManyToOne 标注，将关系标示为一对一关系。

   @OneToOne
   private Client client;

2. 修改 toString 方法的 return 语句以返回 email。

   public String toString() {
       return email;
   }

3. 如有必要，修复导入并保存更改。

在应用程序中启用 Ajax

在“通过实体类创建 JSF 页面”向导的最终面板中，您可以选择 生成的支持 Ajax 的页面，通过 JSF 框架的 Dynamic Faces 扩展在应用程序中启用 Ajax 功能。向导将所需的“JSF 扩展”库添加到该项目并配置应用程序的部署描述符，从而启用 Ajax 生命周期。有关 Dynamic Faces JSF 扩展的更多信息，请参见 JavaServer Faces 技术扩展站点。

如果选择该选项，向导会执行以下操作。

• 将“JSF 扩展”库添加到项目（jsf-extensions-common、jsf-extensions-dynamic-faces、commons-logging 和 shale-remoting），这是在项目中使用 Dynamic Faces 技术所必需的。
  
• 通过为 javax.faces.LIFECYCLE_ID 初始化参数添加条目并设定到 com.sun.faces.lifecycle.PARTIAL 的值，修改 Web.xml 以配置 FacesServlet 从而使用 Ajax 生命周期。
  
• 在 Web-INF/jspf 目录下生成 JSP 片段文件 AjaxScripts.jspf。AjaxScripts.jspf将 呈现包含在 Dynamic Faces 库中的 JavaScript 文件。

该应用程序在 Web 页面目录中包含了一个 JavaScript 文件 jsfcrud.js。jsfcrud.js 文件检查是否呈现了 Dynamic Faces JavaScript，以确定是否启用了 Dynamic Faces。如果启用了 Dynamic Faces，该表单将被配置为发送 Ajax 请求。

使用 Dynamic Faces 扩展在应用程序中启用 Ajax 之后，可以修改该应用程序以进一步添加由 Dynamic Faces 扩展提供的功能。

通过实体类生成 JPA 控制器类

在生成的 Web 应用程序中，JPA 控制器方法被 JSF 控制器类中的方法访问。使用“通过实体类创建 JSF 页”向导时，IDE 会自动为每个选定的实体生成 JPA 控制器类。但 JPA 控制器类的使用并不限于 JSF Web 应用程序。您可以在使用 Java 持久性 API（例如，桌面应用程序）的其他应用程序中使用 JPA 控制器类，以操作实体类并管理实体持久性。

借助“基于实体类的 JPA 控制器类”向导，您可以轻松地在项目中创建 JPA 控制器类。要创建 JPA 控制器类，请在“持久性”类别中打开“新建文件”向导，并选择“通过实体类生成 JPA 控制器类”。在向导中，指定 JPA 控制器类所针对的实体类，然后指定 IDE 创建该文件的位置。该向导还会自己创建 JPA 控制器类所使用的异常类。

生成 JPA 控制器之后，可以从其它文件访问这些控制器方法。如更新数据库架构，可再次运行“通过数据库创建实体类”和“通过实体类创建 JPA 控制器”向导以更新数据。如果愿意，创建 JPA 控制器类之后，可运行“通过实体类创建 JSF 页”向导并指定现有 JPA 控制器类包，在这种情况下，您将利用现有的 JPA 控制器类而非重新生成。

使用 SQL 脚本添加数据

如果不希望通过 Web 形式添加数据，您可以运行包含在 derby-consult.zip 中的 derby_insert_data_consult.sql 脚本。

1. 从主菜单选择“文件 > 打开文件”，打开 derby_insert_data_consult.sql。

   文件将自动在 SQL 编辑器中打开。

2. 请确保在 SQL 编辑器工具栏的连接下拉列表中选定了 consult 数据库，在工具栏中单击“运行 SQL”按钮。
   

   您可以在“输出”窗口中查看脚本运行的结果。

注意：如果正在使用的是 MySQL 数据库服务器，请打开包含在 mysql-consult.zip 中的 mysql_insert_data_consult.sql 文件。

使用 Web 接口添加数据

可通过在浏览器中启动该应用程序并通过 Web 表单添加数据的形式为数据库添加数据。

1. 在主工具栏中单击“运行主项目”。

   IDE 将保存所有修改的文件，重新生成应用程序并将其部署到服务器中。缺省 Web 浏览器打开到以下本地址：http://localhost:8080/ConsultingAgency/.

   
2. 单击“显示全部地址条目”并单击“新建地址”。
3. 将以下数据添加到 "New Address" 表单。

   字段	值
   Line1	100 Data Street
   Line2	Suite 432
   City	San Francisco
   区域	California
   Country	USA
   PostalCode	94103

   单击“创建”
4. 单击索引以返回到索引页面。
5. 单击“显示全部客户条目”并单击“新建客户”
6. 在 "New Client" 表单中，添加以下数据。

   字段	值
   ClientDepartmentNumber	2000
   Client Name	Big Data Corp.
   Contact Email	accounting@bigdatacorp.com
   Contact Password	accounting

7. 从下拉列表的 BillingAddress 中选择 "Palm Spring Street"。
8. 单击“创建”，再单击“索引”，返回到索引页面。
9. 单击“显示全部 Project 条目”并单击“新建项目”。
10. 在 "New Project" 表单中添加以下数据.

    字段	值
    ProjectName	Secret Project
    ContactEmail	project.manager@bigdatacorp.com
    ContactPassword	project.manager

    单击“创建”，再单击“索引”，返回到索引页面。
11. 单击“显示全部 Consultant Status 条目”并单击“新建 Consultant Status”
12. 在新的 ConsultantStatus 表单中添加以下数据。

    字段	值
    StatusId	A
    描述	活动

    单击“创建”，再单击“索引”，返回到索引页面。
13. 单击“显示全部 Consultant 条目”然后单击“新建 Consultant”。
14. 在新 Consultant 表单中添加以下数据

    字段	值
    电子邮件	janet.smart@jsfcrudconsultants.com
    口令	janet.smart
    HourlyRate	80
    BillableHourlyRate	120

15. 在 ProjectCollection 字段中选择 "Secret Project"。
16. 从 StatusId 下拉列表中选择 A，Active。
17. 单击“创建”，再单击“索引”，返回到索引页面。
18. 单击显示全部 Billable 条目并单击“新建 Billable”
19. 将以下数据添加到 "New Billable" 表单中。

    字段	值
    StartDate	2008-10-13 00:00:00.0
    EndDate	2008-10-17 00:00:00.0
    小时	40
    HourlyRate	80
    BillableHourlyRate	120
    描述	begin gathering requirements
    ConsultantId	janet.smart@jsfcrudconsultants.com
    项目	Secret Project

    Click Create and then click New Billable.
20. 将以下数据添加到 "New Billable" 表单中。

    这次，将在描述字段中键入 finish gathering requirements。

    字段	值
    StartDate	2008-10-20 00:00:00.0
    EndDate	2008-10-24 00:00:00.0
    小时	40
    HourlyRate	80
    BillableHourlyRate	120
    描述	finish gathering requirements
    ConsultantId	janet.smart@jsfcrudconsultants.com
    项目	Secret Project

    单击“创建”并返回到索引页面。
21. 单击“显示全部 Recruiter 条目”并单击 "New Recruiter"。
22. 将以下数据添加到 "New Recruiter" 表单。

    字段	值
    电子邮件	bob@jsfcrudconsultants.com
    口令	bob

23. 在 ConsultantCollection 列表中选择 janet.smart@jsfcrudconsultants.com。

注意：保留 Client 下拉列表为空。

24. 单击“创建”，再单击“索引”，返回到索引页面。

向数据库添加数据后，可通过生成的页面进行导航，以查看各表之间的关系。

只读主键字段

如果字段为数据库的主键，向导将生成代码以防止用户在生成的表单中编辑字段。下面这个例子演示了主键字段为只读的情况。

• 如果导航至 New Client 页面，可看到 ProjectCollection 字段为只读。如果应用程序允许改变与现有项目相关的 Client，该操作将失败，因为与项目相关联的 Client 是该项目主键的一部分。 可通过检验 consult_project_pk 主键和 consult_project_fk_client_name 外键在 SQL 脚本中对此进行验证。
• 导航至“编辑项目页面”，可以看到该 Client 字段为只读。该字段为只读是因为与某项目相关联的 Client 是该项目主键的一部分。

生成的错误检验

生成的代码可检验某项用户操作是否会引起错误。例如，如果表有一列不能为空，代码可检验一项行为是否会引起字段为空，并显示一条错误消息。填充数据库后，尝试编辑表单中的数据就会看到生成的检验的例子。如果试图完成以下行为，将收到一条错误消息。

• 创建另一个“项目”条目 ，指定 Secret Project 作为项目名称，并填写 ContactEmail 和 Client 字段。

  此时出现了一条错误消息，表明该条目已经存在。

• 创建另一个 "Address" 条目，但保留所有字段为空。

  此时出现了一条错误消息，提示必需填写的字段。

• 通过取消选择 BillableCollection 列表中的 "finish gathering requirements" 来编辑 "janet.smart@jsfcrudconsultants.com" Consultant 条目。

  此时出现了一条错误消息，指示取消选择的 Billable 条目必须保留，因为其 consultantId 字段不能为空。

• 销毁 "Secret Project, Big Data Corp., Dept.2000" 项目条目。

  出现错误消息指出该“项目”条目不能被销毁，因为在相关联的 Billable 条目中，project 字段不能为空。

• 销毁已被其他用户销毁的条目。

  出现错误消息指出该条目已经不存在，且该条目已经不再显示在列表中。

  如果您使用两个浏览器，可完成此操作：在每个浏览器中导航到同一个页面（例如，Listing Billable Items 页面）。在其中一个浏览器中销毁一个 Billable 条目，然后试着在其他浏览器中销毁该条目。