Action, ActionForm, ActionForward ,这三个对象构成了Struts 的核心。
Struts 最核心的控制器是ActionServlet ,该Servlet 拦截用户请求,井将用户请求转入到Struts 体系内。
一、配置ActionServlet
ActionServlet 是一个标准的Servlet ,在web.xml 文件中配置,该Servlet 用于拦所有的HTTP 请求。因此,应将该Servlet 配置成自启动Servlet ,即为该Servlet 配置load-on-startup 属性。
注意:在应用Struts 的很多场景下,为Servlet 配直load-on-startup 属性都是必需的。因此,笔者建议应为ServletAction 配直load-an-startup 属性。
在web.xml 文件中配置ActionServlet 应增加如下片段:
- <!-- 将ActionServlet配置成自启动的Servlet -->
- < servlet >
- <!-- 指定Servlet 的名字 -->
- < servlet-name > actionSevlet </ servlet-name >
- <!-- 指定该Servlet 的实现类 -->
- < servlet-class >
- org.apache.struts.action.ActionServlet
- </ servlet-class >
- <!-- 配置自启动的级别 -->
- < load-on-startup > 2 </ load-on-startup >
- </ servlet >
- < servlet-mapping >
- <!-- 配置ActionServlet的URL 映射 -->
- < servlet-name > actionSevlet </ servlet-name >
- <!-- 所有以.do 结尾的请求由ActionServlet拦截 -->
- < url-pattern > *.do </ url-pattern >
- </ servlet-mapping >
该ActionServlet作为一个标准Servlet,配置在Web 应用中,负责拦截用户请求。该Servlet 还有加载Struts 配置文件的责任。但这里并未告诉它如何加载Struts 的配置文
件,以及Struts 的配置文件放在哪里及文件名是什么。ActionServlet默认加载WEB-INF 下的struts-config.xml文件。如果需要Struts 的配置文件不在WEB-INF路径下,或者改变了文件名,则应采用如下方式配置:
- < servlet >
- < servlet-name > actionSevlet </ servlet-name >
- < servlet-class >
- org.apache.struts.action.ActionServlet
- </ servlet-class >
- < init-param >
- < param-name > config </ param-name >
- < param-value > /WEB-INF/struts-config-user.xml </ param-value >
- </ init-param >
- < load-on-startup > 2 </ load-on-startup >
- </ servlet >
在上面的配置中,指定了ActionServlet 的配置文件: struts-config-user.xml文件,该文件作为init-param参数载入,载入时候指定了参数名:config ,config 是Struts 固定的参数名, struts负责解析该参数,并加载该参数的指定的配置文件。Struts 支持使用多个配置文件,当有多个配置文件时,应将不同的配置文件配置成不同的模块,并指定不同的URI。下面的片段配置了两个配置文件:
- < servlet >
- <!-- ActionServlet 的名 -->
- < servlet-name > actionSevlet </ servlet-name >
- <!-- 配置Servlet 的实现类 -->
- < servlet-class >
- org.apache.struts.action.ActionServlet
- </ servlet-class >
- <!-- 指定Struts 的第一个配置文件 -->
- < init-param >
- <!-- 指定配置文件的映射 -->
- < param-name > config </ param-name >
- < param-value > /WEB-INF/struts-con工fgl.xml </ param-value >
- </ init-param >
- <!-- 指定Struts 的第二个配置文件 -->
- < init-param >
- <!-- 指定配置文件的映射 -->
- < param-name > config/wawa </ param-name >
- < param-value > /WEB-INF/struts-config2.xml </ param-value >
- </ init-param >
- <!-- 将ActionServlet配置成自启动Servlet -->
- < load-on-startup > 2 </ load-on-startup >
- </ servlet >
上面的配置片段中指定了两个配置文件:struts-config l.xml 和struts-config2.xml 文件。这两个配置文件分别被配置到config 和config/wawa 的路径下。表明将struts-config 1.xml 中的Action 映射到应用的根路径下,而struts-config2.xml 文件中的Action 则被映射到应用的wawa 子路径下。也就是说wawa 将作为系统的一个模块使用。
二、配置ActionForm
配置ActionForm ,必须包含ActionForm 类才行。Struts 要求ActionForm 必须继承Struts 的基类: org.apache.struts.action.ActionForm,ActionForm 的实现非常简单,该类只是一个普通的JavaBean,只要为每个属性提供对应的setter 和getter 方法即可。根据前面的讲解, ActionForm 用于封装用户的请求参数,而请求参数是通过JSP 页面的表单域传递过来的。因此应保证ActionForm 的参数与表单域的名字相同。
注意: JavaB ean 的参数是根据getter 、setter 方法确定的。如果希望有一个A 的属性,则应该提供getA 和setA 的方法。
(1)ActionForm的实现
ActionForm 的属性必须与JSP 页面的表单域相同。本示例的表单包含如下两个表单域:
• usemame
• password
因此, ActionForm 必须继承org.apache.struts.action.ActionForm,并为这两个域提供对应的setter 和getter 方法,下面是ActionForm 的源代码:
- import org.apache.struts.action.ActionForm;
- public class LoginForm extends ActionForm {
- private String username;
- private String password;
- // 表单域username对应的setter 方法
- /**
- * @return the username
- */
- public String getUsername() {
- return username;
- }
- /**
- * @param username
- * the username to set
- */
- public void setUsername(String username) {
- this .username = username;
- }
- /**
- * @return the password
- */
- public String getPassword() {
- return password;
- }
- /**
- * @param password
- * the password to set
- */
- public void setPassword(String password) {
- this .password = password;
- }
- }
另外,该ActionForm 的两个属性名可以不是usemame 和password。只要提供了usemame 和password 的setter 和getter 方法即可。
注意: FormBean 类应尽量声明成public。
(2)ActionForm 的配置
所有的ActionForm 都被配置在struts-config.xml 文件中,该文件包括了一个form-beans 的元素,该元素内定义了所有的ActionForm,每个ActionForm 对应一个form-bean 元素。
为了定义LoginForm. 必须在struts-config.xml文件中增加如下代码:
- <!-- 用于定义所有的ActionForm -->
- < form-beans >
- <!-- 定义ActionForm,至少指定两个属性: name , type-->
- < form-bean name = "loginForm" type = "lee.LoginForm" />
- </ form-beans >
配置ActionForm非常简单,只需指定ActionForm 的name 属性即可。该属性定义了ActionForm的id. 用于标识该Form; 另外还需要一个type 属性,该属性定义了ActionForm的实现类。
下面将介绍Action 如何使用该ActionForm. 以及Action 如何与该ActionForm关联。
三、配置Action
Action 的配置比ActionForm 相对复杂一点,因为Action 负责管理与之关联的ActionForm. 它不仅需要配置实现类,还需要配置Action 的path 属性,该属性用于被用
户请求。对于只需在本Action 内有效的Forward. 还应在Action 元素内配置局部Forward。
(1)Action 的实现
通过ActionForm. 可使Action 无须从HTTP 请求中解析参数。因为所有的参数都被封装在ActionForm中,下面是Action 从AcitionForm 取得请求参数的源代码:
- import javax.servlet.http.HttpServletRequest;
- import javax.servlet.http.HttpServletResponse;
- import org.apache.struts.action.Action;
- import org.apache.struts.action.ActionForm;
- import org.apache.struts.action.ActionForward;
- import org.apache.struts.action.ActionMapping;
- public class LoginAction extends Action {
- // 必须重写该核心方法,该方法actionForm 将表单的请求参数封装成值对象
- public ActionForward execute(ActionMapping mapping, ActionForm form,
- HttpServletRequest request, HttpServletResponse response)
- throws Exception {
- //将ActionForm强制类型转换为LoginForm
- LoginForm loginForm = (LoginForm) form;
- // 从ActionForm中解析出请求参数: username
- String username = loginForm.getUsername();
- // 从ActionForm中解析出请求参数: password
- String pass = loginForm.getUsername();
- //后面的处理与前一个示例的Action 相同。
- ...
- }
- }
该Action 从转发过来的ActionForm 中解析请求参数,对应的ActionForm 则由ActionServlet 在接收到用户请求时,负责实例化。
实际的过程是: ActionServlet 拦截到用户请求后,根据用户的请求,在配置文件中查找对应的Action , Action 的name 属性指定了用于封装请求参数的ActionForm; 然后ActionServlet 将创建默认的ActionForm 实例,并调用对应的setter 方法完成ActionForm的初始化。
ActionServlet 在分发用户请求时,也将对应ActionForm 的实例一同分发过来。
(2)Action 的配置
Action 需要配置如下几个方面。
• Action 的path: ActionServlet 根据该属性来转发用户的请求,即将用户请求转发与之同名的Action 。同名的意思是:将请求的.do 后缀去掉,匹配Action 的path属性值。
• Action 的name: 此处的name 属性并不是Action 本身的名字,而是与Action 关联的ActionForm。因此该name 属性必须是前面存在的ActionForm 名。
• Action 的type: 该属性用于指定Action 的实现类,也就是负责处理用户请求的业
务控制器。
• 局部Forward: Action 的转发并没有转发到实际的JSP 资源,而是转发到逻辑名,即Forward 名。在Action 内配置的Forward 都是局部Forward (该Forward 只在该Action 内有效)。
下面是该Action 的配置代码:
- <!-- 该元素里配置所有的Action -->
- < action-mappings >
- <!-- 配置Action. 指定了path , name , type 等属性 -->
- < action path = "/login" type = "lee.LoginAction" name = "loginForm" >
- <!-- 配置局部Forward -->
- < forward name = "welcome" path = "/WEB-INF/jsp/welcome.jsp" />
- < forward name = "input" path = "/login.jsp" />
- </ action >
- </ action-mappings >
四、配置Forward
正如前面所讲, Forward 分局部Forw缸d 和全局Forward 两种。前者在Action 里配置,仅对该Action 有效:后者单独配置,对所有的Action 都有效。
配置Forward 非常简单,主要需要指定以下三个属性。
• name: 该Forward 的逻辑名。
• path: 该Forward 映射到的JSP 资源。
• redirect: 是否使用重定向。
局部Forward 作为Action 的子元素配置;全局Forward 配置在global-forwards 元素里。
下面是配置全局Forward 的代码:
- <!-- 配置全局Forward -->
- < global-forwards >
- <!-- 配置Forward对象的name 和path 属性 -->
- < forward name = "error" path = "/WEB-INF/jsp/error.jsp" />
- </ global-forwards >
上面的配置代码中,配置了一个全局Forward,该Forward 可以被所有的Action 访问。通常,只将全局资源配置成全局Forward。当每个Action 在转发时,首先在局部Forward 中查找与之对应的Forward,如果在局部Forward 中找不到对应的Forward 对象,才会到全局Forward 中查找。因此,局部Forward 可以覆盖全局Forward。
下面提供了该应用的struts-config.xm1文件的全部源代码:
- <? xml version = "1.0" encoding = "UTF-8" ?>
- <!-- Struts 配置文件的文件头,包含DTD 等信息 -->
- <!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN" "http://struts.apache.org/dtds/struts-config_1_2.dtd" >
- <!--Struts 配置文件的根元素 -->
- < struts-config >
- <!--配置所有的ActionForm -->
- < form-beans >
- <!--配置第一个ActionForm,指定ActionForm的name 和type 属性 -->
- < form-bean name = "loginForm" type = "lee.LoginForm" />
- </ form-beans >
- <!--配置全局Forward对象 -->
- < global-forwards >
- <!--该Forward对象的name 属性为error. 映射资源为/WEB-INF/jsp/error.jsp -->
- < forward name = "error" path = "/WEB-INF/jsp/error.jsp" />
- </ global-forwards >
- <!--此处配置所有的Action 映射-->
- < action-mappings >
- <!--配置Action 的path. type 属性name 属性配置Action 对应的ActionForm-->
- < action path = "/login" type = "lee.LoginAction" name = "loginForm" >
- <!--还配置了两个局部Forward. 这两个局部Forward仅对该Action有效-->
- < forward name = "welcome" path = "/WEB-INF/jsp/welcome.jsp" />
- < forward name = "input" path = "/login.jsp" />
- </ action >
- </ action-mappings >
- </ struts-config >