Gay Bird

登高者必自卑,行远者必自迩,在这个世界上,重要的不是你正站在那里,而是你正朝什么方向移动......

struts2笔记 - 配置

与Struts 1.X不同,Struts2引入了WebWork的配置机制,在很大程度上提高了配置的灵活度。通过使用配置可以配置如下内容:

配置类型

配置文件

Struts2 参数配置

struts.properties

Struts2 Action 配置

struts.xml

Struts2 Result 配置

struts.xml

Struts2 Exception Handling 配置

struts.xml

Struts2 Intercept 配置

struts.xml

Struts2 多配置文件

struts.xml

 

struts.properties文件在WEB-INF/classes目录下存放。

这个文件用来配置Struts2系统的一些基本规约,所有在struts.properties中配置的内容都可以在struts.xml中配置,或者web.xml中在struts2 filter中配置,例如:

Struts.properties中的如下配置:

struts.i18n.encoding=UTF-8

相当于struts.xml中的如下配置:

<constant name=“struts.i18n.encoding” value=“true” />

相当于web.xml中的如下配置:

<filter>

    <filter-name>struts</filter-name>

    <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>

    <init-param>

        <param-name>struts.i18n.encoding</param-name>

        <param-value>true</param-value>

    </init-param>

</filter>

 

Package配置

使用package可以将逻辑上相关的一组Action,Result,Intercepter等组件分为一组,Package有些想对象,可以继承其他的Package,也可以被其他package继承,甚至可以定义抽象的Package。

Package的可以使用的属性:

属性

是否必须

说明

name

Package的表示,为了让其他的package引用

extends

从哪个package集成行为

namespace

参考Namespace配置说明

@TODO Namespace配置说明

abstract

定义这个package为抽象的,这个package中不需要定义action

由于struts.xml文件是自上而下解析的,所以被集成的package要放在集成package的前边。

Namespace配置

Namespace将action分成逻辑上的不同模块,每一个模块有自己独立的前缀。使用namespace可以有效的避免action重名的冲突,例如每一个package都可以有自己独立的Menu和Help action,但是事项方式各有不同。Struts2标签带有namespace选项,可以根据namespace的不同向服务器提交不同的package的action的请求。

“/”表示跟namespace,所有直接在应用程序上下文环境下的请求(Context)都在这个package中查找。

“”表示默认namespace,当所有的namespace中都找不到的时候就在这个namespace中寻找,例如我们上面的login应用程序。

例如,有如下配置:

<package name="default">

<action name="foo" class="mypackage.simpleAction>

        <result name="success" type="dispatcher">

           greeting.jsp

       </result>

    </action>

    <action name="bar" class="mypackage.simpleAction">

       <result name="success" type="dispatcher">bar1.jsp</result>

    </action>

</package>

<package name="mypackage1" namespace="/">

    <action name="moo" class="mypackage.simpleAction">

        <result name="success" type="dispatcher">moo.jsp</result>

    </action>

</package>

<package name="mypackage2" namespace="/barspace">

    <action name="bar" class="mypackage.simpleAction">

       <result name="success" type="dispatcher">bar2.jsp</result>

    </action>

</package>

1 如果请求为/barspace/bar.action

查找namespace/barspace,如果找到bar则执行对应的action,否则将会查找默认的namespace,在上面的例子中,在barspace中存在名字位bar的action,所以这个action将会被执行,如果返回结果为success,则画面将定为到bar2.jsp

2 如果请求为/ moo.action

根namespace('/')被查找,如果moo action存在则执行否则查询默认的namespace,上面的例子中,根namespace中存在moo action,所以改action被调用,返回success的情况下画面将定位到moo.jsp

Action配置

在struts2框架中每一个Action是一个工作单元。Action负责将一个请求对应到一个Action处理上去,每当一个Action类匹配一个请求的时候,这个Action类就会被Struts2框架调用。

一个Action配置示例:

<action name="Logon" class="tutorial.Logon">

 <result type="redirect-action">Menu</result>

 <result name="input">/tutorial/Logon.jsp</result>

</action>

每一个Action可以配置多个result,多个ExceptionHandler,多个Intercepter,但是只能有一个name,这个name和package的namespace来唯一区别一个Action。

每当struts2框架接受到一个请求的时候,他会去掉Host,Application和后缀等信息,得到Action的名字,例如如下的请求将得到Welcome这个Action。

http://www.planetstruts.org/struts2-mailreader/Welcome.action

在一个Struts2应用程序中,一个指向Action的链接通常有Struts Tag产生,这个Tag只需要指定Action的名字,Struts框架会自动添加诸如后缀等的扩展,例如:

