执行插入、更新和删除操作

设计页面

1. 创建一个名为 InsertUpdateDelete 的新 Web 应用程序，该程序使用 Visual Web JavaServer Faces 框架。该应用程序的 Page1.jsp 文件会在 Visual Designer 中打开。
2. 从 Palette 的 Basic 区域拖动一个 Drop Down List 组件到页面的左上角。在 Properties 窗口中，将其 id 属性更改为 personDD。

3. 从 Basic Palette 中拖动一个 Message Group 组件到页面中，并将其放置在下拉列表的右侧。

   该 Message Group 组件可用来显示验证错误和转换错误，并且可以显示由 info 和 error 方法写入到 Java Server Faces 上下文的消息。如果需要调试项目，这些消息将会非常有用。
4. 将一个 Table 组件放置在这两个组件的下方。

配置下拉列表

1. 打开 Services 窗口，展开 Databases 节点，连接到 Travel 数据库。

   如果 TRAVEL 数据库的 jdbc 节点标记显示为连接中断 ，并且无法展开该节点，则表明 IDE 未连接到该数据库。要连接 TRAVEL 数据库，请右键单击 TRAVEL 数据库的 jdbc 节点，然后从弹出菜单中选择 Connect 选项。如果出现 Connect 对话框，请输入 travel 作为口令，选中 Remember Password，然后单击 OK 按钮。如果看不到 TRAVEL 数据库的 jdbc 节点，请参见 NetBeans 数据库连接常见问题解答 了解如何为 IDE 提供可用的数据库。 注意： 如果您使用的是 Apache Tomcat，请将 derbyClient.jar 文件复制到 <tomcat_install>/common/lib 目录，然后再尝试连接数据库。

2. 展开 TRAVEL 数据库的 jdbc 节点，然后展开 Tables 节点。

   注意： 在本教程的其余部分中，我们将 TRAVEL 数据库的 jdbc 节点称为 Travel 节点。

3. 将 PERSON 节点拖动到 Visual Designer 中的下拉列表上。

   Navigator 窗口的 Page1 部分中将显示 personDataProvider 节点，SessionBean1 部分中将显示 personRowSet 节点。

4. 右键单击 Drop Down List 组件，并从弹出菜单中选择 Auto-Submit on Change 选项。

   此设置使得每当您从列表中选择新值时，就会将该页面发送到服务器。

5. 右键单击该下拉列表，并从弹出菜单中选择 Configure Virtual Forms 选项。

   在出现的对话框中，请注意 personDD 显示在窗口的左上角，这表明下拉列表已被选定。

6. 单击 New 按钮并在 Name 列中键入 person。双击 Participate 列下面的字段，将其设置为 Yes，然后对 Submit 列执行同样的操作，如下图所示。

   图 2：Configuring Virtual Forms

   
   通过使用虚拟表单，应用程序可避免对 Table 中的数据进行不必要的验证。
7. 单击 OK 按钮。

8. 单击 Visual Designer 工具栏中的 Show Virtual Forms 按钮 ，如图 3 所示。

   通过查看虚拟表单，您可以查看 Visual Designer 中的组件与您已经配置的任何虚拟表单之间的关系。

   图 3：Showing Virtual Forms

配置表

1. 将 Services 窗口中的 Travel > Tables > TRIP 节点拖动到 Visual Designer 中的 Table 组件上。

   如果提示选择接收该节点的目标组件，则选择 table1 并单击 OK 按钮。

2. 右键单击 Table 并从弹出菜单中选择 Table Layout 选项。

   Table Layout 对话框会显示您刚创建的 tripDataProvider 中可用的字段，并允许您控制要在表中显示哪些字段。

3. 使用 < 按钮从右侧的 Selected 列表中删除 TRIP.TRIPID、TRIP.PERSONID 和 TRIP.LASTUPDATED，如下图所示。

   图 4：将表绑定到数据提供程序

4. 单击 Options 选项卡，将 Title 更改为 Trips Summary，然后单击 OK 按钮。

5. 现在，可视设计器中的 Table 组件应如下图所示。注意：如果未按下图顺序显示各列，可通过重新打开 Table Layout 对话框，单击 Columns 选项卡，并使用 Up 和 Down 按钮来重新排列它们。

   图 5：Page1 表布局

