Struts2详细配置文件说明

89竹林

一：struts2的配置文件有哪些,相对应的作用是什么?

Web.xml:包含所有必须的框架组件的web部署描述符.Struts2主要加载前端控制器及初始化参数.

Struts.xml:定义应用自身使用的action映射,拦截器及常量,result/view定义.

Struts-default.xml:定义框架自身用的action映射及result

Struts-plugin.xml:struts插件使用的配置文件

; Z) K6 A; d8 |' Z. J3 f5 }& r

Struts.properties:定义框架自身的全局变量及框架属性.

5 g, q# ~0 x% u, I! c3 |

二：配置文件的加载顺序

$ l3 E6 C4 Q  {" w2 D7 A$ z$ D

Struts-default.xml-->struts-plugin.xml-->struts.xml-->struts.properties-->web.xml

注:若之前的配置文件设置过某一属性,则以后加载的配置文件对于相同的属性的设置,会覆盖之前的配置

三:Struts2常量的具体用法实例Xml代码

1. <font color="rgb(0, 0, 0)"><font face="SimSun"><font size="2"><b><?xml version="1.0" encoding="UTF-8" ?>     
   2 e) C% ^, ^5 D" u' n9 |! {; T# L
2. <!DOCTYPE struts PUBLIC      
   
3.     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"      
   
4.     "http://struts.apache.org/dtds/struts-2.0.dtd">     
   
5.      
   . b( z( N( H2 u/ `# L2 |
6. <struts>     
   5 c, Q& y) t! v  C
7.     <!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->     
   ; f  N/ X0 t4 l& I( N" Y
8.     <constant name="struts.i18n.encoding" value="UTF-8" />     
   
9.      
   # |, x. Q) ^. T) z. E$ y& x
10.     <!--      
    
11.         该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。      
    * |/ y( u4 V; j; \
12.         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。      
    , q) r3 h% W( }1 ?6 }( n  i
13.     -->     
    # L6 s' {3 `9 e3 _7 s
14.     <constant name="struts.action.extension" value="do" />     
    
15.      
    2 o6 w  A3 l& ]& k* b- o8 w
16.     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->     
    * B- U; s1 ^2 c( W3 h% C. n$ B
17.     <constant name="struts.serve.static.browserCache" value="false" />     
    ) G! B5 _/ L8 P1 R" ~8 f2 ~4 @
18.      
    : U$ m/ L6 d0 X, a: W, B! J% M, Z& X
19.     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->     
    
20.     <constant name="struts.configuration.xml.reload" value="true" />     
    % W/ Y0 F% P# P5 w, L
21.      
      m  z. |, ~. w# V3 b4 [  \- \
22.     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->     
    
23.     <constant name="struts.devMode" value="true" />     
    / y; |! P& J9 p9 b9 @3 d" a
24.      
    ! @. q! |% c; k# g
25.     <!-- 默认的视图主题 -->     
    
26.     <constant name="struts.ui.theme" value="simple" />     
    
27.      
    
28.     <!-- spring 托管 -->     
    3 b- D# ]/ q6 @
29.     <constant name="struts.objectFactory" value="spring" />     
    
30.      
    
31.     <!--      
    
32.         指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration      
    
33.         开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。      
    
34.     -->     
    , D! L+ |! }, _. @2 V: L
35.     <constant name="struts.configuration"     
    5 n- _/ o& T5 q0 F8 k9 D2 P
36.         value="org.apache.struts2.config.DefaultConfiguration" />     
    
37.      
    
38.     <!-- 设置默认的locale和字符编码 -->     
      Q3 Y: n1 Y7 t  v
39.     <constant name="struts.locale" value="zh_CN" />     
    
40.     <constant name="struts.i18n.encoding" value="GBK" />     
    
41.      
    
42.     <!-- 指定Struts的工厂类 -->     
    3 ^9 `, h5 c2 ~: K: w% }
43.     <constant name="struts.objectFactory" value="spring"></constant>     
    2 K$ b" C4 a0 F9 o) F) r
44.      
    0 S0 i1 ^( `3 P* P% J. ]