<s:form action="Hello">

    <s:textfield label="Please enter your name" name="name"/>

    <s:submit/>

</s:form>

将产生一个如下的链接的请求:

http://Hostname:post/appname/Hello.action

 

在定义Action的名字的时候不要使用.和/来明明,最好使用英文字母和下划线。

Action中的方法

Action的默认入口方法由xwork2的Action接口来定义,代码清单为:

public interface Action {

    public String execute() throws Exception;

}

有些时候我们想指定一个Action的多个方法,我们可以做如下两步:

<!--[if !supportLists]-->1    <!--[endif]-->建立一些execute签名相同的方法,例如:

Public String forward() throws Exception

<!--[if !supportLists]-->2    <!--[endif]-->在Action配置的时候使用method属性,例如:

    <action name="delete" class="example.CrudAction" method="delete">

Action中的方法通配符

有些时候对Action中方法的调用满足一定的规律,例如edit Action对应edit方法,delete Action对应 delete方法,这个时候我们可以使用方法通配符,例如:

<action name="*Crud" class="example.Crud" method="{1}">

这时,editCrud Action的引用将调用edit方法,同理,deleteCrud Action的引用将调用delete 方法。

另外一种比较常用的方式是使用下划线分割,例如:

<action name="Crud_*" class="example.Crud" method="{1}">

这样当遇到如下调用的时候可以找到对应的方法。

"action=Crud_input"  => input方法

"action=Crud_delete" => delete方法

通配符和普通的配置具有相同的地位,可以结合使用框架的所有其他功能。

默认的Action

当我们没有指定Action的class属性的时候,例如:

<action name="Hello">

我们默认使用com.opensymphony.xwork.ActionSupport

ActionSupport有两个方法input和execute,每个方法都是简单的返回SUCCESS。

Post-Back Action

可以使用如下画面达到字画面刷新的效果

<s:form>

    <s:textfield label="Please enter your name" name="name"/>

    <s:submit/>

</s:form>

默认Action

通常情况下,请求的Action不存在的情况下,Struts2框架会返回一个Error画面:“404 - Page not found”,有些时候或许我们不想出现一个控制之外的错误画面,我们可以指定一个默认的Action,在请求的Action不存在的情况下,调用默认的Action,通过如下配置可以达到要求:

<package name="Hello" extends="action-default">

<default-action-ref name="UnderConstruction">

<action name="UnderConstruction">

 <result>/UnderConstruction.jsp</result>

</action>"

默认通配符

<action name="*" >

 <result>/{1}.jsp</result>

</action>

每个Action将会被映射到以自己名字明明的JSP上。

 Result配置

Action里提供了五个默认的返回值:

String SUCCESS = "success";

String NONE    = "none";

String ERROR   = "error";

String INPUT   = "input";

String LOGIN   = "login";

默认的一些配置

package下有如下配置

<result-types>

<result-type name="dispatcher"

class="org.apache.struts2.dispatcher.ServletDispatcherResult"

    default="true" />

</result-types>

如果一个Result的type没有设定的话,默认为dispthcher。Dispatcher的意思是转向一个JSP等的资源。

另外如果Result的name没有设定的话,默认为SUCCESS。

一个完整的Result的声明如下:

<result name="success" type="dispatcher">

    <param name="location">/ThankYou.jsp</param>

</result>

考虑到默认值可以写成:

<result>

    <param name="location">/ThankYou.jsp</param>

</result>

另外也可以简写为:

<result>/ThankYou.jsp</result>

另外为了方便,可以在package中设置一些全局的result,例如:

<global-results>

 <result name="error">/Error.jsp</result>

 <result name="invalid.token">/Error.jsp</result>

 <result name="login" type="redirect-action">Logon_input</result>

</global-results>

动态结果

有些时候,在Action执行完毕之后才知道Result的指向,可以使用如下的方法:

Action

private String nextAction;

public String getNextAction() {

    return nextAction;

}

public String execute() throws Exception {

 return “next”;

}

struts.xml

<action name="fragment" class="FragmentAction">

 <result name="next" type="redirect-action">${nextAction}</result>

</action>

3.4节 ActionSupport

Action类不一定非要实现Action接口或者集成ActionSupport类,也就是说Action可以是一个POJO对象,只不过提供一个返回String的方法。如果Action类不实现Action接口,也不从ActionSupport集成,则Struts框架通过Java的反射机制(Reflection)来调用Action类中的处理方法。

Action类的处理方法需要满足以下要求

1 public

2 返回String,框架根据返回值决定迁移的目的

3 (可选)抛出Exception,让Struts框架统一处理异常

3.5节 Exception Handling

