Struts1基础

Struts1框架
1.1、框架（Framework）和Struts
      框架的概念：就是为项目定义一个开发的规则，项目中加入一些封装好的支持包，以及配置文件，所有开发人员都按照该框架规定的格式来进行代码的编写。
Struts框架是apache开发的一个开源的框架，版本目前出现的有两大版本：1.x（1.0 – 1.3），2.x（收购WebWork，最新版2.1.16，稳定版本：2.0.8，2.1.8），两个版本的架构完全不一样，理论上未来发展方向应该是2.x。
      Struts框架是实现MVC模式的一个框架。Model层之前使用JavaBean + DAO，Controller之前使用Servlet，View层之前使用JSP + JSTL + EL
使用Struts后，Model层不变，Controller层改为Struts提供的ActionForm和Action来实现，两者合并到一起实现之前Servlet的功能，View层改为JSP + Struts标签库 + EL
      其他框架：
MVC框架：Struts1/2，WebWork，JSF（Java Server Faces）、ORM框架：Hibernate，iBATIS，EJB、中间件框架：Spring，Seasar、WebService框架：XFire（CXF）、搜索引擎：Lucene、工作流框架：JBPM
AJAX框架：JQuery，JSON，DWR，ExtJS
      不使用Struts时，登陆怎样编写：
DAO部分  登陆页面  提交表单  在web.xml中找到Servlet  进入doGet/doPost  接收参数，验证，整合，依据返回结果设置属性，跳转  成功页或错误页
改用Struts后，模式改为：
DAO部分  登陆页面（Struts标签）  提交表单  在web.xml中找到Servlet（Struts提供一个专用的Servlet，名称为ActionServlet）  由ActionServlet自动完成执行Struts的ActionForm和Action  执行ActionForm（接收参数，并验证）  进入Action，调用DAO，依据结果设置属性，跳转  成功页或错误页
1.2、Struts完成登陆
       建立项目，并为项目加入Struts框架支持。注意，Struts版本必须为1.2或1.3
而且加入支持后，必须自动部署项目，如果想手工修改server.xml部署，必须先将所有的struts支持包拷贝到项目的lib目录下。加入支持后，在web.xml中可以修改struts-config.xml核心文件的文件名，或配置多个核心文件
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
<init-param>
<param-name>config</param-name>
<param-value>/WEB-INF/struts-config.xml</param-value>
</init-param>
<init-param>
<param-name>debug</param-name>
<param-value>3</param-value>
</init-param>
<init-param>
<param-name>detail</param-name>
<param-value>3</param-value>
</init-param>
<load-on-startup>0</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
    开始编写代码。DAO部分省略，简化为写死的判断，当用户输入用户名wuzhlin，密码12345时表示登陆成功，否则登陆失败。编写登陆页。建立新的jsp，建立包含了Struts1.2/1.3支持的jsp