45.     <!--      
    ) U8 b, `$ r# G( L8 g/ E
46.         指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name      
    
47.         是默认装配模式)      
    6 F4 f+ S" B- \. V& ~$ C
48.     -->     
    
49.     <constant name="struts.objectFactory.spring.autoWire" value="name" />     
    ' S) a1 H- p5 [4 l
50.      
    
51.     <!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->     
    7 n' ^6 A( f$ @
52.     <cosntant name="struts.objectFactory.spring.useClassCache" />     
    - A) |  w3 H0 M/ j
53.      
    
54.     <!-- 指定类型检查,包含tiger和notiger -->     
    ) z6 J' q5 u+ I7 j5 m6 m/ r+ v' I
55.     <cosntant name="struts.objectTypeDeterminer" value="tiger" />     
    
56.      
    
57.     <!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->     
    
58.     <constant name="struts.multipart.parser" value="cos" />     
    8 \' q1 C" Q; X" `; _. f
59.     <constant name="struts.multipart.parser" value="pell" />     
    ! d" i1 e$ Q3 |
60.     <constant name="struts.multipart.parser" value="jakarta" />     
    
61.      
    
62.     <!-- 指定上传文件时的临时目录，默认使用 javax.servlet.context.tempdir -->     
      J0 _& x& |2 p& l# B& S# y
63.     <constant name="struts.multipart.saveDir" value="/tmpuploadfiles" />     
    $ n: o- P  u6 d6 {+ ]: V2 t; i* R6 S
64.      
    * B$ z" j/ T. w8 C/ w; _2 O
65.     <!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->     
    
66.     <constant name="struts.multipart.maxSize" value="2097152" />     
    . P$ @$ p$ ]+ r2 }0 @5 y3 E/ W
67.      
    
68.     <!--      
    
69.         该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖      
    * p2 h- x$ @- U1 c: w/ C
70.         struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文      
    - z0 ^/ V3 c& o9 ^
71.         件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)      
    8 Y% M+ n3 K8 W* C
72.     -->     
    
73.     <constant name="struts.custom.properties"     
    
74.         value="application,org/apache/struts2/extension/custom" />     
    % C! C8 u, _6 R, l7 ~# t9 ~
75.               
    4 J& H% ?7 l6 _) U
76.     <!-- 指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper -->     
    ) I; Q- {% d- c! y0 J
77.     <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />     
    
78.      
    5 w  q* c5 T) ]
79.     <!-- 指定action的后缀，默认为action -->     
    ' {0 Y2 [/ |4 P8 w
80.     <constant name="struts.action.extension" value="do" />     
    
81.          
    
82.     <!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->     
    
83.     <constant name="struts.serve.static.browserCache" value="true" />     
    # P$ W, o, C, V" K
84.      
    4 W7 h5 m% s+ {+ Y
85.     <!-- 设置是否支持动态方法调用，true为支持，false不支持. -->     
    
86.     <constant name="struts.enable.DynamicMethodInvocation" value="true" />     
    * M/ h" V; ]! D/ P/ R  }1 H
87.               
    
88.     <!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->     
    
89.     <constant name="struts.enable.SlashesInActionNames" value="true" />     
    
90.          
    # o4 z/ ]$ j/ m4 g
91.     <!-- 是否允许使用表达式语法，默认为true. -->     
    1 V1 S' c7 y" a; R2 j5 A& [9 L
92.     <constant name="struts.tag.altSyntax" value="true" />     
    
93.      
    
94.     <!-- 设置当struts.xml文件改动时，是否重新加载 -->     
    & b' J& D- @3 s1 T. y, a) U
95.     <cosntant name="struts.configuration.xml.reload" value="true" />     
    
96.          
    
97.     <!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->     
    , }! A/ a  I# U* g6 {
98.     <cosntant name="struts.devMode" value="true" />     
    + K% S; S0 T% d& D; C& t) V
99.      
    ; v. C! a' a+ h: K
100.     <!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->     
     
101.     <cosntant name="struts.i18n.reload" value="false" />     
     
102.      
     9 n1 K& m. b0 }0 P& N7 ]
103.     <!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->     
     
104.     <cosntant name="struts.ui.theme" value="xhtml" />     
     
105.               
     4 d' q6 k9 w: @! b. Z4 F& C
106.     <!-- 模板目录 -->     
     
107.     <cosntant name="struts.ui.templateDir" value="template" />     
     
