首页 > 代码库 > Struts2-part1

Struts2-part1

作者:禅楼望月(http://www.cnblogs.com/yaoyinglong)

1. Struts2应用的开发步骤:

① 在web.xml中配置核心的Filter来拦截用户的请求。

<web-app>  <!-- 配置Sturts2 -->  <filter>    <filter-name>struts2</filter-name>    <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>  </filter>  <filter-mapping>    <filter-name>struts2</filter-name>    <url-pattern>*.do</url-pattern>  </filter-mapping></web-app>

其中<url-pattern>*.do</url-pattern>表示所有以.do结尾的url都要经过struts2。

②如果需要以POST方式提交请求,则需要定义包含表单数据的JSP页面,如果仅仅以GET方式发送请求,则无需定义JSP页面。

③定义处理请求的Action类。

④配置Action。即指定那个请求对应哪个Action进行处理。

⑤配置处理结果和物理视图资源的之间的对应关系。

⑥编写视图资源。需要借助OGNL表达式。

2. Struts2请求—响应完整流程

image

3. Struts2配置

3.1. 常量

在Struts2种可以使用Convertion插件来管理Action、结果映射,不过大多数还是使用XML文件来管理Struts2的配置信息。

Struts2默认配置文件为struts.xml,通常放在类加载路径下,也可以改变。Struts2默认会加载类路径下的struts.xml(开发者定义的默认配置文件)、struts-plugin.xml(struts2插件的默认配置文件)、struts-default.xml(Struts2自带的配置文件)文件。

struts2常量有3种配置方式:

①struts.properties文件

②struts.xml文件

③web.xml文件

如在struts.xml中定义常量:

<struts><!-- 通过 constant元素 配置Struts2常量--><constant name="struts.custom.il8n.resources" value="mess"/></struts>  在web.xml文件中定义常量:  <filter>    <filter-name>struts2</filter-name>    <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>      <init-param>       <param-name>struts.custom.il8n.resources</param-name>       <param-value>mess</param-value>      </init-param>  </filter>

以初始化参数的形式配置。

推荐使用Struts2.xml文件配置常量。

Struts2框架搜索Struts2常量的顺序:

①struts-default.xml:该文件在struts2-core-2.1.2.jar文件中。

②struts-plugin.xml:该文件保存在struts2-Xxx-2.1.2.jar等Struts2插件JAR文件中。

③struts.xml:该文件是web应用默认的Struts2配置文件。

④struts.properties.

⑤web.xml

顺序在后面的常量会覆盖顺序在前面的文件中的同名常量。

3.2. 分散配置

避免struts.xml文件过大,提高该文件的可读性。可以将struts.xml文件分解为多个配置文件,然后在struts.xml文件中包含其他配置文件即可:

<struts><!-- 通过include元素导入其他配置文件 --><include file="struts-part1.xml"/></struts>

这里的struts-part1.xml文件和struts.xml文件一样,没有任何的特殊之处。

4. Action

和struts1不同,struts2将struts1种的ActionForm和Action合并为Action。该Action只是一个普通的Java类,不需要继承任何接口和父类。只需配置即可使用。就想Hibernate中的domain(POJO)类一样。

4.1. Action接口与ActionSupport

为了开发者设计的Action更加规范,Struts2提供了Action接口:

public interface Action {    /**     * The action execution was successful. Show result     * view to the end user.     */    public static final String SUCCESS = "success";    /**     * The action execution was successful but do not     * show a view. This is useful for actions that are     * handling the view in another fashion like redirect.     */    public static final String NONE = "none";    /**     * The action execution was a failure.     * Show an error view, possibly asking the     * user to retry entering data.     */    public static final String ERROR = "error";    /**     * The action execution require more input     * in order to succeed.     * This result is typically used if a form     * handling action has been executed so as     * to provide defaults for a form. The     * form associated with the handler should be     * shown to the end user.     * <p/>     * This result is also used if the given input     * params are invalid, meaning the user     * should try providing input again.     */    public static final String INPUT = "input";    /**     * The action could not execute, since the     * user most was not logged in. The login view     * should be shown.     */    public static final String LOGIN = "login";    /**     * Where the logic of the action is executed.     *     * @return a string representing the logical result of the execution.     *         See constants in this interface for a list of standard result values.     * @throws Exception thrown if a system level exception occurs.     *                   <b>Note:</b> Application level exceptions should be handled by returning     *                   an error value, such as <code>Action.ERROR</code>.     */    public String execute() throws Exception;}

这个5个字符串常量是做为execute方法返回值来使用的。比如:在请求处理成功后,有人喜欢返回welcome,而有人喜欢银success,这样不利于项目同一管理。所以Struts2定义了这5个常量来规范。

为例大大简化开发者开发Action,Struts2提供了ActionSupport类。它是struts2默认的Action处理类(如果我们配置Action时没 有指定class属性,struts2会自动使用ActionSupport类作为Action处理类)。

5. Action访问Servlet API

5.1. ActionContext类

Struts2的Action没有与Servlet API耦合,这是一个很大的改善。但是作为一个Web框架,不访问Servlet API怎么可能?因此Struts2提供了ActionContext类,通过该类Struts2的Action便可以访问Servlet的API了。

ActionContext(com.opensymphony.xwork.ActionContext)是Action执行时的上下文,上下文可以看作是一个容器(其实我们这里的容器就是一个Map而已),它存放放的是Action在执行时需要用到的对象,比如:在使用WebWork时,我们的上下文放有请求的参数(Parameter)、会话(Session)、Servlet上下文(ServletContext)、本地化(Locale)信息等。
在每次执行Action之前都会创建新的ActionContext,ActionContext是线程安全的,也就是说在同一个线程里ActionContext里的属性是唯一的,这样我的Action就可以在多线程中使用。详见
这里

以一个登陆的Action为例:

package com.stbc.web.Action;import com.opensymphony.xwork2.Action;import com.opensymphony.xwork2.ActionContext;public class LoginAction implements Action {private String userName;private String psw;public String getUserName() {return userName;}public void setUserName(String userName) {this.userName = userName;}public String getPsw() {return psw;}public void setPsw(String psw) {this.psw = psw;}@Overridepublic String execute() throws Exception {ActionContext actionContext=ActionContext.getContext();//通过ActionContext访问application范围的属性值。Integer counter=(Integer)actionContext.getApplication().get("counter");if(counter==null){counter=1;}else {counter+=1;}actionContext.getApplication().put("counter", counter);//通过ActionContext设置session属性actionContext.getSession().put("username", getUserName());if(getUserName().equals("hello") && getPsw().equals("123")){//通过ActionContext设置request范围的属性。actionContext.put("tip", "登陆成功");return SUCCESS;}else {actionContext.put("tip", "登陆失败");return ERROR;}}}

5.2. Action直接访问Servlet API

Action通过继承如下几个接口便可以通过这些接口来访问Servlet API:

ServletContextAware:实现该接口的Action可以直接访问Web应用的ServletContext实例。

ServletRequestAware:实现该接口的Action可以直接访问用户请求的HttpServletRequest实例。

ServletResponseAware:实现该接口的Action可以直接访问服务器响应的HttpServletResponse实例。

package com.stbc.web.Action;import javax.servlet.http.HttpServletRequest;import org.apache.struts2.interceptor.ServletRequestAware;import com.opensymphony.xwork2.Action;import com.opensymphony.xwork2.ActionContext;public class LoginAction implements Action,ServletRequestAware {        private HttpServletRequest request =null;                ……        @Override        public void setServletRequest(HttpServletRequest request) {                //这里将HttpServletRequest传给request,其他的使用和Servlet中一样                this.request=request;        }}

5.3. ServletActionContext

这是一个工具类它是ActionContext的子类,有如下静态方法供调用:

image

借助ServletActionContext,Action能以更简单的方式来访问Servlet API。该类详见这里

6. 配置Action

配置Action就是让Struts2知道,那个请求是由那个Action来控制的。

6.1. 包和命名空间

Struts2使用包来组织Action。Action标签必须放在package标签下面。

Package标签的元素如下:

  • name:必须,是引用该包的唯一标识;也指定了该Action所处理的请求的URL,相当于Struts1的path。
  • extends:可选,表示该包继承其他包,可以继承其他包中的Action定义、拦截器定义等。
  • namespace:可选,该包的命名空间
  • abstract:可选,指该包是否是一个抽象包,抽象包中不能包含Action定义。

注意:Struts2的配置文件是从上往下处理的,所以父类应该在子类前面定义。

例:

<struts>        <package name="get" extends="struts-default" namespace="/book">                <!-- 配置一个名为getBooks的Action -->                <action name="getBooks" class="org.crazyit.app.action.GetBooksAction">                        <result name="login">/login.jsp</result>                        <result name="sucess">/showBook.jsp</result>                </action>        </package></struts>

除此之外,Struts2还指定根命名空间:

<package name="get" extends="struts-default" namespace="/">

当某个包指定了命名空间后,该包下所有的Action处理的URL应该是命名空间+Action名,如访问该Action的URL应该是:

http://localhost:8080/webappName/book/getBooks.action

访问的Action的命名空间为根命名空间则把上面的/book去掉即可。

对于上面的URL,Struts2首先会在book命名空间查找名为getBooks或者根命名空间的Action,找到则使用该Action处理用户的请求,否则Struts2会在默认命名空间中查找名为getBooks的Action,找到则使用该Action处理用户的请求,否则Struts2报错。

注意在URL中命名空间只能有一个,即book下面不能再有一个命名空间了。如:http://localhost:8080/webappName/book/sub/getBooks.action,则,Struts2会将当/book/sub成一个命名空间名称来对待。

注意:在action的name属性中不能出现“.”和中划线“-”。

6.2. Action的动态方法调用

这个代替Struts1的分派Action。使用动态调用方法前必须设置Struts2允许动态方法调用:设置struts.enable.DynamicMethodInvocation常量值为true来完成,该值默认为false。

URL为:action的name!action的方法名。如:

public class LoginAction{        public String regedit() throws Exception {                //业务逻辑                return SUCCESS;        }}

配置action为:

<struts>        <constant name="struts.enable.DynamicMethodInvocation" value="true"/>        <package name="get" extends="struts-default" namespace="/">                <action name="regeditAndLogin" class="com.stbc.web.Action.LoginAction">                        <result name="sucess">/welcome.jsp</result>                </action>        </package></struts>

则URL为:http://localhost:8080/webappName/regeditAndLogin!regedit

6.3. Action使用通配符

使用通配符可以是一个action处理一系列(一类)的请求。这时在配置<action>元素时,允许在name属性中使用模式字符(即用“*”代表一个或多个字符),接下来可以在class、method属性、result子元素中使用{N}的形式,来代表前面第N个星号(*)所匹配是字符串。如:

public class LoginAction extends ActionSupport{        public String regedit() throws Exception {                //业务逻辑                return SUCCESS;        }        public String Login() throws Exception {                //业务逻辑                return SUCCESS;        }        public String Logout() throws Exception {                //业务逻辑                return SUCCESS;        }}

配置Action:

<constant name="struts.enable.DynamicMethodInvocation" value="true"/><package name="get" extends="struts-default" namespace="/">        <!-- 使用模式字符串定义Action的name,指定以regLog结尾的请求,都可以使用 LoginAction来处理       ,method属性使用{1},这个{1}代表进行模式匹配时第一个*所代替的字符串-->        <action name="*regLog" class="com.stbc.web.Action.LoginAction" method="{1}">                <result name="sucess">/welcome.jsp</result>        </action></package></struts>

这时只要请求是*regLog.action的模式都可以使用该action来处理。如:URL为:http://localhost:8080/webappName/regeditregLog.action时则表示,调用LoginAction的regedit方法。

此外action的class属性也可以使用{N}表达式,含义与method的一样:

<action name="*regLog" class="com.stbc.web.Action.{1}LoginAction">

如果有需要,Struts2完全可以在class属性和method属性使用{N}表达式:

<action name="*_*" class="com.stbc.web.Action.{1}" method="{2}">        <result name="sucess">/{1}welcome.jsp</result></action>

如URL:http://localhost:8080/webappName/LoginAction_Login.action,则会调用LoginAction类中的Login方法。

如果只是简单的超链接请求可将action的name属性定义为“*”.

现在的问题是,如果一个URL与多个action匹配怎办?

如果URL与action名能完全匹配则请求由该action处理,否则struts2会寻找能和该URL匹配的第一个action(struts2寻找顺序是由上向下的),并用这个action来处理该请求。

如:有一个URL为abcAction.action与一下3个action都匹配:它们的name为:abcAction、*Action、*,则该url由name为abcAction的action处理。但是如果该struts.xml中没有name为:abcAction的action,只有name为*和*Action的action,并且它们在struts.xml中的配置顺序为:<action name="*"……>、<action name="*Action"……>,则该URL请求由name为*的action处理。Struts2并不觉得name为*Action的action与URL的匹配度高而选用它,Struts2只会由上向下寻找第一个匹配的action,并使用这个action。

因此在配置Action时,应该注意Action的顺序。最好将name为“*”的action放到最后。

6.4. 配置默认Action

当用户的请求找不到对应的Action时,则用默认的Action处理用户的请求。

<struts>        <package name="get" extends="action-default">                <default-action-ref name="someAction"/>                <actoin name="someAction" class="……"></actoin>        </package></struts>

注:将Action配置在默认命名空间中就可以让该Action处理所有用户请求,因为默认命名空间的Action可以处理任何命名空间的请求。

6.5. 配置Action的默认处理类

一个Action没有指定class属性,则Struts2默认使用ActionSupport作为该Action的处理类。

Struts2还允许开发人员自己配置自己的默认处理类:

<struts>        <package name="get">                <default-class-ref class="myClass"/>        </package></struts>

这样定义之后,没有指定class属性Action,将用myClass来处理。

7. 配置处理结果

Struts2提供了两种结果:

局部结果:

<action name="someAction" class="com.someclass">        <result name="sucess">/welcome.jsp</result></action>

全局结果:

<global-results>        <result name="globalResult">/welcome.jsp</result></global-results>

7.1. Struts2支持的结果类型

Struts2提供了一系列的结果类型。

  •    chain结果类型:Action链式处理的结果类型。
  •     dispatcher结果类型:用于指定使用JSP作为视图的结果类型
  •     freemarker结果类型:用于执行使用FreeMarker模板作为视图的结果类型
  •     httpheader结果类型:用于控制特殊的HTTP行为的结果类型
  •     redirect结果类型:用于直接跳转到其它URL的结果类型
  •     redirect-action结果类型:用与直接跳转到其它Action的结果类型
  •     stream结果类型:用于向浏览器返回一个InputStream(一般用于文件下载)
  •     velocity结果类型:用于指定使用Velocity模板作为视图的结果类型
  •     xslt结果类型:用于与XML/XSLT整合的结果类型
  •     plainText结果类型:用于显示某个页面的原始代码的结果类型

它们被定义在struts2-core-2.2.1.jar下的struts-default包下的<result-types>元素内:

<result-types>    <result-type name="chain" class="com.opensymphony.xwork2.ActionChainResult"/>    <result-type name="dispatcher" class="org.apache.struts2.dispatcher.ServletDispatcherResult" default="true"/>    <result-type name="freemarker" class="org.apache.struts2.views.freemarker.FreemarkerResult"/>    <result-type name="httpheader" class="org.apache.struts2.dispatcher.HttpHeaderResult"/>    <result-type name="redirect" class="org.apache.struts2.dispatcher.ServletRedirectResult"/>    <result-type name="redirectAction" class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/>    <result-type name="stream" class="org.apache.struts2.dispatcher.StreamResult"/>    <result-type name="velocity" class="org.apache.struts2.dispatcher.VelocityResult"/>    <result-type name="xslt" class="org.apache.struts2.views.xslt.XSLTResult"/>    <result-type name="plainText" class="org.apache.struts2.dispatcher.PlainTextResult" /></result-types>

dispatcher与redirect的区别:

dispatcher:表示forward(转发)请求。

redirect:重定向。

使用redirect结果类型的效果是,系统将调用HttpServletRespoe的sendRedirect(String)方法来重定向指定视图资源,这种重定向的效果就是一个请求,因此所有的请求参数、请求属性、Action实例和Action中封装的属性全部丢失。

7.2. PreResultListener

监听器接口,它在Action完成控制处理之后,struts2转入实际的物理视图之前被回调。Action、拦截器可添加PreResultListener监听器:

public class LoginAction extends ActionSupport{        //需要的Field        @Override        public String execute() throws Exception {                ActionInvocation invocation=ActionContext.getContext().getActionInvocation();                invocation.addPreResultListener(new PreResultListener() {                @Override                public void beforeResult(ActionInvocation invocation, String resultCode) {                        // TODO 业务逻辑                }        });        return SUCCESS;        }}

7.3. 配置Struts2的异常处理

可以在Action中使用try……catch来根据不同的异常返回不同的字符串,但是这样做使得异常与代码耦合,一旦要改变异常处理方式,就必须修改Action。

由Action的签名来看:public String execute() throws Exception,它声明了Exception,就说明该方法不必处理任何类型的错误,将所有类型的错误发给struts2即可。然后struts2会根据异常的类型寻找匹配的逻辑视图名,并使用他来处理异常。这样我们只需在struts.xml中配置异常处理即可。

为例使用Struts2的异常处理机制,必须打开struts2的异常映射功能:

<interceptors>        <!-- 执行异常处理的拦截器 -->        <interceptor name="exception" class="……"/>        <!-- Struts2默认的拦截器栈 -->        <interceptor-stack name="defaultStack">        <!-- 引用异常映射拦截器 -->        <interceptor-ref name="exception"/></interceptor-stack></interceptors>

Struts2-part1