struts.xml 详解(一)

一。常量配置

 

1. 在struts2中配置常量的方式有三种：

       X 在struts.xml文件中配置
       X 在web.xml文件中配置 
       X 在sturts.propreties文件中配置

     注意： 1.之所以使用struts.propreties文件配置，是因为为了保持与WebWork的向后兼容

            2.在实际开发中，在web.xml中配置常量相比其他两种，需要更多的代码量，会降低了web.xml的可读性

            3.通常推荐在struts.xml文件中配置struts2的常量，而且便于集中管理 

2. 在sturt2中搜索加载常量的顺序是：

     struts-default.xml      (在struts2-core-2.0.6.jar文件中)
     struts-plugin.xml      （在struts2-Xxx-2.0.6.jar等Struts2插件JAR文件中）
     struts.xml             （Web应用默认的Struts2的配置文件）
     sturts.propreties       （Web应用默认的Struts2的配置文件）
     web.xml                 （Web应用下的配置文件）

    注意：1.若在不同的配置文件中同时配置了相同的Struts2常量，则后一个配置文件的常量值覆盖前一个配置的常量值

3. 配置文件的属性：name和value

         name:指定属性的常量名
　　　value：指定属性的值

   注意：1.在不同的配置文件中配置常量，虽然方式各异，但是都必须指定name、value这两个属性

4. 各种方式示例： 

   1.struts.xml:通过constant元素配置struts2的属性
     

<struts>
	<constant name="struts.custom.il8n.resources" value="mess" />
	....
</struts> 

 

       

        例1：指定国际化资源文件的baseName为mess


    2.sturts.propreties：<K-V>形式，K-name V-value

        struts.devMode=ture

        例2：名为struts.devMode的常量值为ture   

    3.web.xml:通过<filter>元素的<init-param>子元素指定的
       

<!-指定struts2的SilterDispatcher的Filter-!>
<filter>
  <!-指定Struts2的核心Filter-!>
  
	<filter-name>strurs2</filter-name>
	<filter-class>org.apache.struts2.dispatcher.FilterDispaycher
	</filter-class>

    <!-通过init-param元素配置struts2常量-!>

	<init-param>
		<param-name>struts.custom.il8n.resources</param-name>
		<param-value>mess</param-value>
	</init-param>

</filter> 

 

       例3：指定国际化资源文件的baseName为mess

 

 

   常量详解

 

<?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">

