struts.xml配置

suunny 8年前

A.1  struts.xml的配置

A.1.1  概述

前面已经分散学习了Struts2的各部分知识,相应的配置也分散到相关部分去学习了,这里再把这些配置的知识梳理和总结一下,以利于大家更好的掌握。

       Struts2的配置文件主要是struts.xml文件,以前还有一个struts.properties文件,现在struts.properties文件的内容基本上都可以在struts.xml文件进行配置,也就不再重要了。

A.1.2  DOCTYPE和根元素

       struts.xml文件必须包含如下的DOCTYPE的定义,如果是struts-2.0的dtd,示例代码如下:

 

java代码:
</div>
  1. <?xml version="1.0" encoding="UTF-8" ?>  
  2. <!DOCTYPE struts PUBLIC  
  3.     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
  4.     "http://struts.apache.org/dtds/struts-2.0.dtd">  
</div> </div>

如果是struts-2.1的dtd,示例代码如下:

 

java代码:
</div>
  1. <?xml version="1.0" encoding="UTF-8" ?>  
  2. <!DOCTYPE struts PUBLIC  
  3.     "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN"  
  4.     "http://struts.apache.org/dtds/struts-2.1.dtd">  
</div> </div>

struts.xml文件的根元素是<struts>,它的dtd定义是:

 

java代码:
</div>
  1. <!ELEMENT struts ((package|include|bean|constant)*, unknown-handler-stack?)>  
</div> </div>

unknown-handler-stack:这个是2.1的dtd加入的,用来配置当找不到某些资源的时候进行处理的处理器的栈。

A.1.3  package元素

用来逻辑上组织Struts的配置,这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT package (result-types?, interceptors?, default-interceptor-ref?, default-action-ref?, default-class-ref?, global-results?, global-exception-mappings?, action*)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <package name="hello" namespace="/javass" extends="struts-default">  
</div> </div>

A.1.4  action元素

action元素用来配置一个动作,这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT action (param|result|interceptor-ref|exception-mapping)*>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <action name="helloworldAction" class="cn.javass.hello.struts2impl.action.HelloWorldAction" method="create">  
</div> </div>

A.1.5  include元素

