构建应用程序的客户机端

我们将使用 Struts 框架来对这个示例进行编码。WebSphere Studio Enterprise Developer 的 Struts 工具提供了下列向导：

向导	功能
Web project	功能已被扩展以创建一个带 Struts 支持的 J2EE Web 项目，或将 Struts 支持添加到现有的 J2EE Web 项目中
Struts Action	创建一个新的 Struts 操作
Struts Action Mapping	创建一个新的 Struts 操作映射
Struts ActionForm	创建一个新的 Struts 表单 bean
Struts configuration file	创建一个新的 Struts 配置文件
Struts module	创建一个新的 Struts 模块
JSP	功能已被扩展以创建一个基于 Struts － 或基于现有的表单 bean 的定义 － 的 JSP

现在可以使用这些向导来完成后面一系列的任务。为了帮助您，Enterprise Developer 提供了一个新的名为 Cheat Sheets 的超级向导（可看作上述所有向导的一个总的向导）来指导用户遍历整个开发过程，并为用户提供了一系列步骤来构建一个基于 Struts 的 Web 项目。

使用 Struts EGL Cheat Sheet

Cheat Sheet 是一个程序，它可以帮助您完成涉及一系列不同子任务的复杂任务。Struts EGL Cheat Sheet 可以创建使用 EGL 的基于 Struts 的 Web 应用程序。对于新手或任何喜欢这种附加指导的人来说，它能够提供很大的帮助。

要启动 Cheat Sheet，从菜单条单击 Help => Cheat Sheets。打开的级联菜单中列出了五种最常用的 Cheat Sheet。您也可以选择 Other...来打开一个对话框以选择其他 Cheat Sheet。Cheat Sheet 是以视图方式打开的。任何时候都只能打开并激活一个 Cheat Sheet，因此在打开一个新的 Cheat Sheet 之前将关闭任何已打开的 Cheat Sheet。被关闭的 cheat sheet 的完成状态将被保存。

一般来说，要使用 Cheat Sheet 来创建基于 Struts 的 Web 项目：

• 选择 Help => Cheat Sheets => Other... => Web Application With EGL CheatSheet。
• 这样就能打开“Cheat Sheet”对话框，然后您可以遵循下列步骤。
• 当您选择了 Click to perform 按钮（ ），它会运行一个工具（可以是一个向导），然后您就将使用那个工具。当您用完之后，下一步就会被自动突出显示并变为当前步骤。
• 如果当前步骤是一个人工任务，就将需要您来执行它并选择 Click to complete 按钮（ ）以转入下一步。
• 每个已完成的步骤的左页边距上都会有一个钩标记（ ）。

我们将要执行的一系列步骤（由 Cheat Sheet 指导）如下所示，在图 19 中所示的 Cheat Sheet 中也有。

1. 创建一个 Web 项目
2. Create a Web diagram
3. 创建 JSP（Web 页面）和 bean
4. 创建 Struts 操作
5. 实现业务逻辑组件
6. 生成并编译 EGL 组件
7. 运行 Web 应用程序。

图 19. 使用 EGL 的 Struts 的 Cheat Sheet 主要步骤

1. 创建一个 Web 项目

我们已经在前面创建了 Web 项目，因此您可以通过单击 Cheat Sheet 的 图标绕过这一步。

2. 创建一个 Web 图表

Web 图表是一个文件，它可以帮助您显现基于 Struts 的 Web 应用程序的流程结构。下面的表格按照对话框的顺序显示需要您输入值的字段：

对话框	字段	值	操作
创建一个 Web 图表	Folder name（输入或选择值）	EGLWeb/Java Source	Finish
	File name	EGLflow