<struts>
	<!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->
	<constant name="struts.i18n.encoding" value="UTF-8" />

	<!--
		该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。
		如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。
	-->
	<constant name="struts.action.extension" value="do" />

	<!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->
	<constant name="struts.serve.static.browserCache" value="false" />

	<!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->
	<constant name="struts.configuration.xml.reload" value="true" />

	<!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->
	<constant name="struts.devMode" value="true" />

	<!-- 默认的视图主题 -->
	<constant name="struts.ui.theme" value="simple" />

	<!-- spring 托管 -->
	<constant name="struts.objectFactory" value="spring" />

	<!--
		指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration
		开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。
	-->
	<constant name="struts.configuration"
		value="org.apache.struts2.config.DefaultConfiguration" />

	<!-- 设置默认的locale和字符编码 -->
	<constant name="struts.locale" value="zh_CN" />
	<constant name="struts.i18n.encoding" value="GBK" />

	<!-- 指定Struts的工厂类 -->
	<constant name="struts.objectFactory" value="spring"></constant>

	<!--
		指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name
		是默认装配模式)
	-->
	<constant name="struts.objectFactory.spring.autoWire" value="name" />

	<!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->
	<cosntant name="struts.objectFactory.spring.useClassCache" />

	<!-- 指定类型检查,包含tiger和notiger -->
	<cosntant name="struts.objectTypeDeterminer" value="tiger" />

	<!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->
	<constant name="struts.multipart.parser" value="cos" />
	<constant name="struts.multipart.parser" value="pell" />
	<constant name="struts.multipart.parser" value="jakarta" />

	<!-- 指定上传文件时的临时目录，默认使用 javax.servlet.context.tempdir -->
	<constant name="struts.multipart.saveDir" value="/tmpuploadfiles" />

	<!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->
	<constant name="struts.multipart.maxSize" value="2097152" />

	<!--
		该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖
		struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文
		件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)
	-->
	<constant name="struts.custom.properties"
		value="application,org/apache/struts2/extension/custom" />

	<!--
		指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper
	-->
	<constant name="struts.mapper.class"
		value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />

	<!-- 指定action的后缀，默认为action -->
	<constant name="struts.action.extension" value="do" />

	<!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->
	<constant name="struts.serve.static.browserCache" value="true" />

	<!-- 设置是否支持动态方法调用，true为支持，false不支持. -->
	<constant name="struts.enable.DynamicMethodInvocation" value="true" />

	<!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->
	<constant name="struts.enable.SlashesInActionNames" value="true" />

	<!-- 是否允许使用表达式语法，默认为true. -->
	<constant name="struts.tag.altSyntax" value="true" />

	<!-- 设置当struts.xml文件改动时，是否重新加载 -->
	<cosntant name="struts.configuration.xml.reload" value="true" />

	<!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->
	<cosntant name="struts.devMode" value="true" />

	<!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->
	<cosntant name="struts.i18n.reload" value="false" />

	<!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->
	<cosntant name="struts.ui.theme" value="xhtml" />

	<!-- 模板目录 -->
	<cosntant name="struts.ui.templateDir" value="template" />

	<!-- 设置模板类型. 可以为 ftl, vm, or jsp -->
	<cosntant name="struts.ui.templateSuffix" value="ftl" />

	<!-- 定位velocity.properties 文件. 默认velocity.properties -->
	<cosntant name="struts.velocity.configfile" value="velocity.properties" />

	<!-- 设置velocity的context. -->
	<cosntant name="struts.velocity.contexts" value="...." />

	<!-- 定位toolbox -->
	<cosntant name="struts.velocity.toolboxlocation" value="...." />

	<!-- 指定web应用的端口 -->
	<cosntant name="struts.url.http.port" value="80" />

	<!-- 指定加密端口 -->
	<cosntant name="struts.url.https.port" value="443" />

	<!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->
	<cosntant name="struts.url.includeParams" value="get" />

	<!-- 设置要加载的国际化资源文件，以逗号分隔. -->
	<cosntant name="struts.custom.i18n.resources" value="application" />

	<!--
		对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(), 像
		WebLogic,Orion, and OC4J等，须设置成true,默认为false.
	-->
	<cosntant name="struts.dispatcher.parametersWorkaround" value="false" />

	<!-- 指定freemarker管理器 -->
	<cosntant name="struts.freemarker.manager.classname"
		value="org.apache.struts2.views.freemarker.FreemarkerManager" />

	<!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->
	<cosntant name="struts.freemarker.templatesCache" value="false" />

	<!-- 通常不需要修改此属性. -->
	<cosntant name="struts.freemarker.wrapper.altMap" value="true" />

	<!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->
	<cosntant name="struts.xslt.nocache" value="false" />

	<!-- 设置struts自动加载的文件列表. -->
	<cosntant name="struts.configuration.files"
		value="struts-default.xml,struts-plugin.xml,struts.xml" />

	<!-- 设定是否一直在最后一个slash之前的任何位置选定namespace. -->
	<cosntant name="struts.mapper.alwaysSelectFullNamespace"
		value="false" />
</struts>

 

 

二。包配置

1. 图片解释：

     1.struts2框架的核心组件是 Action和拦截器等，struts2框架使用包来管理Action和拦截器等的

     2.每个包就是多个Action、多个拦截器、多个拦截器引用的集合