6. 在 Navigator 窗口中，右键单击 SessionBean1 下面的 tripRowSet，并从弹出菜单中选择 Edit SQL Statement 选项。

   这将打开 SQL Query Editor。

   图 7：添加查询条件

7. 在窗口中心附近的网格区域，右键单击 PERSONID 行并选择 Add Query Criteria 选项，如下图所示。

8. 在 Add Query Criteria 对话框中，将 Comparison 下拉菜单设置为 =Equals 并选择 Parameter 单选按钮，然后单击 OK 按钮。

   图 7：Add Query Criteria 对话框

   
   字符“=?”将出现在 PERSONID 的 Criteria 字段中，并且条件“WHERE TRAVEL.TRIP.PERSONID=?”会出现在编辑器底部的 SQL 窗格中的 SQL 语句的结尾。
9. 关闭 tripRowSet 的 SQL 编辑器。

更改 Column 组件

1. 右键单击 Table 组件并选择 Table Layout 选项。

   将打开 Table Layout 对话框。

2. 在 Columns 选项卡中，从右侧的 Selected 列表中选择 TRIP.DEPDATE。在对话框底部的 Column Details 区域，将 Component Type 从 Static Text 更改为 Text Field，如下图所示，然后单击 Apply 按钮。

   图 8：更改列的外观

3. 对 TRIP.DEPCITY 和 TRIP.DESTCITY 执行同样的操作。
4. 在 Selected 列表中选择 TRIP.TRIPTYPEID，并将 Component Type 从 Static Text 更改为 Drop Down List。
5. 单击 OK 按钮。

6. 将 Travel > Tables > TRIPTYPE 节点拖放到 Table 组件中的 Drop Down List 上。如果 Choose Target 对话框打开，选择 dropDown1 选项并单击 OK 按钮。

   此操作将创建 triptypeDataProvider。

为表配置虚拟表单

1. 在 Visual Designer 中，按住 Ctrl 键的同时在表中单击，以选择包含文本字段的三个列中的三个 Text Field 组件以及 TRIPTYPEID 列中的 Drop Down List 组件。
2. 右键单击其中一个选定的组件，并从弹出菜单中选择 Configure Virtual Forms。
3. 在 Configure Virtual Forms 对话框中，请确保窗口的左上角列出了三个 Text Field 和 Drop Down List。如果未按下图所示的方式列出这些内容，请关闭对话框，重新选择它们，然后再试一次。如果已正确列出这些内容，则单击 New 按钮。

4. 将新虚拟表单的名称更改为 save，将 Participate 设置更改为 Yes，如下图所示，然后单击 OK 按钮。

   图 9：为表元素配置虚拟表单

添加事件和初始化代码

1. 双击 personDD Drop Down List 以创建一个值更改事件方法，并在该方法上打开 Java Editor。

2. 在 personDD_processValueChange 方法中，添加 Code Sample 1 中的粗体文本，然后按下 Alt-Shift-F 组合键以重新设置代码格式。

   代码示例 1：下拉列表事件处理程序

   public void personDD_processValueChange(ValueChangeEvent event) { Object selectedPersonId = personDD.getSelected(); try { personDataProvider.setCursorRow( personDataProvider.findFirst("PERSON.PERSONID", selectedPersonId)); getSessionBean1().getTripRowSet().setObject(1, selectedPersonId); tripDataProvider.refresh(); form1.discardSubmittedValues("save"); } catch (Exception e) { error("Cannot switch to person " + selectedPersonId); log("Cannot switch to person " + selectedPersonId, e); } }

   
   

   位于 try 子句结尾处的 form1.discardSubmittedValues("save") 语句可确保每当用户从下拉列表中选择新的人员时，将使用与所选人员相关的新信息替换表中所显示的当前行程信息。注意表格中显示旅程信息的所有用户界面元素都参与名为 save 的虚拟表单。

   另外，该事件处理器不会抛出异常。而是把它们记录到 server.log 文件。该事件处理器也会调用 error 方法，当出现错误时，该方法会在 Message Group 组件中显示一条错误消息。

3. 在 Java 源代码中滚动至 prerender 方法，或者（如果您愿意）使用 Ctrl-F 查找 prerender。将下面以 粗体 显示的代码添加到该方法中。

   代码示例 2：Prerender 方法

   public void prerender() { if ( personDD.getSelected() == null ) { Object firstPersonId = null; try { personDataProvider.cursorFirst(); firstPersonId = personDataProvider.getValue("PERSON.PERSONID"); personDD.setSelected(firstPersonId); getSessionBean1().getTripRowSet().setObject( 1, firstPersonId); tripDataProvider.refresh(); } catch (Exception e) { error("Cannot switch to person " + firstPersonId); log("Cannot switch to person " + firstPersonId, e); } } }