108.      
     
109.     <!-- 设置模板类型. 可以为 ftl, vm, or jsp -->     
     
110.     <cosntant name="struts.ui.templateSuffix" value="ftl" />     
     
111.      
     " l* \" _# n0 T  T0 [& i
112.     <!-- 定位velocity.properties 文件. 默认velocity.properties -->     
     7 c' T5 @! |8 R* W- G) f* G
113.     <cosntant name="struts.velocity.configfile" value="velocity.properties" />     
     
114.          
     2 l! {* g0 X; [5 d3 L) ~: k9 D( h
115.     <!-- 设置velocity的context. -->     
     2 _& n% r* D! O) I0 T5 ?
116.     <cosntant name="struts.velocity.contexts" value="...." />     
     ' `) [/ V. L: s2 V9 }# w$ A
117.          
     
118.     <!-- 定位toolbox -->     
     
119.     <cosntant name="struts.velocity.toolboxlocation" value="...." />     
     
120.      
     9 _# @" J* P# p7 P2 T
121.     <!-- 指定web应用的端口 -->     
     + @- _/ D2 h4 W
122.     <cosntant name="struts.url.http.port" value="80" />     
     
123.          
     ) N- a5 D- {' B
124.     <!-- 指定加密端口 -->            
     
125.     <cosntant name="struts.url.https.port" value="443" />     
     
126.      
     
127.     <!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->     
     5 \+ b; K# a& d8 @; T/ r) q2 V, z, {
128.     <cosntant name="struts.url.includeParams" value="get" />     
     
129.      
     
130.     <!-- 设置要加载的国际化资源文件，以逗号分隔. -->     
     6 C& ?  l7 X, y! O( S7 i" P0 I
131.     <cosntant name="struts.custom.i18n.resources" value="application" />     
     
132.          
     
133.     <!-- 对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(),      
     
134.         像 WebLogic,Orion, and OC4J等，须设置成true,默认为false. -->     
     
135.     <cosntant name="struts.dispatcher.parametersWorkaround" value="false" />        
     
136.      
     7 j! q$ U$ i3 j
137.     <!-- 指定freemarker管理器 -->     
     2 E1 L8 z/ P, Z# R$ l
138.     <cosntant name="struts.freemarker.manager.classname" value="org.apache.struts2.views.freemarker.FreemarkerManager" />      
     
139.      
     ) O( H6 y4 x+ T9 n
140.     <!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->     
     % L8 i- c  T: v
141.     <cosntant name="struts.freemarker.templatesCache" value="false" />         
     . N2 w2 z$ v! y; R+ x* K! N: J% v
142.      
     
143.     <!-- 通常不需要修改此属性. -->     
     / T: O3 k0 t$ o1 k+ w2 }
144.     <cosntant name="struts.freemarker.wrapper.altMap" value="true" />      
     - _5 ]/ p: |5 O6 G: M
145.          
     
146.     <!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->     
     
147.     <cosntant name="struts.xslt.nocache" value="false" />      
     $ A$ o* W: `2 {+ [# ?4 m
148.          
     ' P2 f- S- n- X/ g$ S
149.     <!-- 设置struts自动加载的文件列表. -->     
     
150.     <cosntant name="struts.configuration.files" value="struts-default.xml,struts-plugin.xml,struts.xml" />     
     
151.               
     - g. f! V- i5 c" ?/ @
152.     <!-- 设定是否一直在最后一个slash之前的任何位置选定namespace. -->     
     
153.     <cosntant name="struts.mapper.alwaysSelectFullNamespace" value="false" />     
     
154. </struts>   
     
155.   
     # R( I0 A7 y7 I+ K% Y
156.    
       Z" v$ I; s/ ~* \6 Q
157.   
     8 q9 F' m5 t+ e  |; ?% }. }* K7 Q$ c
158. <struts>  
     
159.   
     # s. u, A1 U2 B  K5 a
160.     <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->  
     
161.     <include file="struts-default.xml"></include>  
     
162.       
     : ]$ u- p4 }, P0 G. G" O5 r3 }
163.       
     
164.     <!-- package提供了将多个Action组织为一个模块的方式  
     2 c5 A2 C8 t5 Z, ~) }3 K3 V! w
165.         package的名字必须是唯一的 package可以扩展 当一个package扩展自  
     
166.         另一个package时该package会在本身配置的基础上加入扩展的package  
     - C/ K' i; J# ^+ z  h, R$ l
167.         的配置 父package必须在子package前配置   
     9 c6 |( H7 @8 {- E  g
168.         name：package名称  
     3 t+ _: j; D/ H$ y
169.         extends:继承的父package名称  
     7 @9 C& ~6 W# @, P+ ^; _
170.         abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false  
     
171.         namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action  
     
172.      -->  
     & y. ^; _8 i( h
173.     <package name="com.kay.struts2" extends="struts-default" namespace="/test">  
     
174.         <interceptors>  
     - f2 d) l; W1 J+ N! G
175.             <!-- 定义拦截器   
     * |" z, @5 z. u( Z) P  m' T
176.                 name:拦截器名称  
     " A: x* @$ T! a) H; O
177.                 class:拦截器类路径  
     2 L# L# E% z6 N7 V0 q0 d1 P( O, W( s
178.              -->  
     
179.             <interceptor name="timer" class="com.kay.timer"></interceptor>  
     5 E& I0 i) j2 V8 `7 z