Web 图表编辑器将会被打开。Web 图表的一个很有用的特性是底层资源的任何改变都会实时地在图中显现出来。在我们的示例中，您将可以在编辑器的自由格式表面（FFS）中为名为 index.jsp 、 result.jsp 和 error.jsp 的 Web 页面创建节点，而这些页面现在并不存在。我们将出现在 FFS 上还没有实现的节点称作未实现（节点）。当您在图表编辑器以外创建了该 JSP，在图表编辑器得知该 JSP 已被创建后，就会在其图中作出实时的改变。

同样，如果删除图中已实现部件的底层资源，在图表编辑器得知该删除（操作）后也将在图中作出相应的改变。您可以使用图表编辑器来展示全部（或部分）Struts 应用程序。您还可以直接与图中的部件进行交互。例如，您可以直接从图表编辑器中调用 JSP 编辑器。

使用图表编辑器：

1. 按照下表从 中拖放并命名各图标：
   

   组件	连接到…／从…连接	转发名称	作用域
   index.jsp （Web 页面节点）	inquiry		request
   result.jsp （Web 页面节点）	inquiry	valid
   error.jsp （Web 页面节点）	inquiry	invalid
   Inquiry （操作映射节点）	全部
   InquiryForm （表单 bean 节点）	inquiry

   
   
2. 现在，按下图所示拖放并连接各图标：
   
   图 20. 流程图
   
   
3. 用 Ctrl+S保存该图。
4. 通过选择位于工作台左端的 图标，返回“Cheat Sheet”对话框。

3. 创建 JSP（Web 页面）和 bean

这一步，您将定义并实现 JSP、操作查询以及与您的 Web 图表相关联的 bean。您可以选择 perform 按钮，这将会显示所要创建元素的列表，如图 21 所示。然后您可以双击每个元素来创建它。然而，如果您首先创建了表单 bean，那么向导就会根据您在那个表单 bean 中所指定的内容来创建 JSP 模型。创建表单 bean（ InquiryForm ）的步骤如下所示。

图 21. Cheat Sheet 选择列表

3.1 创建 InquiryForm

表单 bean（一种类型的 Java bean）是 ActionForm 类子类的实例，它既可以从提交的客户机请求中存储 HTML 或 JSP 表单数据，也可以存储来自用户选择的链接的输入数据。HTML 或 JSP 表单是由用于供用户输入信息的字段组成。

当浏览器提交 HTML 表单时，Struts ActionServlet 会进行如下操作：

• 查看 HTML 表单中各字段的名称。
• 将它们与表单 bean 中的属性名称进行匹配。
• 自动调用这些变量的 setter 方法以输入从 HTML 表单中检索而得的值。

此外，如果您实现了一个验证方法并在 Struts 配置文件中相应的操作映射条目上设置了验证标志，ActionServlet 将会调用那个验证方法。

我们可以在创建完 JSP 之后再创建表单 bean，但先创建表单 bean 会在生成 JSP 模型时对我们有所帮助。要创建表单 bean：

1. 双击 InquiryForm 。
2. 在“NewActionForm Class”对话框中，全部采用缺省值，然后选择 Next。
   
   图 22. 创建表单 bean
   
   
3. 在向导的“Choose new accessors”对话框中，选择 Next。
4. 在“New ActionForm class - Create new accessors...”对话框中，选择 Add...。
5. 输入 ID 和 name 的值，如图 23 所示。（按 Tab 离开 Type 栏以确保输入的值被接受。）现在，我们可以通过定义字段来利用 Struts 工具特性之一以创建这个 JSP，且所创建的 JSP 会用缺省布局来显示这些字段。
   
   图 23. 创建 ActionForm - accessors，改变类型
   
   
6. 选择 Finish生成 InquiryForm 。
7. 这样就创建了 InquiryForm Java 类并打开了编辑器。看一下生成的代码，您会看到其中已经创建了 ID 的 getter 和 setter 方法（ getID 和 setID ）、name 的 getter 和 setter 方法（ getName 和 setName ）以及一个 validate 方法。您可以用这个 validate 方法来验证您表单中的字段。
8. 关闭编辑器。

