构建执行插入、更新和删除操作的Web应用程序(上)

本教程介绍了如何使用具备Web功能的NetBeans IDE构建一个可以创建、检索、更新和删除数据库行的Web应用程序。该应用程序提供一个主数据的下拉列表以及一个同步的详细信息表。该 应用程序的用户可以在详细信息表及其关联数据库中添加、更新和删除记录。

本教程使用了其他基础教程中介绍的一些概念。如果您不具备 IDE 及其设计组件的基本知识，可以考虑首先阅读一些入门教程，比如Visual Web JSF应用程序开发入门和使用Databound组件访问数据库。

预计时间：45 分钟

目录

-       创建项目

-       添加插入功能

-       修改页面以保存行集

-       添加删除功能

-       添加恢复功能

-       结束语

本教程将使用以下技术和资源

JavaServer Faces组件/ Java EE 平台	1.2/Java EE 5* 1.1/J2EE 1.4
Travel 数据库	必需

* 为了利用NetBeans IDE的Java EE 5功能，可以使用完全与Java EE 5规范兼容的应用程序服务器，比如Sun Java Application Server 9/GlassFish。

本教程专门适用于GlassFish v2应用程序服务器。如果您使用的是其他服务器，请参考发行说明和常见问题解答了解已知问题和解决方法。有关支持的服务器和Java EE平台的详细信息，请参阅发行说明。

创建项目

在本教程中，我们将创建一个单页的Web应用程序。您可以先从设计页面布局入手，该页面包含一个人名及其相应的行程，

设计页面

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列执行同样的操作，

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

7.   单击OK按钮。

8.  单击Visual Designer工具栏中的Show Virtual Forms按钮 ，

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

配置表

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.     单击Options选项卡，将Title 改为Trips Summary，然后单击OK按钮。

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

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

这将打开SQL Query Editor。

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

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

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

9.   关闭tripRowSet的SQL编辑器。

更改Column组件

现在，将列内容更改为可编辑的字段，以准备实现将新行程插入到数据库中的功能。执行此操作时，可通过在Table组件中嵌套其他组件以利用其复合特性。

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

将打开Table Layout对话框。

2.              在Columns选项卡中，从右侧的Selected列表中选择TRIP.DEPDATE。在对话框底部的Column Details区域，将Component Type从Static Text更改为Text Field，

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。

为表配置虚拟表单

接下来，为表中的输入组件创建一个虚拟表单。通过使用虚拟表单，可以确保在更改personDD下拉列表后提交此页时，不会对输入组件进行验证和转换。用户无论何时从下拉列表中选择新人员，都会在表中显示正确的信息。

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，

添加事件和初始化代码

现在，将personDD personDD Drop Down List和Table组件关联起来，以实现以下行为：当用户从列表中选择某人时，表中则会显示出此人的行程。

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);        }    }

 

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

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

5.              在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);            }        }    }

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

测试应用程序：第1部分

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

添加插入功能

在此部分，我们将通过在数据库中插入行集，实现将行程添加到表中的功能。首先，为Table的Text Field提供Message组件。这些组件可确保当用户输入错误信息时可以看见错误。然后，在页面中添加一个按钮，以便用户可以通过它将新行添加到数据缓冲区中。

1.   单击Design按钮以便在Visual Designer中查看Page1。

2.   在Palette的Basic区域中，将Message组件分别拖放到Table的前三列每列的最顶层Text Field中。

3.   选择第一个Message组件。在Properties窗口中，滚动至for属性，并从下拉列表中选择textField1选项。只有当Message与Text Field正确关联时，Message文本才会显示关联信息，如图11所示。

4.   将第二个Message组件的for属性设置为textField2。

5.  将第三个Message组件的for属性设置为textField3。

6.   在Palette的Basic区域，将一个Button组件拖到Page1中并将其放在靠近第二列顶端的Table组件的上面，如图12所示。

特别注意：在IE7中有一个影响JSF 1.2 Button组件宽度的已知问题。解决方法是将Button组件放在布局组件（Grid Panel、Group Panel 或 Layout Panel）的上面。重设布局组件的大小会自动重设Button组件的大小。

7.   将文本从Button更改为Add Trip。

8.   在Properties窗口中，将按钮的id属性更改为add。

9.   在Visual Designer中，双击按钮以打开Java Editor，插入点将位于该按钮的add_action事件处理程序方法中。

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

代码示例 3：添加行程操作的代码

public String add_action() {         try {             RowKey rk = tripDataProvider.appendRow();             tripDataProvider.setCursorRow(rk);             tripDataProvider.setValue("TRIP.TRIPID", new Integer(0));             tripDataProvider.setValue("TRIP.PERSONID", personDD.getSelected());             tripDataProvider.setValue("TRIP.TRIPTYPEID", new Integer(1));         } catch (Exception ex) {             log("Error Description", ex);             error(ex.getMessage());         }         return null;     }

11. 在Java编辑器中单击鼠标右键，然后选择Fix Imports选项以解决“未找到 RowKey”的错误。

        IDE会将下包添加到导入语句的Page1.java段：

        import com.sun.data.provider.RowKey;