2. 抽象包：除了正常的包之外，struts2还提供了抽象包

         定义：不包含action定义的包

         区分：该包的package元素增加abstract="true"

3. 包配置：

      在struts.xml中，使用package元素配置包的信息，每个package元素定义一个包的配置

      package元素可以定义的属性：

         name:必填属性，指定该包的名字，是引用该包的key

         extends:可选属性，指定该包是否可以继承其他的包：可以继承一个或多个父包的中Action定义、烂机器定义、拦截器栈等配置

         namespace:可选属性，定义该包的命名空间

         abstract:可选属性，指定该包是个抽象包，包中不能有Action的定义

    注意：Struts2的配置文件是从上到下处理的，所以父包应该在子包的前面~！（其实所有xml文件都是自上往下顺序执行的）

4. 理解示例：

 

<struts>
	<!-- 配置第一个包，该包名为defalut,继承struts-defalut -->
	<package name="default" extends="struts-defalut">

		<!-- 下面定义了拦截器部分-->
		<interceptors>

			<!--定义拦截器栈-->
			<interceptor-stack name="crudStack">
				<interceptor-ref name="params" />
				<interceptor-ref name="defalutStack" />
			</interceptor-stack>
		</interceptors>

		<default-action-ref name="showcase" />

		<!--定义一个Action，该Action直接映射到showcase.jsp页面-->
		<action name="Showcase">
			<result> showcase.jsp</result>
		</action>

		<!--定义一个Action,该Action类为com.opensymphony.webwork.showcase.DateAction-->
		<action name="Date" class="lee.DateAction">
			<result name="success">/date.jsp </result>
		</action>
	</package>

	<!--配置第二个包，该包名为skill,该包继承default包-->
	<package name="skill" extends="defalut" name="/skill">

		<!--	定义默认你的拦截器引用--> 
                <defalut-interceptor-ref name="crudStack"/>

		<!--定义名为Edit的Action,该类对应Action对应的处理类为lee.SkillAction
-->
		<action name="Edit" class="lee.SkillAction">
			<result>/empmanager/editSkill.jsp</result>
			<intercepor-ref name="params" />
			<interceptor-ref name="basicStack" />

		</action>

		<!--定义名为Save的Action，该Action对应的处理类为lee.SkillAction,使用save方法作为处理方法-->
		<action name="Save" class="lee.SkillAction" method="save">
			<result name="input">/empmanager/editSkill.jsp</result>
			<result type="redirect">edit.action?skillName=${currentSkill.name}
			</result>
		</action>
	</package>
</struts>  

 

 

 

三。命名空间配置

1.不使用命名空间的方式：

struts配置：

<struts>
	<include file="struts-default.xml" />
    <package name="com.casc.manager" extends="struts-default" 
        <action name="xxn" class="com.casc.manager.XxnAction">
            <result name="success">/success.jsp</result>
             <result name="error">/index.jsp</result>
             <result name ="input" >/index.jsp</result > 
        </action>
        
    </package>
</struts>

 

<form action="xxn.action" method="post">
        <s:text name="user.name"></s:text><input type="text" name="name"><br>
          <s:text name="user.password"></s:text><input type="password" name="password"><br>
          <input type="submit" value="<s:text name="user.submit"/>"/>
</form>

 

地址栏访问：http://localhost:9999/TDIAP/xxn.action

 

这样配置基本不会有问题。

可是在struts1.2里，我们习惯：path="/abc/xxn"

方便于在abc文件夹下操作。

 

2.这样在struts2.0中就要是用命名空间来达到相同的效果。

<struts>
	<include file="struts-default.xml" />
    <package name="com.casc.manager" extends="struts-default" namespace="/mng">
        <action name="xxn" class="com.casc.manager.XxnAction">
            <result name="success">/success.jsp</result>
             <result name="error">/index.jsp</result>
             <result name ="input" >/index.jsp</result > 
        </action>
    </package>