请注意：

• struts-config.xml 已被更新
• 该类被命名为 InquiryForm
• Struts 的表单 bean 被命名为 inquiryForm （其中 i 是小写的；小心，这可能造成混乱）。

生成的 xml 如下所示：

<form-beans>
<form-bean name="inquiryForm" type="forms.InquiryForm">
</form-bean>
</form-beans>

3.2 创建 error.jsp

要创建 error.jsp ：

1. 双击 error.jsp。
2. 全部采用缺省值，然后选择 Finish。
3. 使用编辑器和 Design 视图，输入错误消息： Error! Could be problems with Data Base connection. Check WebSphere Console.
4. 保存数据。结果如图 24 所示。

图 24. Error JSP

3.3 创建 index.jsp.

要创建 index.jsp ：

1. 双击 index.jsp。
2. 使用“New JSP File”向导，全部采用缺省值。
3. 选择 Next（五次）直至“Form Field Selection”对话框出现。
4. 在“Form Field Selection”对话框中，选择下列值（如图 25 所示），然后选择 Finish。
   • Form bean entry：选择 inquiryForm
   • 字段：ID
   
   
   图 25. 创建 index.jsp
   
   
5. Enterprise Developer 会自动创建带有 Struts 标记库引用以及被选中的 ID 字段的 index.jsp 。这样就会打开 JSP 并使它可供编辑。请注意生成的 JSP 中包含了选中的 ID 字段，如图 26 所示。
   
   图 26. 生成的 Index.jsp
   
   
6. 如图 27 所示改变文本。
   
   图 27. 修改后的 Index.jsp
   
   
7. 用 Ctrl+S保存您所作的改变并关闭编辑器。

3.4 创建 result.jsp

要创建 result.jsp ：

1. 双击 result.jsp。
2. 全部采用缺省值，然后选择 Finish。
3. Enterprise Developer 会自动创建带有 Struts 标记库引用的 result.jsp 。这样就可以打开该 JSP 并使它可供编辑，同时显示“Place result.jsp's content here”行。按照下列步骤替换该行。
4. 将该行的属性改为 Heading 2。
5. 按下 Enter在表单内获取新的一行。
6. 选择 Ctrl+T插入一张表。
7. 在“Insert Table”对话框中，选择 OK。
8. 这样就会显示一张 2x2 的表。将光标放在该表的第一行第一个单元格中，然后输入 USERID 。
9. 将光标放在第一行第二个单元格中（右上）。从菜单条中选择 JSP => Insert Custom...。
10. 在“Insert Custom Tag”对话框中，在文档中的 Tag 库中选择 /WEB-INF/struts-bean.tld。
11. 对于 Custom 标记，选择 write，然后选择 Insert。不要关闭这个窗口，因为您还会用到它。现在只是暂时离开这个窗口。
12. 在第二行第一个单元格中输入 NAME 。
13. 移到第二行第二个单元格。
14. 在“Insert Custom Tag”对话框中，在文档中的 Tag 库中选择 /WEB-INF/struts-bean.tld。
15. 对于 Custom 标记，选择 write，然后选择 Insert。
16. 选择 Close。
17. 从菜单条中选择 JSP =>Show Visual Custom Tags。这将取消对 Show Visual Custom Tags的选中，从而导致出现一个 bean:write 标记的按钮。
18. 将光标放在这张表的下面，按下 Enter，然后键入 Click here to return to the Index Page.
19. 选择您刚才输入的文本（突出显示整行），用鼠标右键单击，然后选择 Insert Link...
20. 在“Insert Link”对话框中，输入下列值：
    • Type： File
    • URL： index.jsp
    选择 OK。结果如图 28 所示。
    
    图 28. 完成后的 Result JSP
    
    
