struts.xml详解博客分类： Struts2 strutsweb

程序员文章站 2024-03-20 16:13:34

...

一。常量配置

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的属性

Xml代码

< 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>子元素指定的

Xml代码

<!-指定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代码

<? 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 >
< constant name = "struts.i18n.encoding" value = "UTF-8" />
<!--
该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。
如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。
-->
< constant name = "struts.action.extension" value = "do" />
< constant name = "struts.serve.static.browserCache" value = "false" />
< constant name = "struts.configuration.xml.reload" value = "true" />
< constant name = "struts.devMode" value = "true" />
< constant name = "struts.ui.theme" value = "simple" />
< constant name = "struts.objectFactory" value = "spring" />
<!--
指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration
开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。
-->
< constant name = "struts.configuration"
value = "org.apache.struts2.config.DefaultConfiguration" />
< constant name = "struts.locale" value = "zh_CN" />
< constant name = "struts.i18n.encoding" value = "GBK" />
< constant name = "struts.objectFactory" value = "spring" > </ constant >
<!--
指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name
是默认装配模式)
-->
< constant name = "struts.objectFactory.spring.autoWire" value = "name" />
< cosntant name = "struts.objectFactory.spring.useClassCache" />
< cosntant name = "struts.objectTypeDeterminer" value = "tiger" />
< constant name = "struts.multipart.parser" value = "cos" />
< constant name = "struts.multipart.parser" value = "pell" />
< constant name = "struts.multipart.parser" value = "jakarta" />
< constant name = "struts.multipart.saveDir" value = "/tmpuploadfiles" />
< 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" />
< constant name = "struts.action.extension" value = "do" />
< constant name = "struts.serve.static.browserCache" value = "true" />
< constant name = "struts.enable.DynamicMethodInvocation" value = "true" />
< constant name = "struts.enable.SlashesInActionNames" value = "true" />
< constant name = "struts.tag.altSyntax" value = "true" />
< cosntant name = "struts.configuration.xml.reload" value = "true" />
< cosntant name = "struts.devMode" value = "true" />
< cosntant name = "struts.i18n.reload" value = "false" />
< cosntant name = "struts.ui.theme" value = "xhtml" />
< cosntant name = "struts.ui.templateDir" value = "template" />
< cosntant name = "struts.ui.templateSuffix" value = "ftl" />
< cosntant name = "struts.velocity.configfile" value = "velocity.properties" />
< cosntant name = "struts.velocity.contexts" value = "...." />
< cosntant name = "struts.velocity.toolboxlocation" value = "...." />
< cosntant name = "struts.url.http.port" value = "80" />
< cosntant name = "struts.url.https.port" value = "443" />
< 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" />
< cosntant name = "struts.freemarker.manager.classname"
value = "org.apache.struts2.views.freemarker.FreemarkerManager" />
< cosntant name = "struts.freemarker.templatesCache" value = "false" />
< cosntant name = "struts.freemarker.wrapper.altMap" value = "true" />
< cosntant name = "struts.xslt.nocache" value = "false" />
< cosntant name = "struts.configuration.files"
value = "struts-default.xml,struts-plugin.xml,struts.xml" />
< 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. 理解示例：

Xml代码

< struts >
< 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 name = "Showcase" >
< result > showcase.jsp </ result >
</ action >
< action name = "Date" class = "lee.DateAction" >
< result name = "success" > /date.jsp </ result >
</ action >
</ package >
< 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 >
< 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配置：

Xml代码

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

Html代码

< 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中就要是用命名空间来达到相同的效果。

Xml代码

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

Html代码

< 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 配置文件，一样包含ＤＴＤ等的声明)。

Xml代码

< 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

Java代码

public String intercept(ActionInvocation invocation) throws xception {
System.out.println("interceptor!!" );
String result=invocation.invoke();
return result;
}

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

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

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

Xml代码

< 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 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: 拦截器和拦截器栈是一个级别的,也就是说一个拦截器栈中包括许多拦截器, 一个拦截器栈中还可以包括许多拦截器栈,配置如下方式:

Xml代码

< 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.在引用使用;

Xml代码

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

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

Xml代码

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

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

Xml代码

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

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

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

3:抽象的拦截器类AbstractInterceptor

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

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

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

4:方法过滤拦截器MethodFilterInterceptor

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

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

Xml代码

< 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方法后,在渲染视图之前做一些事情；让某个类去实现这个接口；

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

Java代码

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;
}
}
转载自：http://terryjs.iteye.com/blog/772670

struts.xml详解博客分类： Struts2 strutsweb