<center>
<html:form action="/login.do" method="post">
用户ID：<html:text property="userid"></html:text> <br/>
密码：<html:password property="password"></html:password> <br/>
<html:submit>登陆</html:submit>
<html:reset>重置</html:reset>
</html:form>
</center>
使用Struts标签来完成表单，使用方法与普通表单类似。
但提交路径可以直接写 /路径， 而不需要加入${pageContext.request.contextPath}
不再使用name作为提交的参数名，改为property。使用这种标签后，可以完成自动回填功能。
建立ActionForm与Action，将use case中填入提交路径中的名称（提交路径名为login.do，因此这里直接填写login），注意，修改Input Source，改为验证出错后自动跳转
建立好ActionForm与Action后，先编写ActionForm
接收参数，直接在ActonForm中定义属性，并生成getter与setter方法即可自动接收参数。
private String userid;
private String password;
public String getUserid() {
return userid;
}
public void setUserid(String userid) {
this.userid = userid;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
加入验证功能，这里验证用户名和密码不能为空。
验证通过validate方法来完成。在验证时，错误信息需要在资源文件中提前定义好
public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
// 保存所有错误信息的一个对象
ActionErrors errors = new ActionErrors();
// 判断用户名与密码是否为空
if (this.userid == null || this.userid.trim().equals("")) {
// 添加错误信息，错误信息需要依据名称去资源文件中取得对应的值，并保存到errors对象里
errors.add("userid", new ActionMessage("userid.null"));
}
if (this.password == null || this.password.trim().equals("")) {
errors.add("password", new ActionMessage("password.null"));
}
return errors;
}
如果验证出错，会自动跳转回错误页。
在错误页中（login.jsp中）加入错误信息显示的功能。通过<html:errors/>标签来显示错误信息。
<center>
<font color="red">
<html:errors/>
</font>
<html:form action="/login.do" method="post">
用户ID：<html:text property="userid"></html:text> <html:errors property="userid"/> <br/>
密码：<html:password property="password"></html:password> <html:errors property="password"/> <br/>
<html:submit>登陆</html:submit>
<html:reset>重置</html:reset>
</html:form>
</center>
没有加入property表示显示所有错误信息，加入property表示显示某一个名称的错误信息。编写Action。
/**
* 该方法相当于之前的doGet + doPost
*/
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) {
LoginForm loginForm = (LoginForm) form;

// 执行验证登陆，如果写了DAO，这里就需要调用数据库操作
if (loginForm.getUserid().equals("wuzhulin")
&& loginForm.getPassword().equals("12345")) {
// 登陆成功
request.getSession().setAttribute("userid", loginForm.getUserid());
// 跳转到成功页
return mapping.findForward("suc");
} else {
// 提示错误信息
ActionErrors errors = new ActionErrors();
errors.add("login", new ActionMessage("login.err"));
// 保存错误信息
this.addErrors(request, errors);
// 返回错误页
return mapping.getInputForward();
}
}
打开 struts-config.xml，配置suc跳转路径。
<action attribute="loginForm" input="/login.jsp" name="loginForm"
path="/login" scope="request" type="cn.mldn.login.struts.action.LoginAction"
cancellable="true">
<forward name="suc" path="/suc.jsp"></forward>
</action>
Name表示路径名称，在Action中返回时会用到，path表示要跳转的具体路径。
要设置密码不回填，可以在Action中跳转错误页前，将密码设置为空值
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) {
LoginForm loginForm = (LoginForm) form;

// 执行验证登陆，如果写了DAO，这里就需要调用数据库操作
if (loginForm.getUserid().equals("wuzhulin")
&& loginForm.getPassword().equals("12345")) {
// 登陆成功
request.getSession().setAttribute("userid", loginForm.getUserid());
// 跳转到成功页
return mapping.findForward("suc");
} else {
// 提示错误信息
ActionErrors errors = new ActionErrors();
errors.add("login", new ActionMessage("login.err"));
// 保存错误信息
this.addErrors(request, errors);
// 设置密码为空，不回填
loginForm.setPassword(null);
// 返回错误页
return mapping.getInputForward();
}
}
说明回填功能是靠ActionForm中属性值来完成的。也就说明了ActionForm以及里面的属性被保存在了request范围。
1.3、Struts工作原理以及核心配置文件
       从jsp提交路径（*.do）在web.xml中查找到ActionServlet，ActionServlet加载了struts-config.xml，创建出了ActionForm以及Action，先执行ActionForm，接收参数，并调用validate()方法验证，如果验证失败，返回错误页，并提示错误信息（通过input找到，错误信息使用html:errors），验证成功则进入Action的execute方法，执行操作，最后跳转到jsp（依据struts-config.xml里的<forward>配置）
Struts-config.xml配置文件的说明：
form-beans：配置ActionForm的
form-bean：配置一个ActionForm
name：表示这个ActionForm的唯一标识不能重复。
type：表示ActionForm的包.类名称。
global-exceptions：配置全局异常，当出现异常时，可以依据这个配置自动跳转到错误页。
global-forwards：配置全局跳转路径，可以配置所有Action共用的跳转路径。forward中间页一般配置到这里。
action-mappings：配置所有Action的
action：配置一个Action
type：Action的包.类名称
name：表示此Action对应的ActionForm的名称，一个Action最多只允许对应一个ActionForm，但一个Form可以对应多个Action。
input：表示错误页
path：进入此Action 的虚拟路径。是Action的唯一标识
scope：表示ActionForm保存的属性范围。只能选择request或session，建议使用request
attribute：表示ActionForm在request范围内的属性名称，一般不需要修改。
<forward>：表示一个跳转路径
name：路径名
path：路径的具体地址
redirect：设置跳转的方式，如果为true表示客户端跳转，默认为false（服务器端跳转）
message-resources：配置资源文件的文件名和所在位置。
完成Elearning的登陆功能，注意MD5加密，验证码（都在ActionForm中处理）
1.4、Struts中ActionForm的参数处理
        Struts支持直接将参数设置到vo对象的属性中。在ActionForm中定义出这个vo对象。