180.             <interceptor name="logger" class="com.kay.logger"></interceptor>  
     
181.             <!-- 定义拦截器栈 -->  
     
182.             <interceptor-stack name="mystack">  
     
183.                 <interceptor-ref name="timer"></interceptor-ref>  
     ; F& o$ C: w1 x: Z
184.                 <interceptor-ref name="logger"></interceptor-ref>  
     
185.             </interceptor-stack>  
     " G  Z! F  D9 H8 X( G0 G
186.         </interceptors>  
     
187.          
     
188.         <!-- 定义默认的拦截器 每个Action都会自动引用  
     % L1 o7 x% L$ _* i$ r3 f, K1 E% _
189.          如果Action中引用了其它的拦截器 默认的拦截器将无效 -->  
     
190.         <default-interceptor-ref name="mystack"></default-interceptor-ref>  
     
191.          
     
192.          
     
193.         <!-- 全局results配置 -->  
     
194.         <global-results>  
     1 s+ n* F; T! }& |2 k: M
195.             <result name="input">/error.jsp</result>  
     : [' t7 N3 ?4 h. v2 {0 f% q  X
196.         </global-results>  
     
197.          
     
198.         <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)  
     
199.              name：action名称  
     
200.              class: 对应的类的路径  
     & w/ w) x" X# k. i$ _# h
201.              method: 调用Action中的方法名  
     ; `# B; D7 W2 }6 ~
202.         -->  
     6 p6 x9 ^9 j! p
203.         <action name="hello" class="com.kay.struts2.Action.LoginAction">  
     3 c; D! f; D4 h
204.             <!-- 引用拦截器  
     
205.                 name:拦截器名称或拦截器栈名称  
     - `3 X- l- R! W; ~3 }! c& b* d) t
206.              -->  
     
207.             <interceptor-ref name="timer"></interceptor-ref>  
     & u3 o% p* a2 _" E( d3 p& }9 l
208.          
     
209.             <!-- 节点配置  
     % N: N2 }* }6 \
210.                 name : result名称 和Action中返回的值相同  
     # d1 h) U# Y7 }" k- _6 k3 U3 r
211.                 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher  
     1 y7 @# h7 \8 C3 a* Y- `7 E
212.              -->  
     ' L& W/ i- T' ]* p! B& }
213.          <result name="success" type="dispatcher">/talk.jsp</result>  
     ) Q! W9 o8 {3 D+ g  X, L
214.          <!-- 参数设置   
     
215.              name：对应Action中的get/set方法   
     ) q+ X# A. O) h
216.          -->  
     : T  L3 q; ^& R/ E/ P
217.          <param name="url">http://www.sina.com</param>  
     
218.         </action>  
     
219.     </package>  
     
220. </struts></b></font></font></font>

复制代码

这些是常用的struts配置文件常量,如果想把struts用好,就要懂得每个配置是怎么一回事.不光光需要学习技术,更要学习好理论知识.技术的高度是由理论知识的深度决定的.
: e" a5 k9 x) H" m
0 M, y0 }" L4 q, Z