</struts>

 

 <form action="<%=request.getContextPath() %>/mng/xxn.action" method="post">
        <s:text name="user.name"></s:text><input type="text" name="name"><br>
          <s:text name="user.password"></s:text><input type="password" name="password"><br>
          <input type="submit" value="<s:text name="user.submit"/>"/>
</form>

 

这里主页 因为我们使用了命名空间“/mng”，如果在mng文件夹下的jsp页面我们可以直接写 action="xxn.action"

但在其他文件夹下就不行了。如果在mng上级目录尽量不要写成action="mng/xxn.action", 这样会成功但会出现问题，他很可能出现地址栏中http://localhost:9999/TDIAP/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng /xxn.action

这种情况。

安全起见 使用绝对路径：action="<%=request.getContextPath() %>/mng/xxn.action" 这样写不用考虑当前目录。

地址栏访问：http://localhost:9999/TDIAP/mng/ xxn.action  要把命名空间加上。

 

3.注意

    1. 对于包struts2：没有指定namespace属性。如果某个包没有指定namespace属性，即该包使用默认的命名空间，默认的命名空间总是""。

2. 对于包com.casc.manager：指定了命名空间/mng，则该包下所有的Act ion处理的URL应该是“命名空间/Act ion名”。

3. struts2先在指定的路径下找act ion,如果找不到则会去默认的路径找act ion

4. 命名空间只有一个级别，如果 /a/b/get.action,系统将先在 /a/b 的命名空间下查找，如果找不到，直接进去默认命名空间查找get.action ， 而不是在 /a 的命名空间下查找

5. Struts2以命名空间的方式来管理 Act ion，同一个命名空间不能有同名的Act ion。不同的命名空间 可以有 同名的 action.

 

四。包含配置

在Struts2中可以将一个配置文件分解成多个配置文件，那么我们必须在struts.xml中包含其他配置文件(注，所有的.xml文件都是标准的 Struts 2 配置文件，一样包含ＤＴＤ等的声明)。

<struts>
	<include file="struts-default.xml" />
	<include file="struts-user.xml" />
	<include file="struts-book.xml" />
</struts>

 

 

五。拦截器配置

1:所有拦截器的超级接口Interceptor ,Action去实现这个接口;

 Interceptor 它其中有三个方法(init(),destroy() ,interceptor()):

      Init()方法:在服务器起动的时候加载一次,并且只加载一次;

      Destroy()方法:当拦截器销毁时执行的方法;

      Interceptor()方法:其中里边有一个参数invocation

public String intercept(ActionInvocation invocation) throws xception {

       System.out.println("interceptor!!");

       String result=invocation.invoke();

       return result;

    }

 

Invocation.invoke()是如果只有一个拦截器执行完这个方法后,会返回给视图,如果有多个拦截器,它顺序的执行完所有的拦截器,才返回给视图.

2: 可以在系统初始化中给拦截器指定默认的参数(也包括了定义拦截器方式)如下:

    在拦截器类中把hello当做属性set/get方式注入到拦截器类中;

<interceptors>

	<!-- 先定义拦截器 -->

	<interceptor name="myInterceptor"
		class="com.zzz.struts2.interceptor.MyInterceptor">

		<!-- 指定系统初始化给拦截器的参数 -->

		<param name="hello">张钊钊</param>

	</interceptor>

	<!-- 加到自己设置的拦截器栈里边去 -->

	<interceptor-stack name="myStack">

		<interceptor-ref name="myInterceptor">

		</interceptor-ref>

		<interceptor-ref name="defaultStack"></interceptor-ref>

	</interceptor-stack>

</interceptors>

	<!--
		改变系统默认的拦截器,改成自己的默认拦截器,并且一个系统只能有一个默认的拦截器,这样这个拦截器栈会默认应用到所有的Action上去
	-->

<default-interceptor-ref name="myStack">

</default-interceptor-ref>
	<!--
也可以在使用拦截器的时候给它设置参数:

