struts.xml配置

suunny 10年前
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>  <?xml version="1.0" encoding="UTF-8" ?>  
<!DOCTYPE struts PUBLIC  
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
    "http://struts.apache.org/dtds/struts-2.0.dtd">  
  </div>  </div>  如果是struts-2.1的dtd，示例代码如下：
 
java代码：查看复制到剪贴板打印
  </div>  <?xml version="1.0" encoding="UTF-8" ?>  
<!DOCTYPE struts PUBLIC  
    "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN"  
    "http://struts.apache.org/dtds/struts-2.1.dtd">  
  </div>  </div>  struts.xml文件的根元素是<struts>，它的dtd定义是：
 
java代码：查看复制到剪贴板打印
  </div>  <!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>  <!ELEMENT package (result-types?, interceptors?, default-interceptor-ref?, default-action-ref?, default-class-ref?, global-results?, global-exception-mappings?, action*)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <package name="hello" namespace="/javass" extends="struts-default">  
  </div>  </div>  A.1.4  action元素action元素用来配置一个动作，这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT action (param|result|interceptor-ref|exception-mapping)*>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <action name="helloworldAction" class="cn.javass.hello.struts2impl.action.HelloWorldAction" method="create">  
  </div>  </div>  A.1.5  include元素include元素用来引入其他相关模块的struts配置文件。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT include (#PCDATA)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <struts>  
    <include file="struts-user.xml"/>  
    <include file="struts-dep.xml"/>  
……  
</struts>  
  </div>  </div>  A.1.6  bean元素bean元素用来配置一个bean，可以是由Struts来创建这个bean，也可以是使用给定bean的静态方法。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT bean (#PCDATA)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <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>  <!ELEMENT constant (#PCDATA)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <bean name="um" type=”UserEbi” class="cn.javass.vo.UserModel">  
  </div>  </div>  A.1.8  unknown-handler-stack元素unknown-handler-stack元素用来配置当找不到某些资源的时候进行处理的处理器的栈。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT unknown-handler-stack (unknown-handler-ref*)>  
  </div>  </div>  简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <bean type="com.opensymphony.xwork2.UnknownHandler" name="handler1" class="com.opensymphony.xwork2.config.providers.SomeUnknownHandler"/>  
<bean type="com.opensymphony.xwork2.UnknownHandler" name="handler2" class="com.opensymphony.xwork2.config.providers.SomeUnknownHandler"/>  
<unknown-handler-stack>  
   <unknown-handler-ref name="handler1" />  
   <unknown-handler-ref name="handler2" />  
</unknown-handler-stack>  
  </div>  </div>  A.1.9  unknown-handler-ref元素unknown-handler-ref元素用来参照处理器。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT unknown-handler-ref (#PCDATA)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <bean type="com.opensymphony.xwork2.UnknownHandler" name="handler1" class="com.opensymphony.xwork2.config.providers.SomeUnknownHandler"/>  
<unknown-handler-stack>  
   <unknown-handler-ref name="handler1" />  
 </unknown-handler-stack>  
  </div>  </div>  A.1.10  default-action-ref元素default-action-ref元素用来配置默认的动作，如果在package里面找不到与当前URL对应的多座，那么就调用这个action。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT default-action-ref (#PCDATA)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <default-action-ref name=”helloAction”/>  
  </div>  </div>  A.1.11  default-interceptor-ref元素default-interceptor-ref元素用来配置默认的拦截器或拦截器栈，如果在action里面没有明确的定义或引用拦截器或拦截器栈，那么就调用这里配置的拦截器或拦截器栈。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT default-interceptor-ref (#PCDATA)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <default-interceptor-ref name="defaultStack"/>  
  </div>  </div>  A.1.12  default-class-ref元素default-class-ref元素用来配置默认的类，如果没有为某个Action指定具体的class值时，将自动引用这个默认的类。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT default-class-ref (#PCDATA)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <default-class-ref class="cn.javass.action.DefaultAction"/>  
  </div>  </div>  A.1.13  exception-mapping元素exception-mapping元素用来配置处理动作没有处理的例外。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT exception-mapping (#PCDATA|param)*>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
            <exception-mapping result="math-exception" exception="java.lang.ArithmeticException"/>  
            <exception-mapping result="math-exception" exception="java.lang.Exception"/>  
            <result name="math-exception">/error.jsp</result>  
            <result>/s2impl/welcome.jsp</result>  
        </action>  
  </div>  </div>  A.1.14  global-exception-mapping元素global-exception-mappings元素用来配置公共的exception-mapping，可以包含1到多个的exception-mapping元素。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT global-exception-mappings (exception-mapping+)>  
  </div>  </div>  A.1.15  global-results元素global-results元素用来配置公共的result，可以包含1到多个的result元素。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT global-results (result+)>  
  </div>  </div>  A.1.16  interceptor元素interceptor元素用来配置拦截器。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT interceptor (param*)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <package name="helloworld"  extends="struts-default">  
    <interceptors>  
            <interceptor name=“myInterceptor” class="cn.javass.action.action.MyInterceptor"/>  
        </interceptors>  
……  
</package>  
  </div>  </div>  A.1.17  interceptor-ref元素interceptor-ref元素用来应用拦截器或拦截器栈。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT interceptor-ref (param*)>  
  </div>  </div>  它有如下的属性：
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
            <result name="toWelcome">/s2impl/welcome.jsp</result>  
            <interceptor-ref name=“myInterceptor”/>  
            <interceptor-ref name="defaultStack"/>  
</action>  
  </div>  </div>         要注意：在Action里面配置了拦截器的引用，会覆盖掉默认的配置，因此通常需要再手动的引用defaultStack。
A.1.18  interceptor-stack元素interceptor-stack元素用来配置拦截器栈。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT interceptor-stack (interceptor-ref*)>  
  </div>  </div>  它有如下的属性：
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <interceptor-stack name="defaultStack">  
                <interceptor-ref name="exception"/>  
                <interceptor-ref name="alias"/>  
……  
</interceptor-stack>  
  </div>  </div>  A.1.19  interceptors元素interceptors元素用来包装多个拦截器。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT interceptors (interceptor|interceptor-stack)+>  
  </div>  </div>  简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <interceptors>  
            <interceptor name="alias" class="com.opensymphony.xwork2.interceptor.AliasInterceptor"/>  
            <interceptor name="autowiring" class="com.opensymphony.xwork2.spring.interceptor.ActionAutowiringInterceptor"/>  
……  
<interceptor-stack name="basicStack">  
    <interceptor-ref name="exception"/>  
    <interceptor-ref name="servletConfig"/>  
    <interceptor-ref name="prepare"/>  
    <interceptor-ref name="checkbox"/>  
    <interceptor-ref name="multiselect"/>  
    <interceptor-ref name="actionMappingParams"/>  
    <interceptor-ref name="params">  
        <param name="excludeParams">dojo\..*,^struts\..*</param>  
    </interceptor-ref>  
    <interceptor-ref name="conversionError"/>  
</interceptor-stack>  
……  
</interceptors>  
  </div>  </div>  A.1.20  param元素param元素用来嵌套在其他元素中，为这些元素设置参数，比如：action、result-type、interceptor等等。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT param (#PCDATA)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <result name="toWelcome" type="dispatcher">  
                <param name="location">/s2impl/welcome.jsp</param>  
                <param name="parse">true</param>  
</result>  
  </div>  </div>  A.1.21  result元素result元素用来为action指定结果。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT result (#PCDATA|param)*>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <result name="toWelcome" type="dispatcher">/welcome.jsp</result>  
  </div>  </div>  A.1.22  result-type元素result-type元素用来注册结果类型，也就是具体处理结果的类。这个元素的dtd定义如下：
 
java代码：查看复制到剪贴板打印
  </div>  <!ELEMENT result-type (param*)>  
  </div>  </div>  
简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <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>  <!ELEMENT result-types (result-type+)>  
  </div>  </div>  简单的配置示例：
 
java代码：查看复制到剪贴板打印
  </div>  <result-types>  
  <result-type name="chain" class="com.opensymphony.xwork2.ActionChainResult"/>  
  <result-type name="dispatcher" class="org.apache.struts2.dispatcher.ServletDispatcherResult" default="true"/>  
  ......  
</result-types>  
  </div>  </div>   
 
私塾在线网站原创

                            相关经验

                        
 struts.xml配置
 Struts2中struts.xml的Action配置详解
 Apache+Tomcat集群配置（完整配置）
 Tomcat配置Jconsole , JvisualVm 监控配置
目录