Struts2详细配置文件说明

89竹林

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

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

/ _& j4 M" f5 z

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

+ Y0 a" G! Z$ Y5 O

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

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

. b0 P+ V7 t6 K& I1 R, d' S. I9 U

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

! p. C' ?( Q1 V* y% `- s

二：配置文件的加载顺序

4 V1 Z  c, A5 G0 D6 T. ]. H. h

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

& Y1 n7 ~( Q% {4 I  x

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

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

1. <font color="rgb(0, 0, 0)"><font face="SimSun"><font size="2"><b><?xml version="1.0" encoding="UTF-8" ?>     
   8 i9 K0 M8 V4 z% z" I
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.      
   ) ~2 C. K/ k0 K% ?1 [0 P
6. <struts>     
   
7.     <!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->     
   ' L6 s: |- W+ y6 ]  p! v* F
8.     <constant name="struts.i18n.encoding" value="UTF-8" />     
   7 |; Q( L- B2 _3 |8 O1 B
9.      
   
10.     <!--      
    6 {& h; `7 E+ f5 O
11.         该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。      
    
12.         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。      
    $ r0 @2 f2 Q+ r" k3 {* l
13.     -->     
    & o# Q& s$ q5 \' s  f
14.     <constant name="struts.action.extension" value="do" />     
    ) m) h2 f! ^7 C# \# z
15.      
    
16.     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->     
    
17.     <constant name="struts.serve.static.browserCache" value="false" />     
    
18.      
    
19.     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->     
    
20.     <constant name="struts.configuration.xml.reload" value="true" />     
    
21.      
    8 Y! p: t) S( |  W
22.     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->     
    
23.     <constant name="struts.devMode" value="true" />     
    
24.      
    
25.     <!-- 默认的视图主题 -->     
    
26.     <constant name="struts.ui.theme" value="simple" />     
    9 Q8 t$ R* \3 N# m: B9 X( H
27.      
    9 {2 o  ]1 d" `$ z' u1 s
28.     <!-- spring 托管 -->     
    5 g0 H# C; T* s5 B
29.     <constant name="struts.objectFactory" value="spring" />     
    
30.      
    
31.     <!--      
    
32.         指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration      
    
33.         开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。      
    * D6 r7 V: P" ^- w
34.     -->     
    % X! O' ?3 ~1 Z" Y) M- d+ c4 w
35.     <constant name="struts.configuration"     
    
36.         value="org.apache.struts2.config.DefaultConfiguration" />     
    ' a) c+ r* {1 Q& w* ^% Z& e! j' E
37.      
    
38.     <!-- 设置默认的locale和字符编码 -->     
    
39.     <constant name="struts.locale" value="zh_CN" />     
    
40.     <constant name="struts.i18n.encoding" value="GBK" />     
    , B3 c$ W& w  S8 a/ J
41.      
    
42.     <!-- 指定Struts的工厂类 -->     
    ' h( ^3 O! N! I3 ?4 C- j
43.     <constant name="struts.objectFactory" value="spring"></constant>     
    
44.      
    
45.     <!--      
    
46.         指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name      
    
47.         是默认装配模式)      
    
48.     -->     
    
49.     <constant name="struts.objectFactory.spring.autoWire" value="name" />     
    
50.      
    
51.     <!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->     
    
52.     <cosntant name="struts.objectFactory.spring.useClassCache" />     
    
53.      
      c3 D8 ^) }0 s' A. e" @, h3 i
54.     <!-- 指定类型检查,包含tiger和notiger -->     
    
55.     <cosntant name="struts.objectTypeDeterminer" value="tiger" />     
    ( r, w7 @# _0 H6 a; r( U1 ^
56.      
    
57.     <!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->     
    % g5 k' V7 W+ Q
58.     <constant name="struts.multipart.parser" value="cos" />     
    
59.     <constant name="struts.multipart.parser" value="pell" />     
    
60.     <constant name="struts.multipart.parser" value="jakarta" />     
    
61.      
    
62.     <!-- 指定上传文件时的临时目录，默认使用 javax.servlet.context.tempdir -->     
    
63.     <constant name="struts.multipart.saveDir" value="/tmpuploadfiles" />     
    1 E3 E# f* ]; t+ s9 \
64.      
    4 H/ d  I" D: K( K; S1 I& Z, J8 e
65.     <!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->     
    1 N+ Q0 g0 c$ [$ p
66.     <constant name="struts.multipart.maxSize" value="2097152" />     
    . @5 y# Z6 m- l4 |: Q6 t
67.      
    5 M! I4 c" z" `' `5 g
68.     <!--      
    
69.         该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖      
    
70.         struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文      
    
71.         件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)      
    ( D! |* d- J  O% l' _
72.     -->     
    ' O/ X- F4 P  z- G3 U1 Q8 L, ?
73.     <constant name="struts.custom.properties"     
    $ Y4 b! I( y1 T3 D9 f( E2 @- R
74.         value="application,org/apache/struts2/extension/custom" />     
    
75.               
    
76.     <!-- 指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper -->     
    3 @* L# y5 @9 _9 i" b/ t3 O9 d! _
77.     <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />     
    & n% D' A4 N" i: f% n0 C
78.      
    ( D& @& O9 G9 p6 |0 P8 c
79.     <!-- 指定action的后缀，默认为action -->     
      v3 ~7 k4 H0 J
80.     <constant name="struts.action.extension" value="do" />     
    
81.          
    
82.     <!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->     
    ( _3 A8 f" j6 c, l: ]
83.     <constant name="struts.serve.static.browserCache" value="true" />     
    
84.      
    
85.     <!-- 设置是否支持动态方法调用，true为支持，false不支持. -->     
    
86.     <constant name="struts.enable.DynamicMethodInvocation" value="true" />     
    
87.               
    ) H, n9 Z  X* k1 [# Y' e
88.     <!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->     
    2 M7 A! M7 a4 c8 C* Z! {
89.     <constant name="struts.enable.SlashesInActionNames" value="true" />     
    
90.          
    
91.     <!-- 是否允许使用表达式语法，默认为true. -->     
    
92.     <constant name="struts.tag.altSyntax" value="true" />     
    
93.      
    4 z* F1 v6 @6 j& A
94.     <!-- 设置当struts.xml文件改动时，是否重新加载 -->     
    
95.     <cosntant name="struts.configuration.xml.reload" value="true" />     
    3 z6 o) z7 h& b. G( ^$ A3 B- ~
96.          
    
97.     <!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->     
    ) P6 g: T4 |' M
98.     <cosntant name="struts.devMode" value="true" />     
    ; l3 f; `; k3 b+ f, o) Q9 k
99.      
    
100.     <!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->     
     9 G# P7 A- _7 b. _- R  S" T0 z
101.     <cosntant name="struts.i18n.reload" value="false" />     
     4 y# m2 t2 j5 t$ b) \+ o" C
102.      
     
103.     <!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->     
     8 x" r1 j) J7 W
104.     <cosntant name="struts.ui.theme" value="xhtml" />     
     9 {" G5 P7 r' a0 K
105.               
     
106.     <!-- 模板目录 -->     
     ! \- W( N+ C1 H1 L0 J
107.     <cosntant name="struts.ui.templateDir" value="template" />     
     
108.      
     * U0 \( ^9 z+ w( V9 Q0 G
109.     <!-- 设置模板类型. 可以为 ftl, vm, or jsp -->     
     
110.     <cosntant name="struts.ui.templateSuffix" value="ftl" />     
     : d! i( R7 _) |$ C2 h, b$ Y
111.      
     
112.     <!-- 定位velocity.properties 文件. 默认velocity.properties -->     
     
113.     <cosntant name="struts.velocity.configfile" value="velocity.properties" />     
     
114.          
     % T- O+ H. L8 `. g( [# F. Q
115.     <!-- 设置velocity的context. -->     
     , Y% `% M7 k3 {1 R
116.     <cosntant name="struts.velocity.contexts" value="...." />     
     $ m  g) ^! b- z6 @( T
117.          
     
118.     <!-- 定位toolbox -->     
     % s4 O  j3 F7 ~' ]" t4 E0 c& T
119.     <cosntant name="struts.velocity.toolboxlocation" value="...." />     
     # h/ c# c: B& ^! R, n1 t
120.      
     
121.     <!-- 指定web应用的端口 -->     
     
122.     <cosntant name="struts.url.http.port" value="80" />     
     : o+ H' g' h! {. `/ N# A  P
123.          
     # W$ S, x4 u* w' ^
124.     <!-- 指定加密端口 -->            
     
125.     <cosntant name="struts.url.https.port" value="443" />     
     7 T% T* P; b( {+ K0 M7 v
126.      
     * H8 g2 }) P, `! E' D
127.     <!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->     
     
128.     <cosntant name="struts.url.includeParams" value="get" />     
     
129.      
     7 v3 o+ ~4 H3 E1 x% N% S
130.     <!-- 设置要加载的国际化资源文件，以逗号分隔. -->     
     
131.     <cosntant name="struts.custom.i18n.resources" value="application" />     
     ' ~* p) [3 i" f% P% o6 ~' m
132.          
     
133.     <!-- 对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(),      
     
134.         像 WebLogic,Orion, and OC4J等，须设置成true,默认为false. -->     
     
135.     <cosntant name="struts.dispatcher.parametersWorkaround" value="false" />        
     
136.      
     
137.     <!-- 指定freemarker管理器 -->     
     
138.     <cosntant name="struts.freemarker.manager.classname" value="org.apache.struts2.views.freemarker.FreemarkerManager" />      
     , V. ~6 a0 ~" r, O+ p/ X
139.      
     6 x+ W2 @& `: _9 X3 `+ X
140.     <!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->     
     * H0 j7 r' u# T5 C. D( o
141.     <cosntant name="struts.freemarker.templatesCache" value="false" />         
     , T+ O& Q  c1 z8 c  X7 {& I$ \7 g6 W$ L
142.      
     
143.     <!-- 通常不需要修改此属性. -->     
     
144.     <cosntant name="struts.freemarker.wrapper.altMap" value="true" />      
     + n( L1 Y7 P4 a, C, ?& Y0 X
145.          
     % r# a+ \1 K* o1 e/ h  D
146.     <!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->     
       z. P: z8 s4 m' _8 I  d$ b
147.     <cosntant name="struts.xslt.nocache" value="false" />      
     4 m4 K6 o+ q4 X4 d( R
148.          
     , {* G* P5 r( `! f
149.     <!-- 设置struts自动加载的文件列表. -->     
     
150.     <cosntant name="struts.configuration.files" value="struts-default.xml,struts-plugin.xml,struts.xml" />     
     
151.               
     % |4 M4 |; P2 ~! a# n  Z
152.     <!-- 设定是否一直在最后一个slash之前的任何位置选定namespace. -->     
     
153.     <cosntant name="struts.mapper.alwaysSelectFullNamespace" value="false" />     
     / F/ B* X( p- z- U3 l. h7 u$ J
154. </struts>   
     3 c5 j/ c4 B7 S- C
155.   
       c' S$ r; R& n" t$ k1 ?2 f  J
156.    
     
157.   
     
158. <struts>  
     
159.   
     
160.     <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->  
     ( ~0 u( d" N2 E7 e/ Y  f1 ]
161.     <include file="struts-default.xml"></include>  
     ; ]& q( {: k- D2 }5 j1 u; k$ {( b* O6 Y
162.       
     ) a4 i9 A2 q; X: B2 t
163.       
     5 ~& e- w2 }7 Z' \" s, _- N  b
164.     <!-- package提供了将多个Action组织为一个模块的方式  
     
165.         package的名字必须是唯一的 package可以扩展 当一个package扩展自  
     6 ]) J6 ]  i  N6 k1 |. Y% O
166.         另一个package时该package会在本身配置的基础上加入扩展的package  
     ( v& V% g* V2 y) s; P% A/ U# w
167.         的配置 父package必须在子package前配置   
     0 y3 u: J4 O# I
168.         name：package名称  
     : o& {4 N7 \& u& e
169.         extends:继承的父package名称  
       {4 ~& }) r# d: b0 O
170.         abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false  
     
171.         namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action  
     0 |. {9 y4 L2 Q3 G5 l
172.      -->  
     6 J" \2 X( L. H" ?0 z, g/ G) _
173.     <package name="com.kay.struts2" extends="struts-default" namespace="/test">  
     ! f' J/ R  Z7 g1 Y7 N. G
174.         <interceptors>  
     : N1 ~+ }! y$ E" r/ A
175.             <!-- 定义拦截器   
     
176.                 name:拦截器名称  
     # y3 ^/ p3 H4 c+ b% n
177.                 class:拦截器类路径  
     
178.              -->  
     - z. j8 E! n, Z2 {) d# @
179.             <interceptor name="timer" class="com.kay.timer"></interceptor>  
     6 V  ~6 E* C! ^7 y8 g3 Y) a+ |
180.             <interceptor name="logger" class="com.kay.logger"></interceptor>  
     
181.             <!-- 定义拦截器栈 -->  
     
182.             <interceptor-stack name="mystack">  
     . R% {2 i  S9 ~+ P5 o3 C% q
183.                 <interceptor-ref name="timer"></interceptor-ref>  
     
184.                 <interceptor-ref name="logger"></interceptor-ref>  
     
185.             </interceptor-stack>  
     ; R; T( G8 E: m2 J; {) J- @
186.         </interceptors>  
     * }/ u8 l( u& \* w) G1 F% W
187.          
     / p& Q: C% m9 }+ ^# y- K- r
188.         <!-- 定义默认的拦截器 每个Action都会自动引用  
     
189.          如果Action中引用了其它的拦截器 默认的拦截器将无效 -->  
     
190.         <default-interceptor-ref name="mystack"></default-interceptor-ref>  
     
191.          
     ; ^6 l3 b+ ?  [1 E. K' S# B
192.          
     
193.         <!-- 全局results配置 -->  
     / e6 q! @5 {" m; w7 I" v" ^; F
194.         <global-results>  
     ) Z3 k1 ]) ~8 e6 E
195.             <result name="input">/error.jsp</result>  
     
196.         </global-results>  
     ; J! U* p- t% z- ]( _
197.          
     
198.         <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)  
     5 G" V- C: T& ]) ^2 I
199.              name：action名称  
     ) m2 }* x: y0 e2 ^; G5 |8 W' n  H
200.              class: 对应的类的路径  
     5 V# g2 S+ D- L
201.              method: 调用Action中的方法名  
     
202.         -->  
       }1 F" v, q0 w' U/ h' V( o
203.         <action name="hello" class="com.kay.struts2.Action.LoginAction">  
     1 y" t$ ^; s5 H! w! d
204.             <!-- 引用拦截器  
     1 Z  A7 x# Q# m7 G
205.                 name:拦截器名称或拦截器栈名称  
     
206.              -->  
     + K- g$ Q$ m  T+ U4 D* z* {
207.             <interceptor-ref name="timer"></interceptor-ref>  
     1 L: g# I0 G  k
208.          
     9 Z  A, u5 i1 N/ a9 ]
209.             <!-- 节点配置  
     
210.                 name : result名称 和Action中返回的值相同  
     
211.                 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher  
     7 H; o1 |; \! U, }5 E) x: `
212.              -->  
     
213.          <result name="success" type="dispatcher">/talk.jsp</result>  
     
214.          <!-- 参数设置   
     5 D, |4 J* x$ Y! Q7 r7 F7 E1 Z
215.              name：对应Action中的get/set方法   
     . k8 o0 f$ R: F) ~0 G( {" w  K; \
216.          -->  
     / H! F4 F/ }7 E/ w6 U
217.          <param name="url">http://www.sina.com</param>  
     
218.         </action>  
     
219.     </package>  
     
220. </struts></b></font></font></font>

复制代码

这些是常用的struts配置文件常量,如果想把struts用好,就要懂得每个配置是怎么一回事.不光光需要学习技术,更要学习好理论知识.技术的高度是由理论知识的深度决定的.

, `# [( A' Y" P% q2 j