手把手教你在Eclipse中配置开发Struts
原文地址:http://blog.csdn.net/baggio785/archive/2006/03/10/620535.aspx(转载请注明出处)
日期：2006-3-9
关键词：Eclipse，MyEclipse，Struts，Java
前言
本文根据实例详细介绍了如果在Eclipse中配置并开发Struts。此前在网上也看到过不少此类文章，而且还是有不少网友问此类问题。所以想根据自己的实际经验，并结合例子写一篇详细的文章，一个是方便大家，再一个也是检验一下自己的知识。
本文是偶的一些拙见，有不正确的地方请大家多多评论指正。
开发环境
JDK1_4_03，点击下载
tomcat5.0.28，点击下载
Eclipse3.1.2，点击下载；下载中文包,中文包是3.1.1，但是也适用3.1.2
MyEcilpse4.1，点击下载MyEcilpse4.1及破解补丁
TomcatPlugin插件，点击下载TomcatPlugin插件
更多Eclipse插件下载，点击进入
需求
本文所要结合的Struts应用实例为用户登录（logon），用户登录（logon）的需求为：
1 接收用户名和密码，跳转到成功页面，并提示“<username>欢迎您登录！”。
2 如果用户名为空就提交表单，则提示“请输入用户名！”。
3 如果密码为空就提交表单，则提示“请输入密码！”。
4 如果输入非法用户名，则提示“请输入正确的用户名！”。
5 通过模型组件，保存登录信息。
登录应用实例的框架介绍
用户登录(logon)应用由以下模块组成：
1 模型（M）：模型为一个JAVABEAN组件－SaveLogon，包含username（用户名）和userpassword（密码）两个属性，提供读取和设置属性的方法get/set，以及保存登录信息的方法saveToDb()。saveToDb的任务是把登录信息保存到持久化存储系统（例如数据库）。
2 视图（V）：视图包括两个JSP文件，以及一个ActionForm Bean－logonForm。JSP文件分别为：logon.jsp、success.jsp。logon.jsp负责接受用户输入的用户名和密码以及显示出错信息，success.jsp负责显示登录成功信息。
3 控制器（C）：控制器为Action类logonAction。对数据进行业务逻辑验证、调用模型组件保存登录信息、选择视图组件返回给用户。
Struts的工作机制
用户在视图组件（logon.jsp）中输入用户名和密码并提交HTML表单，Struts框架会先读取WEB.XML中关于servlet的配置，然后自动将表单数据封装到ActionForm Bean中，在本例中是logonForm。logonForm会对提交的数据进行数据合法性验证（例如最短长度、是否包含非法字符等）。如果ActionForm Bean验证未通过，则logonForm返回ActionErrors对象，Struts框架会把ActionErrors对象保存在request范围内，并把请求转发到视图组件，并在视图组件中通过<html:errors/>标签，展示request范围内的ActionErrors对象所包含的错误信息；如果通过ActionForm Bean验证，则logonForm返回的ActionErrors对象为NULL，Struts框架将表单数据提交到控制器组件logonAction，控制器对表单数据进行业务逻辑验证，如果logonAction验证未通过，则创建包含错误信息的ActionMessages对象，并通过saveErrors方法把ActionMessages对象保存到request范围内，并把请求转发到视图组件，并在视图组件中通过<html:errors/>标签，展示request范围内的ActionErrors对象所包含的错误信息；如果logonAction验证通过，则Struts框架访问模型组件，然后Struts框架会返回ActionFoward对象，并根据Struts-config.xml文件的配置情况，决定将ActionFoward对象包含的转发信息传递到那一个视图组件。
部署Struts框架
Struts的工作机制大家都有了一定的了解了，现在介绍如何在Eclipse中部署Struts框架。
本文的环境前文已经提到，Eclipse以及其插件MyEclipse和TomcatPlugin的安装本文不介绍，请参考其他文章。关于Eclipse的相关文章请看：http://blog.csdn.net/baggio785/category/148174.aspx。
1 新建一个项目
1） 选择Java >> Tomcat Project，下一步，如图一
（图一）
2）填写项目名称，如果不采用项目所在目录的缺省值，请修改，点击完成。如图二
（图二）
2 创建Struts框架
1） 右键选择项目 >> 新建 >> 其他 >> MyEclipse >> Web-Struts >> Struts 1.2 >> Struts 1.2 Form,Action & JSP。如图三。如果这一步出现错误，本文不做描述，请参考我的另一边文章－MyEclipse中创建Struts出现错误的解决办法。
（图三）
2） 配置Struts ActionForm
因为本文的Struts应用实例为用户登录，所以Use case选用logon。Superclass选择如图所示，其他默认。如图四
（图四）
接下来填写Optional Details，输入Form表单项，本例为用户名（username）和密码（userpassword）。点击Add，输入请参考图五、图六。
（图五）
（图六）
输后完毕，Optional Details的Form Properties中会显示。如图七
（图七）
Methods选项卡的设置我们采用默认设置，不去修改。
点击JSP选项卡，将“Create JSP form”选项的勾选中，采用默认设置“/form/logon.jsp”。如图八
（图八）
3） 配置Struts Action
以上步骤完成了对Form的配置，下面配置Action。
在图八中点击下一步，采用默认即可。如图九
（图九）
Parameter和Methods选项也采用默认。
点击Forwards选项卡，点击Add，配置成功页面信息。本文选取根目录的success.jsp作为成功页面，Name为logon_sc。如图十
（图十）
输后完毕，Optional Details的Forwards中会显示。如图十一
（图十一）
点击完成。
Struts已经配置完毕。看看Eclipse中，项目中多了一些东东，例如struts相关的jar，以及struts-config.xml和tld文件。struts-config.xml的代码如下：
代码清单一（struts-config.xml）
| <?xml version="1.0" encoding="UTF-8"?> <struts-config> <data-sources /> <form-beans > <!--这里是ActionForm的配置信息，ActionForm Bean的name为logonForm，对应的类为com.mystruts.struts.form.LogonForm--> <form-bean name="logonForm" type="com.mystruts.struts.form.LogonForm" /> </form-beans> <global-exceptions /> <global-forwards /> <action-mappings > <!--这里是Action组件的配置信息，描述了从特定的请求路径到响应的Action的映射--> <!--attribute设置Action关联的ActionForm在request或者session范围内的key.就是在request或者session共享内的名称--> <!--input指定包含表单的URL,当表单验证失败的时候发送的URL--> <!--name指定和该Action关联的Form名字.该名字必须是在form-bean中定义过的,可写可不写--> <!--path指定请求访问Action的路径，必须以/开头--> <!--scope指定Form的存在范围，例如request--> <!--type指定Action组件对应的类--> <action attribute="logonForm" input="/form/logon.jsp" name="logonForm" path="/logon" scope="request" type="com.mystruts.struts.action.LogonAction"> <!--这里是forward，即局部转发配置信息，登录成功后转向/success.jsp，name为logon_sc--> <forward name="logon_sc" path="/success.jsp" /> </action> </action-mappings> <!--这里是消息资源文件的配置信息，用来配置Resource Bundle.用于存放本地文本消息文件。parameter指定文件名，不包含后缀名。--> <message-resources parameter="com.mystruts.struts.ApplicationResources" /> </struts-config> |
创建消息资源文件
视图组件将使用标签来输出文本内容，这些内容来自于Resource Bundle。Resource Bundle对应消息资源文件。
代码清单二（ApplicationResources.properties）
| # 这里是注释 logon.username.error = 请输入用户名！ logon.userpassword.error = 请输入密码！ logon.badusername.error = 用户名不能为admin！ logon.baduserpassword.error = 密码不能为123456！ logon.success = 欢迎您登录！ |
为了实现国际化，消息资源文件中的汉字采用的是UTF-8编码。查看如何实现汉字转化为UTF-8。
创建JSP文件
logon.jsp（所在路径为/form/）接收用户输入的用户名和密码，并显示表单验证失败的错误信息。success.jsp显示登录成功的信息。
JSP文件全部使用客户化标签，无JAVA代码，输入的文本内容完全由标签提供。
代码清单三（logon.jsp）
| <%@ page contentType="text/html;charset=UTF-8" language="java"%> <%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html"%> <%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic"%>
<html> <head> <!--title使用客户化标签，文本内容对应的是消息资源文件中logon.page.title的值--> <title><bean:message key="logon.page.title"/></title> </head> <body> <html:form action="/logon" method="POST"> 用户名：<html:text property="username"/><html:errors property="username"/><br/> 密 码：<html:password property="userpassword"/><html:errors property="userpassword"/><br/> <html:submit value="登录"/><html:reset value="取消"/> </html:form> </body> </html> |
代码清单四（success.jsp）
| <%@ page language="java" pageEncoding="UTF-8"%> <%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html"%> <%@ taglib uri="/WEB-INF/struts-logic.tld" prefix="logic"%> <html:html lang="true"> <head> <html:base /> <title>success.jsp</title> </head>
<body> <logic:present name="savelogon" scope="request"> <bean:write name="savelogon" property="username"/> <bean:message key="logon.success"/> </logic:present> </body> </html:html> |
创建ActionForm Bean组件logonFrom
用户提交HTML表单后，Struts框架会自动把表单数据封装到ActionForm Bean（本例是logonForm）中。ActionForm Bean的属性必须与HTML表单的字段一一对应。ActionForm Bean会对表单数据进行验证，并提供将HTML表单的字段值重置为默认值的方法（等同于HTML中Form表单的Reset）。
代码清单五（logonFrom.java）
| package com.mystruts.struts.form; import javax.servlet.http.HttpServletRequest; import org.apache.struts.action.ActionErrors; /** // --------------------------------------------------------- Instance Variables /** userpassword property */ /** username property */ // --------------------------------------------------------- Methods /**
//如果用户名验证失败，将ActionMessage对象保存到ActionErrors对象errors中。logon.username.error对应消息资源文件中的logon.username.error的值。
//返回ActionErrors对象errors，Struts框架会把errors保存在request范围内，并将请求转发到视图组件logon.jsp中，通过<html:errors/>来显示错误信息 /** // TODO Auto-generated method stub /** /** /** /** } |
创建控制器Action组件logonAction
logonAction对表单数据进行业务逻辑验证。
代码清单六（logonAction.java）
| package com.mystruts.struts.action; import javax.servlet.http.HttpServletRequest; import org.apache.struts.action.Action; import com.mystruts.struts.SaveLogon; /** // --------------------------------------------------------- Instance Variables // --------------------------------------------------------- Methods /** //获得表单数据中的username //获得表单数据中的userpassword //定义非法用户名 //定义非法密码
if(badusername.equals(username)){ //如果用户名验证失败，将ActionMessage对象保存到ActionMessages对象errors中。logon.badusername.error对应消息资源文件中的logon.badusername.error的值。 //保存ActionMessages对象errors到request范围。 //返回ActionForward对象，Struts框架会把请求转发到视图组件logon.jsp中，通过<html:errors/>来显示错误信息。 if(userpassword.equals(baduserpassword)){
//清除request范围内的ActionForm Bean，因为后面的请求已经不需要了
} |
创建模型组件SaveLogon
本模型提供get/set方法，以及saveToDb方法。在例子中并未实现saveToDb方法。
代码清单七（SaveLogon.java）
| package com.mystruts.struts; /** private String username = null; public void setUsername(String username){ public String getUsername(){ public void setUserpassword(String userpassword){ public String getUserpassword(){ public void saveToDb(){ }
|
运行
如果用户名和密码为空，运行结果如图十二、图十三、图十四所示。
（图十二）
如果用户名为admin，运行结果如图十三
（图十三）
如果通过验证，运行结果如图十四
（图十四）
小结
1 为了降低偶合度，应该建立一个存放常量的JAVA文件。例如logonAction.java中的String badusername = "admin"，或者request.setAttribute("savelogon",sl)的第一个参数。
2 要实现Struts的国际化，支持多国语言，编码方式一定要为UTF-8。
3 在配置Action时，见图九，如果选取redirect，则在struts-config.xml中的action元素会多一个属性，redirect="true"。运行的结果是success.jsp中无法获得request范围内的savelogon对象。