21. 选择编辑器底部的 Source标签。
22. 改变 struts 标记，如下所示：
    
    <bean:write name=" inquiryForm" property=" ID" />
    <bean:write name=" inquiryForm" property=" name" />尽管 Java 类的名称是 InquiryForm ，但请小心表单 bean 的名称却是 inquiryForm （首字母小写）。这两者很容易被搞混。编码改变的结果如图 29 所示。
    
    图 29. Result JSP 的源代码
    
    
23. 用 Ctrl+S保存您所作的改变。
24. 检查 Tasks 视图。应该没有 result.jsp 的错误。请解决那些仍然存在的错误（如果有）。请注意您还没有定义 /inquiry ，因此 Tasks 视图中会有一个警告。我们将在下一步中解决这个问题。
25. 关闭 result.jsp 编辑器。

至此，您已经创建了您将要用到的三个 JSP。请注意现在 EGLflow.gph 中这些 JSP 节点已经变为彩色的了，这表示它们已经被实现。如果“Select Web Pages”窗口仍然开着，请关闭它。

4. 创建 Struts 操作

Struts 操作是 Action 类子类的实例，用来实现一部分 Web 应用程序并返回一个转发。操作映射是一个配置文件条目，它将操作名称和操作、表单 bean 及本地转发关联在一起。

这一步您将定义并实现与 Web 图表相关联的 Action inquiry。您将在操作映射向导中调用 EGL 业务逻辑。使用 Cheat Sheet：

1. 选择 perform 图标（ ）。
2. 在 Select Action 对话框中，双击 on inquiry(Unrealized)。
3. 这样就会出现“New Action Mapping”向导。输入下列值，如图 30 所示：
   • Form Bean Name：选择 inquiryForm
   • Model：选择 EGL Struts Action
   选择 Next。
   
   图 30. 创建新的操作映射
   
   
4. 在“New Action Mapping - Create a EGL Struts Action”对话框中，选择 EGL Wrapper（如图 31 所示），然后选择 Next。
   
   图 31. 使用 EGL 创建新的操作映射
   
   
5. 在“New Action Mapping - Define data mappings”对话框中，输入或修改下列值：
   • 因为我们的 JSP 表单中只有一个输入字段，所以在 Input Mappings 中：
     • 使用 Add (form bean)按钮，输入 (short)iD
     • 使用 Remove按钮，除去 name 。
   • 使用 Add (reuse form bean)按钮，在 Output Mappings 中：
     • 输入 (short)id
     • 输入 (String)name
   由于这是在“Add a form bean mapping”弹出窗口中执行的，您可以在 Input 和 Output 中只选择 ID，选择 Add，然后为 name执行同样操作，然后选择 Done。结果如图 32 所示。
   
   图 32. 创建新的操作映射，定义数据映射
   
   
6. 选择 Finish。

请注意这样就创建了一个名为 InquiryAction.java 的类并且打开了编辑器。如果您愿意，您可以花一些时间去理解所生成的 Java 代码。转到 perform 方法，它是负责调用由 EGL 代码生成的 Java 类并把参数传给它们的方法。如果您想遵循执行逻辑，这也许是设置断点的一个好地方。您还会注意到 ID 字段通过工作存储（使用 Te01w01 生成的 Java bean）被发往生成的 EGL Java Wrapper（ Te01aWrapper ）。请参阅图 33 中的 perform 方法。

图 33. perform 方法

4.1 检查 Struts 转发

Struts 转发是由一个操作返回的对象，它有两个字段：一个名称和一个路径（通常是 JSP 的 URL）。其中路径是指将请求发往（或转发到）何处。转发可以是局部的（附属于一个具体的操作），也可以是全局的（对任何操作都可用）。

请确保在 InquiryAction 类的 perform 方法中正确地定义了转发。如果服务器程序中没有错误，那么转发就是 有效的；如果有错误，那它就是 无效的。

您将需要把无效转发的那一行移至正确的位置，如图 34 所示。

图 34. 定义了转发的 perform 方法