4. 在 Java Editor 中单击右键，然后选择 Format 以使代码正确对齐。

测试应用程序：第 1 部分

单击主工具栏上的 Run Main Project 按钮  以生成、部署和运行项目。当 Web 浏览器呈现此页面时，您会看到一些名字填充了下拉列表，并且表也由一些数据进行了填充。当您从列表中选择某个名字时，与该名字相关的旅程就会显示在表格中。

图 10：部署的应用程序，测试 1

测试应用程序：第 2 部分

通过单击 Run Main Project 按钮  以生成、部署和运行项目。当 Web 浏览器呈现此页面时，将显示 Add Trip 按钮，如下图所示。每次单击该按钮时，都会在表的底部附加一个新的空行。可以编辑行中的信息，但由于尚未提供行集的保存机制，因此，从下拉列表中选择其他名字时，所做的更改将会丢失。

图 12：部署的应用程序，测试 2

将用户更改保存到数据库

1. 在靠近第一列顶部的 Table 组件上放置一个 Button 组件。为了准确定位，可以参考 图 15 中的 Save Changes 按钮。
2. 将按钮文本从 Button 更改为 Save Changes。
3. 在 Properties 窗口中，将 id 属性更改为 save。
4. 右键单击 Save Changes 按钮，并从弹出菜单中选择 Configure Virtual Forms 选项。
5. 在 Configure Virtual Forms 对话框中，请确保 save 显示在左上角的列表中，这样您在此窗口中的更改可以应用到 Save Changes 按钮中。然后，选择 save 虚拟表单，将 Submit 值更改为 Yes，并单击 OK 按钮。
6. 在 Visual Designer 中，双击 Save Changes 按钮以打开 Java Editor。在 Java Editor 中，插入点将位于该按钮的 save_action 事件处理程序方法中。