Struts可以以声明的方式处理Action类抛出的异常。以声明的方式处理是指:所有的Action类的处理方法抛出的Exception会被框架统一处理,之后定向到预先定义的Result。处理这些异常的Action,Result等可以动态的配置。

Struts2自带一个默认的配置:struts-default.xml,在这个文件中预先定义了一些基本的操作,其中Exception Handling也在其中,参看下述代码:

...

<interceptors>

    ...

    <interceptor name="exception"

          class="com.opensymphony.xwork.interceptor.ExceptionMappingInterceptor"/>

    ...

</interceptors>

<interceptor-stack name="defaultStack">

    <interceptor-ref name="exception"/>

    <interceptor-ref name="alias"/>

    <interceptor-ref name="servlet-config"/>

    <interceptor-ref name="prepare"/>

    <interceptor-ref name="i18n"/>

    <interceptor-ref name="chain"/>

    <interceptor-ref name="debugging"/>

    <interceptor-ref name="profiling"/>

    <interceptor-ref name="scoped-model-driven"/>

    <interceptor-ref name="model-driven"/>

    <interceptor-ref name="fileUpload"/>

    <interceptor-ref name="checkbox"/>

    <interceptor-ref name="static-params"/>

    <interceptor-ref name="params"/>

    <interceptor-ref name="conversionError"/>

    <interceptor-ref name="validation">

        <param name="excludeMethods">input,back,cancel,browse</param>

    </interceptor-ref>

    <interceptor-ref name="workflow">

        <param name="excludeMethods">input,back,cancel,browse</param>

    </interceptor-ref>

</interceptor-stack>

...

要使用Struts2声明式异常处理,只需要将异常映射到result就可以了,可以用两种方法配置,一种方法是全局配置,针对所有的Action有效,另一种是针对具体的Action做配置,只针对具体的Action有效。

参看如下struts.xml 配置文件片段:

<package name="default">

      ...

      <global-results>

          <result name="login" type="redirect">/Login.action</result>

          <result name="Exception">/Exception.jsp</result>

      </global-results>

      <global-exception-mappings>

          <exception-mapping

exception="java.sql.SQLException" result="SQLException"/>

          <exception-mapping

exception="java.lang.Exception" result="Exception"/>

      </global-exception-mappings>

      ...

      <action name="DataAccess" class="com.company.DataAccess">

          <exception-mapping

exception="com.company.SecurityException" result="login"/>

          <result name="SQLException" type="chain">SQLExceptionAction</result>

          <result>/DataAccess.jsp</result>

      </action>

      ...

</package>

上述配置有如下结果

1 一个java.sql.SQLException异常将链接到SQLExceptionAction (上述文件中没有说明)

2 一个com.company.SecurityException将重新定位到login.action

3 其他从java.lang.Exception继承而来的Exception将会被定为到/Exception.jsp页面

3.6节 Intercepter拦截器

拦截器的运行时机在Action类运行之前和之后。拦截器使用Filter模式,将你需要执行的代码放在Action类处理方法之前或者之后执行。拦截器在开发程序的时候功能非常强大,通过使用拦截器可以完成校验,属性设置,安全,日志,程序剖析等功能。

拦截器可以彼此链接构成一个拦截器的栈,每一个拦截器本质上是一个Java类,都有一个常常的类名,为了方便使用,可以在Struts2框架中注册这些拦截器,例如:

<interceptor name="security" class="com.jpleasure.security.SecurityInterceptor"/>

 <interceptor-stack name="secureStack">

    <interceptor-ref name="security"/>

    <interceptor-ref name="defaultStack"/>

 </interceptor-stack>

</interceptors>

拦截器和拦截器栈可以混合使用来定义新的拦截器栈,在调用过程中,框架按照在拦截器栈中的顺序逐个调用这些拦截器。

可以在Package中定义默认的拦截器栈,例如:

<default-interceptor-ref name="secureStack"/>

当然每一个Action类也可以定义自己的拦截器栈,例如:

<action name="VelocityCounter"

                         class="org.apache.struts2.example.counter.SimpleCounter">

    <result name="success">...</result>

    <interceptor-ref name="defaultComponentStack"/>

</action>

3.7节 分离配置文件

可以在struts.xml中使用include标记将配置文件分离成不同的部分。

例如:

<!DOCTYPE struts PUBLIC

 "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"

 "http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>

    <include file="Home.xml"/>

    <include file="Hello.xml"/>

    <include file="Simple.xml"/>

    <include file="/util/POJO.xml"/>

</struts>

 

posted on 2008-10-08 14:36 Sky Yi 阅读(598) 评论(0)  编辑  收藏


只有注册用户登录后才能发表评论。


网站导航: