1. 序
此文档适应 Sun JDK 1.4.2, Eclipse 3.0.1 and MyEclipse 3.8.2. 环境。所有的屏幕截图都是基于 Eclipse, MyEclipse Enterprise Workbench, and Windows XP 的默认用户接口设置。如果你在使用这个文档的过程中遇到困难，请看用户反馈部分，以反馈给 MyEclipse documentation team 。
2. 说明
在这个用户指南中我们将通过 MyEclipse Enterprise Workbench 来开发和测试一个简单的 Struts 示例应用。这并不需要我们具有 Struts 或者 MyEclipse 的预备知识。
3. 必备工具
JDK 1.4+ (Sun or IBM)
http://java.sun.com/j2se/downloads/index.html
Eclipse 3.0.x SDK
http://www.eclipse.org/downloads/index.php
MyEclipse 3.8.2
http://www.myeclipseide.com/ContentExpress-display-ceid-10.html
Tomcat 5.0.x ( 首选 5.0.28 P referred, 或其他 Servlet/EJB 容器 )
http://apache.xtelli.net/jakarta/tomcat-5/v5.0.28/bin/jakarta-tomcat-5.0.28.exe
4. 构造一个新项目
为了有效的组织我们的开发，我们需要在添加了 Struts Capabilities 的 MyEclipse 中创建一个新的 Web Module Project 。 你可以创建一个 web project 通过菜单 File > New > Other > Project > J2EE > Web Project ，如下图所示
图 1--- 新建 Web Project 对话框
然后键入关于新项目的所有信息 ，如下图：
图 2 ---- 设置 Web Project
一旦创建了 Web Project ，我们需要为 MyEclipse 添加 Struts Capabilities 。这可以通过右击 Package Explorer 视图中 项目的名称，并且依次选择 MyEclipse > Add Struts Capabilities 做到。如下面图示：
图 3 ：在 Web Project 中 添加 Struts Capabilities
对这个应用来说， Struts 对话框的默认值已经很适合了。但是，你可以改变 Base package for new classes 来适应你的情况。如下图 4 所示，我们只是简单的保留这些默认值。
图 4---- 配置 Struts Capabilities
当完成上面的步骤，项目的结构会如下图 5 所示
图 5 ---- 配置后的项目结构视图
现在我们已经成功地创建完项目，然后可以开始构建 web 的内容了，现在转入下一步。
5. 开始一个 Struts 项目
这一部分我们将要集中创建一个 Struts 应用示例，这个实力是在模仿一个简单的网站登录屏幕。所以，仅需要 2 个 Jsp 页面，一个提示用户登录，另一个简要的说明登录成功。我们分别命名这 2 个 jsp 页面为 userLogin.jsp 和 userL oginSuccess.jsp 。 如果用户试图登录时存在授权错误，将直接指导用户返回 LoginUser.jsp 并且显示错误信息。
一般来说，当开始一个 Struts 项目的时候，设计好应用的流程是很有用的。这样，开发团队就会对项目中所有元素的组合有一个更好的认识。创建流程最容易的方法就是通过使用 Struts 图形化设计模式。 Struts 编辑器提供了一个可以拖放工具，它可以使你通过快速的复制页面流程来构造应用。这个应用示例 Login 的流程就如下图 6 所示
图 6 ----- 应用程序的流程
我们可以从上面的设计视图中看到此应用开始于 userLogin.jsp 页面的显示。此登录页将要调用 userLogin 动作（ action ）来执行用户的登录操作。如果出现验证错误或问题， userLogin action 将引导用户返回 userLogin.jsp 页面。然而，如果登录成功，应用将转向 userLoginSuccess.jsp 页面。
5.1 Struts 项目的组件
一个典型的 Struts 项目会包括以下组件
JSPs
Actions
ActionForwards*
ActionForms**
Struts 部署文件 : struts-config.xml
在 MyElcipse 中可以通过 3 个不同的方法创建所有组件或者其中一个组件（除了 struts-config.xml ）
方法 1 ：使用菜单 File > New > Other... > J2EE > Struts 1.1 (or 1.0) ， 如下图：
图 7
对话框将直接引导你并且提示你所有被 Struts 组件支持的值。一些部件要比其他的复杂。例如：如下图 8 所示的对话框，你可以看到 Struts Action 支持的所有特征已经被赋予了容易理解的值
图 8----- 对话框：创建新的 Struts Action
方法 2 ：使用 Outline 视图。从此视图中，你可以通过右击任何一个组件类型弹出菜单来创建此类型的新组件。图 9 如下：
图 9----Outline 视图
方法 3 ： Struts 图形化编辑器（如下图 10 ）也是一个创建 Struts 组件的方便之路。打开 struts-config.xml 文件，单击编辑器下面的 Design 标签就可以打开 Struts 图形化编辑器
图 10----- 打开 Struts 图形化编辑器：
然后转到如下图 11 所示的编辑模式界面：
图 11 ----- Struts 图形化设计模式视图
现在我们已经知道怎么创建 Struts 部件的不同组件了，我们可以创建 Login 应用的不同部分了。下面接着来
5.2 搭建应用程序
我们通过集中创建 Jsp 页面来开始搭建示例应用。既然我们的应用模拟某个网站登录界面，那么仅需要 2 个 jsp 页面： userLogin.jsp 和 userLoginSuccess.jsp 。像大多数 Struts 应用程序一样，如果再登录过程发生错误，将引导用户回到 userLogin.jsp 并提示出错（我们并不需要一个专门的出错页面 userLoginFailure.jsp ）。
首先，创建 userLoginSuccess.jsp 。看起来像是首先创建最后的页面，这样做的目的是我们可以利用 New Form, Action and JSP 来创建 userLogin.jsp, 这个页面关联 Action 和 ActionForm 。
下图 12 就是开始在 Struts 设计模式下创建 userLogin.jsp
图 12---- 创建 jsp 页面
在点击后，系统将提示图下图 13 所示的对话框
注意：一定要选 Standard JSP using Struts 1.1
图 13---- 配置 userLoginSuccess.jsp
在单击 Finish 之后，设计试图上显示最新创建的页面。如下图 14
图 14
要完成这个 jsp 页面就只剩输出那些告知用户已经成功登录的信息了！下面给出了 userLoginSuccess.jsp 的源代码：
|
userLoginSuccess.jsp
|
|
<%@ page language= "java"%>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-bean" prefix="bean" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-html" prefix="html" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-logic" prefix="logic" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-tiles" prefix="tiles" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-template" prefix="template" %>
<%@ taglib uri="http://jakarta.apache.org/struts/tags-nested" prefix="nested" %>
<!DOCTYPE HTML PUBLIC "-//W 3C//DTD HTML 4.01 Transitional//EN">
<html:html locale="true">
<head>
<title>My Struts 'userLoginSuccess.jsp' ending page</title>
</head>
<body>
Hello <bean:write name="userName" scope="request" />, you successfully logged in!
</body>
</html:html>
|
这个页面很简单。我们唯一要做的事情 <body> 标签的内容：输出变量 userName 的值，这个变量 userName 是存储在此应用请求过程中。所以，在随后要创建的 action 中，需要我们放置一个 userName 属性在请求过程中。
此刻，我们还要创建 userLogin.jsp ， ActionForm 和 Action 。看起来工作量不少啊，但是 MyEclipse 可以通过 New Form and New Form, Action and JSP 对话框 方便的创建他们。
继续构建这个应用，右击 Struts designer 画布的空白处。选择 new ，接着选择 New Form, Action and JSP 如下图 15 所示：
图 15------- 启动 New Form, Action, JSP
首先出现的是： New Form 对话框。一定要输入 user case 名称。下图 16 展现了你将要填写的 user case 名称 的值
图 16
下面我们将要添加 2 个表单属性： userName 和 password 。当添加 password 域时，选择 JSP input type 为 password 。如图 17 所示：
图 17 ----- 为表单添加属性
图 18 -----Form 属性
在单击 Next 前，一定要单击 JSP 标签并如下图 19 一样操作。
图 19
最后我们单击 Methods 标签，不要选择任何方法。如下图 20
图 20
单击 Next 按钮后，出现 New Action 对话框，你可以看到已经为你填写了大多数的值。图 21 就是这个对话框的截图。如下：
图 21
你可以单击 Forwards 标签来指定 ActionForwards 。如下图 22
图 22
在为这个 action 添加完 Forwards 后，单击 Finish 按钮。 MyEclipse 会创建资源并更新 struts-config.xml 文件。图 23 展示了更改后的结构。
图 23
现在系统的流程已经被却确定，我们需要为这个 Action 添加逻辑来控制 登录流程。通过双击可以快速的跳转到任何资源。就像下图 24 展示的一样
图 24
当你第一次打开 UserLoginAction.java 的时候，为 execute （）方法自动生成的代码如下：
|
UserLoginAction.java
|
|
public ActionForward execute(
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response) {
UserLoginForm userLoginForm = (UserLoginForm) form;
throw new UnsupportedOperationException(
"Generated method 'execute(...)' not implemented.");
}
|
修改 userLoginAction.java 的 execute （）方法后如下：
|
UserLoginAction.java
|
|
public ActionForward execute(
ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response) {
UserLoginForm userLoginForm = (UserLoginForm) form;
if(userLoginForm.getUserName().equals("myeclipse") && userLoginForm.getPassword().equals("myeclipse"))
{
request.setAttribute("userName", userLoginForm.getUserName());
return mapping.findForward("success");
}
return mapping.findForward("failure");
}
|
这里我们做了很简单的事情，仅仅检验 userName 和 password 是不是都为 myeclipse 。如果是，存储 userName 在请求过程中，并转向： success ，因此 userLoginSucces.jsp 会显示出个人化的信息。否则，出错后将要转向 failse 。在实际应用中，你应该添加 ActionMessages 或者 ActionErrors 集合一解释发生了什么事情。
6. 运行
现在应用程序已经完成，我们要把它部署到 Tomcat5 。打开 Package Explorer 视图并且右击项目，然后依次选择 MyEclipse > Add and Remove Project Deployments 或者单击工具条的 Deploy J2EE Project to Server 按钮。如下图 25
图 25
完成部署后检测部署状态来确保正确部署。你可以按照图 26 做
图 26
最后按照图 27 来启动 Tomcat 来使用应用服务器
图 27
服务器启动的时候， Eclipse 的 Console 视图会显示启动状态。如图 28
图 28
当 Tomcat5 运行起来，我们就可以通过 MyEclipse 的 Browser 视图来测试示例应用了。选择菜单 Window > Show View > Other... 截图如下图 29 所示
图 29
在地址栏中输入网址，如下图所示
图 30
说明程序能正常运行。按照下图 31 输入 userName 和 passwod
图 31
登录以后，我们被引导到成功登录界面。如图 32
图 32
7. 总结
在这个示例中，我们通过 MyEclipse Enterprise Workbench 提供的 Struts 工具开发了一个简单的 Struts 应用。
我们可以看大 MyEclipse 带给我们益处：高效，方便