保存并关闭编辑器。至此 Struts 框架准备就绪。根据 Cheat Sheet 上的步骤，下一步将是实现业务逻辑组件（EGL）。

5. 实现业务逻辑组件

在这个步骤中，您将创建 EGL 程序来实现业务逻辑。因为我们发现在创建服务器程序时使字段定义能被重用更加容易，所以我们已经在 前面的步骤中完成了这个任务。然而，我们也可以选择在此处使用 EGL 向导来创建 EGL 源代码。

选择绕过按钮（ ）。

6. 生成并编译 EGL 组件

这一步，我们使用向导来生成 EGL 程序。由于我们已经生成了用 Java 代码写的 EGL 程序，也就是说这是另一个我们可以通过选择绕过按钮（ ）来绕过的步骤。

7. 运行 Web 应用程序

要运行应用程序：

1. 选择应用程序将运行哪个 WebSphere Application Server。单击 perform 图标（ ）来启动向导。
2. 设置下列值：
   • 文件夹：选择前面创建的 EGLWeb。
   • 应用程序服务器： WebSphere version 5.0 。您也可以使用已经定义的 WebSphere Application Server。
3. 这个代码是已发布的，并且 WebSphere Application Server 也启动了。当控制台显示了
   WSVR0001I: Server server1 open for e-business 消息，浏览器就会打开，并显示如图 35 所示的屏幕。
   
   图 35. 第一个 Web 屏幕
   
   
4. 为 Userid 输入值 30 ，然后选择 Submit。
5. 您的 WebSphere 控制台应该会列出一个错误（请参阅所有的红色消息），并应该显示 error.jsp ，如图 36 所示。
   
   图 36. 使用 error.jsp 的错误消息
   
   
6. WebSphere 控制台上的消息显示：
   VGJ0700E An error occurred during database connection: jdbc/SAMPLE.
   VGJ0005I The error occurred in TE01A.

出什么问题了？

生成的 EGL Java 代码使用 WebSphere 数据源来访问数据库。当我们在为 EGL 定义构建描述符时，我们指定了 jdbc/SAMPLE ，并且必须为 WebSphere 定义该 JNDI 名称。请注意很多与数据库相关的错误也可能是由 WebSphere 安全性问题（或糟糕的配置）所引起的。

尽管出现上述错误，但实际上 Struts 操作仍能正常工作，因为在这种情况下应用程序会返回一个无效的转发并正确地显示 error.jsp 页面。

7.1 定义 WebSphere 测试环境的数据源

根据 Sun JDBC 2.0 Standard Extension 规范中的定义，数据源允许您管理数据库的一个连接池。使用连接池能带给您下列好处：

• 它能提高性能。创建连接是非常消耗资源的；数据源会在自身被实例化后立即创建连接。
• 它能简化资源分配。这样就可以只在数据源中分配资源，而不是在代码中的任意地方。
• 相比较 JDBC 1.0 而言，它能简化连接调用。

数据源工作流程如下：

1. 当 servlet（或其他客户机）想要使用一个连接时，它会根据名称从 JNDI 服务器上查找一个数据源。
2. 然后，该数据源将一个连接返回给客户端。
3. 如果数据源没有多余的连接，它会向数据库管理器请求更多的连接（只要它没有超出最大连接数）。
4. 当客户端使用完连接之后，它就会关闭该连接。
5. 数据源随后将这个连接返回至可用池。

要定义数据源：

1. 在 Server Perspective 中，如果服务器在运行就停止它。
2. 在 Server Configuration 视图中，展开 Server Configurations文件夹，然后双击 WebSphere v5.0 Test Environment。
3. 选择编辑器底部的 Data Source标签。
4. 在“Data sources”对话框中，选择 Default DB2 JDBC provider。
5. 在“Data source defined”表中，选择 Add...旁的 JDBC provider list。
6. 在“Create a Data Source - Select the type...”对话框中，将数据源类型的值设置为： Version 5.0，然后选择 Next。
7. 在“Modify Data Source - Edit the settings...”对话框中，输入下列值：
   • Name： sample
   • JNDI 名称： jdbc/SAMPLE
   选择 Next。