就是在一个action 的reslut下面配置上如下:
-->
<action name="register" class="com.zzz.struts2.action.RegisterAction">

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

	<!-- result 它其中还有一个信息转发类型 type=""记住，如果不转向JSP，转向图表，可以改变type=""值 -->

	<result name="input">/register.jsp</result>

	<interceptor-ref name="myInterceptor">

		<param name="hello">welcome</param>

	</interceptor-ref>

	<interceptor-ref name="myStack"></interceptor-ref>

</action>

 

     

2.拦截器,拦截器栈和默认的拦截器之间的关系

1: 拦截器和拦截器栈是一个级别的,也就是说一个拦截器栈中包括许多拦截器, 一个拦截器栈中还可以包括许多拦截器栈,配置如下方式:

<interceptors>

           <!-- 先定义拦截器 -->

           <interceptor name="myInterceptor" class="com.zzz.struts2.interceptor.MyInterceptor">

              <!-- 指定系统初始化给拦截器的参数 -->

              <param name="hello">张钊钊</param>

           </interceptor>

           <!-- 加到自己设置的拦截器栈里边去 -->

           <interceptor-stack name="myStack">

              <interceptor-ref name="myInterceptor">

              </interceptor-ref>

              <interceptor-ref name="defaultStack"></interceptor-ref>

           </interceptor-stack>

       </interceptors>

 

拦截器的使用:1.先定义;2.在引用使用;

<interceptor name="myInterceptor" class="com.zzz.struts2.interceptor.MyInterceptor">

<interceptor-ref name="myInterceptor">

              </interceptor-ref>

 

2: struts2中有一个系统默认的拦截器栈是 defaultStack,如果你手动引用自己的拦截器,系统默认的拦截器栈将不起作用;这样必需手动引入系统的拦截器栈

<interceptor-ref name="defaultStack">

              </interceptor-ref>

 

如果想改变系统默认的拦截器栈,可以这样配置:

<default-interceptor-ref name="myStack">

</default-interceptor-ref>

 其中myStack是自己定义的拦截器栈名字;

如果拦截器栈中有多个拦截器,在执行action之前的顺序跟配置拦截器的顺序一致,而在action之后执行的顺序是相反的;

 3:抽象的拦截器类AbstractInterceptor

1: Interceptor这个超级拦截器接口,有三方法需要实现,但是如果不想使用init();

    和destroy()方法,可以去继承这个抽象拦截器类;

它的使用跟上边的没有什么区别;

 4:方法过滤拦截器MethodFilterInterceptor

1: 上边的拦截器都要是针对整个action的,如果针对某个方法进行拦截可以去继承这个类;

它的使用跟上边的使用方法差不多,只是需要要配置它对那个方法进行拦截,方法过滤拦截器最好不要配置到自己设置默认的拦截器栈里边,自己手动配置.

<interceptor-ref name="myInterceptor3">
	<param name="includeMethods">execute</param>
	<param name="excludeMethods">execute</param>
</interceptor-ref>
<interceptor-ref name="defaultStack"></interceptor-ref>

 

其中includeMethods ,excludeMethods是固定写法: includeMethods 包含拦截那些方法,多个方法需要用”,”隔开; excludeMehtods是排除拦截的那些方法;

5:鉴听器PreResultListener接口

1: 它的鉴听点在拦截器执行完某个action方法后,在渲染视图之前做一些事情；让某个类去实现这个接口；

然后向需要它的拦截器中注册进去如下代码：

publicclass MyInterceptor3 extends MethodFilterInterceptor {

    privatestaticfinallongserialVersionUID = 3756655410194005443L;

    @Override

    protected String doIntercept(ActionInvocation invocation) throws Exception {

       //把鉴听器注册到拦截中去;

       invocation.addPreResultListener(new MyListener());

       System.out.println("my Interceptor3");

       String result=arg0.invoke();

       System.out.println("my interceptor3 finshed!");

       return result;

    }

}