include元素用来引入其他相关模块的struts配置文件。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT include (#PCDATA)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <struts>  
  2.     <include file="struts-user.xml"/>  
  3.     <include file="struts-dep.xml"/>  
  4. ……  
  5. </struts>  
</div> </div>

A.1.6  bean元素

bean元素用来配置一个bean,可以是由Struts来创建这个bean,也可以是使用给定bean的静态方法。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT bean (#PCDATA)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <bean class="com.opensymphony.xwork2.ObjectFactory" name="xwork" />  
</div> </div>

A.1.7  constant元素

constant元素用来覆盖在default.properties文件里面配置的常量值。有了constant元素就不必再去配置struts.properties文件了,把struts.properties里面的配置,直接使用constant元素配置到struts.xml里面。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT constant (#PCDATA)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <bean name="um" type=”UserEbi” class="cn.javass.vo.UserModel">  
</div> </div>

A.1.8  unknown-handler-stack元素

unknown-handler-stack元素用来配置当找不到某些资源的时候进行处理的处理器的栈。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT unknown-handler-stack (unknown-handler-ref*)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <bean type="com.opensymphony.xwork2.UnknownHandler" name="handler1" class="com.opensymphony.xwork2.config.providers.SomeUnknownHandler"/>  
  2. <bean type="com.opensymphony.xwork2.UnknownHandler" name="handler2" class="com.opensymphony.xwork2.config.providers.SomeUnknownHandler"/>  
  3. <unknown-handler-stack>  
  4.    <unknown-handler-ref name="handler1" />  
  5.    <unknown-handler-ref name="handler2" />  
  6. </unknown-handler-stack>  
</div> </div>

A.1.9  unknown-handler-ref元素

unknown-handler-ref元素用来参照处理器。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT unknown-handler-ref (#PCDATA)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <bean type="com.opensymphony.xwork2.UnknownHandler" name="handler1" class="com.opensymphony.xwork2.config.providers.SomeUnknownHandler"/>  
  2. <unknown-handler-stack>  
  3.    <unknown-handler-ref name="handler1" />  
  4.  </unknown-handler-stack>  
</div> </div>

A.1.10  default-action-ref元素

default-action-ref元素用来配置默认的动作,如果在package里面找不到与当前URL对应的多座,那么就调用这个action。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT default-action-ref (#PCDATA)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <default-action-ref name=”helloAction”/>  
</div> </div>

A.1.11  default-interceptor-ref元素

default-interceptor-ref元素用来配置默认的拦截器或拦截器栈,如果在action里面没有明确的定义或引用拦截器或拦截器栈,那么就调用这里配置的拦截器或拦截器栈。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT default-interceptor-ref (#PCDATA)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <default-interceptor-ref name="defaultStack"/>  
</div> </div>

A.1.12  default-class-ref元素

default-class-ref元素用来配置默认的类,如果没有为某个Action指定具体的class值时,将自动引用这个默认的类。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT default-class-ref (#PCDATA)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <default-class-ref class="cn.javass.action.DefaultAction"/>  
</div> </div>

A.1.13  exception-mapping元素

exception-mapping元素用来配置处理动作没有处理的例外。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT exception-mapping (#PCDATA|param)*>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
  2.             <exception-mapping result="math-exception" exception="java.lang.ArithmeticException"/>  
  3.             <exception-mapping result="math-exception" exception="java.lang.Exception"/>  
  4.             <result name="math-exception">/error.jsp</result>  
  5.             <result>/s2impl/welcome.jsp</result>  
  6.         </action>  
</div> </div>

A.1.14  global-exception-mapping元素

global-exception-mappings元素用来配置公共的exception-mapping,可以包含1到多个的exception-mapping元素。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT global-exception-mappings (exception-mapping+)>  
</div> </div>

A.1.15  global-results元素

global-results元素用来配置公共的result,可以包含1到多个的result元素。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT global-results (result+)>  
</div> </div>

A.1.16  interceptor元素

interceptor元素用来配置拦截器。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT interceptor (param*)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <package name="helloworld"  extends="struts-default">  
  2.     <interceptors>  
  3.             <interceptor name=“myInterceptor” class="cn.javass.action.action.MyInterceptor"/>  
  4.         </interceptors>  
  5. ……  
  6. </package>  
</div> </div>

A.1.17  interceptor-ref元素

interceptor-ref元素用来应用拦截器或拦截器栈。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT interceptor-ref (param*)>  
</div> </div>

它有如下的属性:

简单的配置示例:

 

java代码:
</div>
  1. <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
  2.             <result name="toWelcome">/s2impl/welcome.jsp</result>  
  3.             <interceptor-ref name=“myInterceptor”/>  
  4.             <interceptor-ref name="defaultStack"/>  
  5. </action>  
</div> </div>

       要注意:在Action里面配置了拦截器的引用,会覆盖掉默认的配置,因此通常需要再手动的引用defaultStack。

A.1.18  interceptor-stack元素

interceptor-stack元素用来配置拦截器栈。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT interceptor-stack (interceptor-ref*)>  
</div> </div>

它有如下的属性:

简单的配置示例:

 

java代码:
</div>
  1. <interceptor-stack name="defaultStack">  
  2.                 <interceptor-ref name="exception"/>  
  3.                 <interceptor-ref name="alias"/>  
  4. ……  
  5. </interceptor-stack>  
</div> </div>

A.1.19  interceptors元素

interceptors元素用来包装多个拦截器。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT interceptors (interceptor|interceptor-stack)+>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <interceptors>  
  2.             <interceptor name="alias" class="com.opensymphony.xwork2.interceptor.AliasInterceptor"/>  
  3.             <interceptor name="autowiring" class="com.opensymphony.xwork2.spring.interceptor.ActionAutowiringInterceptor"/>  
  4. ……  
  5. <interceptor-stack name="basicStack">  
  6.     <interceptor-ref name="exception"/>  
  7.     <interceptor-ref name="servletConfig"/>  
  8.     <interceptor-ref name="prepare"/>  
  9.     <interceptor-ref name="checkbox"/>  
  10.     <interceptor-ref name="multiselect"/>  
  11.     <interceptor-ref name="actionMappingParams"/>  
  12.     <interceptor-ref name="params">  
  13.         <param name="excludeParams">dojo\..*,^struts\..*</param>  
  14.     </interceptor-ref>  
  15.     <interceptor-ref name="conversionError"/>  
  16. </interceptor-stack>  
  17. ……  
  18. </interceptors>  
</div> </div>

A.1.20  param元素

param元素用来嵌套在其他元素中,为这些元素设置参数,比如:action、result-type、interceptor等等。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT param (#PCDATA)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <result name="toWelcome" type="dispatcher">  
  2.                 <param name="location">/s2impl/welcome.jsp</param>  
  3.                 <param name="parse">true</param>  
  4. </result>  
</div> </div>

A.1.21  result元素

result元素用来为action指定结果。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT result (#PCDATA|param)*>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <result name="toWelcome" type="dispatcher">/welcome.jsp</result>  
</div> </div>

A.1.22  result-type元素

result-type元素用来注册结果类型,也就是具体处理结果的类。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT result-type (param*)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <result-type name="dispatcher" class="org.apache.struts2.dispatcher.ServletDispatcherResult" default="true"/>  
</div> </div>

A.1.23  result-types元素

result-types元素用来包含一个到多个result-type的定义。这个元素的dtd定义如下:

 

java代码:
</div>
  1. <!ELEMENT result-types (result-type+)>  
</div> </div>

简单的配置示例:

 

java代码:
</div>
  1. <result-types>  
  2.   <result-type name="chain" class="com.opensymphony.xwork2.ActionChainResult"/>  
  3.   <result-type name="dispatcher" class="org.apache.struts2.dispatcher.ServletDispatcherResult" default="true"/>  
  4.   ......  
  5. </result-types>  
</div> </div>

 

 

私塾在线网站原创