private Admin admin = new Admin();
public Admin getAdmin() {
return admin;
}
public void setAdmin(Admin admin) {
this.admin = admin;
}
修改验证方法中的代码，都改为从admin对象中取得属性
public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
ActionErrors errors = new ActionErrors();
if (admin.getId() == null || admin.getId().trim().equals("")) {
// 表示向资源文件中传入一个参数，替换{1}
errors.add("id", new ActionMessage("msg.null","用户名"));
}
if (admin.getPassword() == null || admin.getPassword().trim().equals("")) {
errors.add("pwd", new ActionMessage("msg.null","密码"));
}
if (code == null || code.trim().equals("")) {
errors.add("code", new ActionMessage("msg.null","验证码"));
}
// 验证验证码是否正确
// 取得真实的验证码
String realCode = (String) request.getSession().getAttribute("rand");
if (!realCode.equals(code)) {
errors.add("code", new ActionMessage("code.err"));
}
// 还要进行MD5加密
if (errors.size() == 0) {
admin.setPassword(new MD5Code().getMD5ofStr(admin.getPassword()));
}
return errors;
}
修改Action的代码，也直接使用Form中定义好的admin对象
public ActionForward execute(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) {
LoginForm loginForm = (LoginForm) form;
Map map = BackServiceFactory.getAdminSeviceInstance().isLogin(loginForm.getAdmin());
boolean flag = (Boolean) map.get("flag");
if (flag) {
request.getSession().setAttribute("admin", map.get("admin"));
request.getSession().setAttribute("allActions",
map.get("allActions"));
return mapping.findForward("backindex");
} else {
ActionErrors errors = new ActionErrors();
errors.add("login", new ActionMessage("login.err"));
this.addErrors(request, errors);
loginForm.getAdmin().setPassword(null);
return mapping.getInputForward();
}
}
修改jsp页面，将表单中提交的文本框的名称改为对象中属性的形式
                <tr>
                  <td align="center" valign="middle">管理员ID：
                    <html:text property="admin.id" styleClass="fm_blue" size="25" /><br><span id="user"></span></td>
                </tr>
                <tr>
                  <td align="center" valign="middle">密&nbsp;&nbsp;码：
                    <html:password property="admin.password" styleClass="fm_blue" size="25"/></td>
                </tr>
可以直接设置属性，在完成添加或修改功能时，一般会使用到这种设置参数的形式。
对于不是String类型的参数，ActionForm在一定程度上也可以处理。
定义一个User的vo类，在里面加入age和birthday，分别为int基本数据类型和Date日期类型。
package org.wu.login.vo;
import java.util.Date;
public class User {
private String userid ;
private String password ;
private int age ;
private Date birthday;
public String getUserid() {
return userid;
}
public void setUserid(String userid) {
this.userid = userid;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public Date getBirthday() {
return birthday;
}
public void setBirthday(Date birthday) {
this.birthday = birthday;
}
}
在页面上直接将数据提交到vo对象中
<center>
<font color="red">
<html:errors/>
</font>
<html:form action="/regist.do" method="post">
用户ID：<html:text property="user.userid"></html:text> <br/>
密码：<html:password property="user.password"></html:password><br/>
年龄：<html:text property="user.age"></html:text><br/>
生日：<html:text property="user.birthday"></html:text><br/>
<html:submit>登陆</html:submit>
<html:reset>重置</html:reset>
</html:form>
</center>
建立Action与ActionForm
package org.wu.login.struts.form;
import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.ActionErrors;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.action.ActionMessage;

import org.wu.login.vo.User;
public class RegistForm extends ActionForm {
private User user = new User();
public User getUser() {
return user;
}
public void setUser(User user) {
this.user = user;
}
public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
ActionErrors errors = new ActionErrors();
if (user.getUserid() == null || user.getUserid().trim().equals("")) {
errors.add("userid", new ActionMessage("userid.null"));
}
System.out.println(user.getAge());
System.out.println(user.getBirthday());
return errors;
}
public void reset(ActionMapping mapping, HttpServletRequest request) {
}
}
测试后发现，Date类型是不能自动接收的。对于Date类型必须先使用String类型的属性接收，接收后，在validate方法中通过SimpleDateFormat来转型
生日：<html:text property="birthday"></html:text><br/>
public ActionErrors validate(ActionMapping mapping,
HttpServletRequest request) {
ActionErrors errors = new ActionErrors();
if (user.getUserid() == null || user.getUserid().trim().equals("")) {
errors.add("userid", new ActionMessage("userid.null"));
}
SimpleDateFormat sf = new SimpleDateFormat("yyyy-MM-dd");
try {
user.setBirthday(sf.parse(this.birthday));
} catch (Exception e) {
errors.add("birthday", new ActionMessage("birth.err"));
}
System.out.println(this.user.getAge());
System.out.println(this.user.getBirthday());
return errors;
}
基本数据类型的数据可以自动转型。如果输入的语法正确，可以转型，则自动会进行转换。
如果输入的语法错误，无法转型，直接将该类型的默认值设置到这个对应的属性中。
基本类型中boolean类型比较特殊，也可以自动转型，但只支持以下的值：true，false，0，1
在ActionForm中，也可以自动接收多选框的数组类型数据。