8. 在“Create a Data Source - Edit the resource properties...”对话框中，输入下列值：
   • Name（在 Resource Properties 表中），选择 databaseName
   • Value： SAMPLE
   选择 Finish。您所作的改变应如图 37 所示。

图 37. 数据源配置

要再次运行应用程序，只要选择 EGLWeb/Web Content => index.jsp => Run on Server。在 Userid 中输入 30 ，然后选择 Submit。如果一切正常，您应该会看见如图 38 所示的内容。

图 38. 数据库中存在输入的 ID 时 Result.jsp 的运行情况

如果您输入了一个数据库中不存在的用户标识（比如 31 ），您就应该看到如图 39 所示的内容。

图 39. 数据库中不存在输入的 ID 时 Result.jsp 的运行情况

该程序可以被自然地扩展为显示适当的错误消息，我们在下一步将解释它。

7.2 扩展应用程序：使用应用程序资源属性文件

Struts 应用程序可以有选择地使用一个属性文件以保存文本。它允许您不必改变任何 Java 或 JSP 代码就能将改变应用到错误消息、按钮、标题、链接或其他任何文本字段上。它还可以使您轻松地将消息翻译为其他语言。向导会创建 ApplicationResources.properties 属性文件（如果您需要，可以在“Struts Settings”对话框中改变名称和包）。缺省情况下，向导会将文件放在指定的 Java 源包中，即放在 WEB-INF/classes 子目录中。

1. 编辑并改变 EGLWeb/JavaSource/eglweb/resources/ApplicationResources.properties 文件，如图 40 所示。

图 40. ApplicationResources.properties


小心，要改变的属性文件在 JavaSource 文件夹中，而不在 WEB-INF/classes ，因为每次进行项目构建时都会重新生成这个文件。

1. 改变 JSP 文件中的硬编码文本并用 <bean:message key=--/> Strut 标记来替换它们，并包含每一条具体的消息。您可以通过使用源或执行 JSP => Insert Custom?=> /Web-INF/struts-bean.tld => message =>Insert一系列步骤来实现它。在完成这些改变后， EGLWeb/Web Content/index.jsp 、 error.jsp 和 result.jsp 文件如下面三幅图所示。
   
   图 41. 带 bean 的 index.jsp：消息标记
   
   
   
   图 42. 带 bean 的 error.jsp：消息标记
   
   
   
   图 43. 带 bean 的 result.jsp：消息标记
   
   
2. 再次执行测试。结果将是相同的。假设您想要将应用程序翻译为巴西葡萄牙语，现在的好处是您只需改变 EGLWeb/Java Source/eglweb/resources/ApplicationResources.properties 文件就可以了。改变的结果如图 44 和 45 所示。
   
   图 44. 翻译为巴西葡萄牙语
   
   
   
   图 45. 翻译示例
   
   

结束语

祝贺您！您没有编写一行 Java 代码，就实现了一个使用 servlet、JSP 和 Java 的简单应用程序，它的服务器端是一个执行简单数据库查询的 Java 程序。您可以很容易地将这个非常简单的应用程序扩展为一个非常复杂的应用程序，但它们的编码、测试和调试的过程却是相似的。

当开发人员在 EGL 中进行编码时，他们不需要应付所有的细节问题，因为 EGL 会生成所有的连接器以使用必需的 Java 类，而这些 Java 类会在连接器生成时可用。EGL 为程序员提供了一种简单的方式，使得他们即使不具备实现 J2EE 通常所必需的所有技能，也能够进入复杂的 J2EE 世界。

本教程的第 2 部分将展示如何用 COBOL 服务器程序来实现这个应用程序。别走开！