7. 将下面以粗体显示的代码添加到该按钮的事件处理程序方法中：

   代码示例 4：保存操作代码

   public String save_action() { try { // Get the next key, using result of query on MaxTrip data provider CachedRowSetDataProvider maxTrip = getSessionBean1().getMaxTripDataProvider(); maxTrip.refresh(); maxTrip.cursorFirst(); int newTripId = ((Integer) maxTrip.getValue("MAXTRIPID")); // Navigate through rows with data provider if (tripDataProvider.getRowCount() > 0) { tripDataProvider.cursorFirst(); do { if (tripDataProvider.getValue("TRIP.TRIPID").equals (new Integer(0))) { tripDataProvider.setValue("TRIP.TRIPID", new Integer(newTripId)); newTripId++; } } while (tripDataProvider.cursorNext()); } tripDataProvider.commitChanges(); } catch (Exception ex) { log("Error Description", ex); error("Error :"+ex.getMessage()); } return null; }

测试应用程序：第 3 部分

通过单击 Run Main Project 按钮以生成、部署和运行项目。应用程序将可以实现以下功能：

• 可以添加行程并进行保存。然后，该行程将显示在表中并持续存在。如果选择其他人员，然后返回到此人员，则会看到所添加的行程。
• 可以编辑现有的行程信息，并保存所做的更改。
• 如果在 Date 字段中输入除日期之外的内容，应用程序将提供一条错误消息。
• 在保存之前您可以多次单击 Add Trip 按钮，这是一次添加多行的简便方法。如果在保存更改时任何行仍然为空，则会将其保存为空行。
• 如果在单击 Save Changes 之前您切换到其他人员，则会丢失所有更新。
• 如果修改了某些值，然后单击某个列标题以按该列进行排序，则 Table 组件会记住这些暂挂的更改，随后可以保存这些更改。

向每行添加一个 Delete 按钮

1. 单击编辑器窗口中的 Design 以返回 Visual Designer 中的 Page1，然后右键单击 Trips Summary 表，并从弹出菜单中选择 Table Layout 选项。

   这将打开 Table Layout 对话框。
2. 如有必要，单击 Columns 选项卡，然后单击 New 按钮，将一个新列添加到表中。

3. 在 Selected 列表中选择新列的名称后，在 Column Details 区域中进行以下更改：

   1. Header 和 Footer Text：删除 Header 和 Footer 文本字段中的任何默认文本，使其保持空白。
   2. Component type: Button
   3. Value Expression: Delete
   4. Width: 删除任何缺省值，使其保持空白。
   5. Horizontal Align: Center
   6. Vertical Align：Middle
   7. 单击 OK 按钮。
4. 选择表中最上面的 Delete 按钮，然后在 Properties 窗口中，将 id 属性设置为 delete。

添加事件代码

1. 双击 Delete 列中的第一个按钮，以在 delete_action 事件处理器方法中打开 Java Editor。

2. 将下面以粗体显示的代码添加到该按钮的事件处理程序方法中：

   代码示例 5：删除操作代码

   public String delete_action() { form1.discardSubmittedValues("save"); try { RowKey rk = tableRowGroup1.getRowKey(); if (rk != null) { tripDataProvider.removeRow(rk); tripDataProvider.commitChanges(); tripDataProvider.refresh();} } catch (Exception ex) { log("ErrorDescription", ex); error(ex.getMessage()); } return null; }

测试应用程序：第 4 部分

通过单击 Run Main Project 按钮以生成、部署和运行项目。下图显示了该运行应用程序。

部署后，您应该可以从表中删除行，进而将其从数据库中删除。删除操作还会将所有待定更改提交到数据库。

图 15：测试应用程序，第 4 部分

添加 Revert Changes 按钮

1. 单击编辑器窗口中的 Design 以返回到 Visual Designer 中的 Page1，然后从 Palette 中拖一个 Button 组件到 Page1。将该新 Button 放在 Add Trip 按钮的右侧。
2. 将按钮文本更改为 Revert Changes。
3. 在 Properties 窗口中，将该 Button 组件的 id 属性更改为 revert。
4. 双击 Revert Changes 按钮以在 revert_action 方法中打开 Java Editor。

5. 将下面代码样例中以粗体显示的代码添加到 revert_action 方法中。

   代码示例 6：恢复操作代码

   public String revert_action() { form1.discardSubmittedValues("save"); try { tripDataProvider.refresh(); } catch (Exception ex) { log("Error Description", ex); error(ex.getMessage()); } return null; }

配置虚拟表单

如果应用程序使用目前的配置，则会出现一些不理想的行为。例如，如果用户在现有行的第一列中输入无效日期，然后单击 Add 按钮，操作将会失败，由于日期转换错误而拒绝提交表单。用户单击 Add 按钮时的理想行为是：放弃处理表中的输入字段，以便在忽略现有行的暂挂编辑内容的情况下添加新行。

同样地，当用户单击 Revert 按钮时（其目的是放弃所有编辑内容），也应该忽略以上情况的编辑内容。但是，当用户单击 Delete 按钮时，您仍然希望进行验证，因为此按钮不仅删除某个行，而且还会提交所有暂挂的更改，这要求先处理输入字段。

1. 在 Visual Designer 中，按 Ctrl 键的同时单击以选择 Add、Revert 和 Delete 按钮，单击鼠标右键，然后从弹出菜单中选择 Configure Virtual Forms 选项。

   在 Configure Virtual Forms 窗口中，add、revert 和 delete 应出现在左上角，表明这些按钮处于选定状态。

2. 在 Configure Virtual Forms 窗口中，单击 New 按钮，将该新虚拟表单命名为 add/revert/delete，然后将 Submit 设置为 Yes。单击 OK 按钮。

   图 16：为 Add、Revert 和 Delete 按钮配置虚拟表单

测试应用程序：第 5 部分

通过单击 Run Main Project 按钮  以生成、部署和运行项目。图 17 显示了该运行应用程序。

部署后，程序可执行以下功能：

• 从下拉列表中选择一个名字，并显示此人的行程摘要。
• 编辑现有的行程信息，并将更改保存到数据库中。
• 编辑具有不正确的日期格式的现有行程信息，然后单击 Add Trip 按钮添加新行，或者单击 Revert Changes 按钮放弃编辑。
• 在表中添加行，填写行程字段，并将更改保存到数据库中。
• 从表中（同时从数据库中）删除行。

• 放弃编辑内容，并恢复为数据库中最近保存的数据。

图 17：测试应用程序，第 5 部分