Struts2详细配置文件说明

89竹林

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

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

1 F, ~: h  i$ x

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

8 U9 Z, Y5 K  t

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

: }5 B3 ~, R) H

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

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

二：配置文件的加载顺序

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. <!DOCTYPE struts PUBLIC      
   , t  d  t, q; f$ |, m, [
3.     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"      
   # k+ `% Q; h% u4 @3 |. O+ `$ ]
4.     "http://struts.apache.org/dtds/struts-2.0.dtd">     
   5 S: ^( q* k- J2 P" ^
5.      
   
6. <struts>     
   0 g3 t8 V: z* p" f
7.     <!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->     
   
8.     <constant name="struts.i18n.encoding" value="UTF-8" />     
   , L, Z, Y% @+ x+ f8 q
9.      
   
10.     <!--      
    
11.         该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。      
    
12.         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。      
    " Q$ M! X/ {% K) `" `
13.     -->     
    
14.     <constant name="struts.action.extension" value="do" />     
    
15.      
    8 {9 K* }( D1 r. t- X! ?2 c
16.     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->     
    % o. {5 q/ H8 D6 m; x# s+ a3 o: [/ M
17.     <constant name="struts.serve.static.browserCache" value="false" />     
    
18.      
    ; J$ A4 R! d: R. }" b
19.     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->     
    
20.     <constant name="struts.configuration.xml.reload" value="true" />     
    
21.      
    
22.     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->     
    
23.     <constant name="struts.devMode" value="true" />     
    ; \+ @2 B  Q* h6 X! W  P+ t
24.      
    - o/ R% f2 v9 J% n! ]% f- D" ~
25.     <!-- 默认的视图主题 -->     
    
26.     <constant name="struts.ui.theme" value="simple" />     
    * z( r6 b, F8 i3 B
27.      
    
28.     <!-- spring 托管 -->     
    
29.     <constant name="struts.objectFactory" value="spring" />     
    4 f8 h( z% ?6 I) E: l" t
30.      
    $ w/ I0 I7 M2 m1 ?& z" ?" f; ~
31.     <!--      
    
32.         指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration      
    3 |; q7 q6 ~& q
33.         开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。      
    * Y" {. g  s! Q, m. x2 W7 K
34.     -->     
    
35.     <constant name="struts.configuration"     
    / {' ~* D2 ]: B6 J% y% d. G. g9 a
36.         value="org.apache.struts2.config.DefaultConfiguration" />     
    ) E( h/ {$ r7 g! `3 N( E2 ?
37.      
    " F. C0 J) ]9 W
38.     <!-- 设置默认的locale和字符编码 -->     
    
39.     <constant name="struts.locale" value="zh_CN" />     
    & \* z& q0 Z) ~/ t( t
40.     <constant name="struts.i18n.encoding" value="GBK" />     
    ' ~9 F2 H: i5 H, B( a+ z
41.      
    ; T5 t# y+ p" s# z7 k" M
42.     <!-- 指定Struts的工厂类 -->     
    ; J. ?; {8 {- i0 k9 @: t  o
43.     <constant name="struts.objectFactory" value="spring"></constant>     
    
44.      
    , [+ V+ I2 {' K) }% N
45.     <!--      
    + N. d7 D( g6 p5 n5 L' D8 D
46.         指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name      
    
47.         是默认装配模式)      
    2 T# b; s5 c) Z* k! k/ ]5 q
48.     -->     
    
49.     <constant name="struts.objectFactory.spring.autoWire" value="name" />     
    3 v4 S. B( r- \( _& b0 L/ D
50.      
    
51.     <!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->     
    
52.     <cosntant name="struts.objectFactory.spring.useClassCache" />     
    , ]% c) n) U- F3 ]2 c7 ~4 ]5 q
53.      
    1 @$ S# S$ D' P/ S" t3 I. W
54.     <!-- 指定类型检查,包含tiger和notiger -->     
    + ^% p: Z2 k6 L7 M; R: L; u: N" W4 d5 Y
55.     <cosntant name="struts.objectTypeDeterminer" value="tiger" />     
    + i( j( C$ L" \
56.      
    
57.     <!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->     
    7 ~  g0 Y  f% }: \# u! b( }
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" />     
    6 C, T: b0 y; ?; y
64.      
    0 B" g  E0 d$ p& E2 u1 c
65.     <!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->     
    
66.     <constant name="struts.multipart.maxSize" value="2097152" />     
    ; e( b( _; w( Z6 V- Y8 @4 u
67.      
    
68.     <!--      
    : \/ J" R0 w( L
69.         该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖      
    
70.         struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文      
    
71.         件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)      
    
72.     -->     
    
73.     <constant name="struts.custom.properties"     
    
74.         value="application,org/apache/struts2/extension/custom" />     
    
75.               
    . [3 q- T+ J9 {2 A
76.     <!-- 指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper -->     
    ( ^- K/ T7 x- d3 f
77.     <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />     
    
78.      
    
79.     <!-- 指定action的后缀，默认为action -->     
    ! D1 e- l) C! {2 r; _
80.     <constant name="struts.action.extension" value="do" />     
    2 p$ C- Z0 z; G) _4 U7 ~
81.          
    . [% P2 ]$ ~  m" y. h, K
82.     <!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->     
    2 ~3 _6 `+ o6 e  P$ t! S6 O
83.     <constant name="struts.serve.static.browserCache" value="true" />     
    0 ~& @# r4 j# M% u. `' I
84.      
    # @/ H& e( w, \2 _( K
85.     <!-- 设置是否支持动态方法调用，true为支持，false不支持. -->     
    
86.     <constant name="struts.enable.DynamicMethodInvocation" value="true" />     
    - c8 k8 H' ]4 e( b
87.               
    
88.     <!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->     
    ) w1 G5 T/ }- C$ b$ `0 d
89.     <constant name="struts.enable.SlashesInActionNames" value="true" />     
    3 H3 n: D; ~4 Z) c6 j/ n
90.          
    
91.     <!-- 是否允许使用表达式语法，默认为true. -->     
    
92.     <constant name="struts.tag.altSyntax" value="true" />     
    
93.      
    ' E" r$ n+ M( s; u
94.     <!-- 设置当struts.xml文件改动时，是否重新加载 -->     
    
95.     <cosntant name="struts.configuration.xml.reload" value="true" />     
    
96.          
    ' K: D3 x& E. D' ]2 ?7 E" a6 i
97.     <!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->     
    0 Q( H/ s% Y+ _4 m% L3 u
98.     <cosntant name="struts.devMode" value="true" />     
    , H0 V) L# U9 ?8 {/ K( Z- F
99.      
    
100.     <!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->     
     
101.     <cosntant name="struts.i18n.reload" value="false" />     
     + Q; ^4 w) k0 r3 R6 G
102.      
     ! |- D2 U7 M* @/ p: E
103.     <!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->     
     ) b' P4 n+ o4 E; R
104.     <cosntant name="struts.ui.theme" value="xhtml" />     
     3 O' Y- K  P+ v; G+ }( D. H. d. \* S
105.               
     
106.     <!-- 模板目录 -->     
     ( C# S7 _0 `+ ~% ?5 K) F
107.     <cosntant name="struts.ui.templateDir" value="template" />     
     
108.      
     % r4 D& H$ _  i
109.     <!-- 设置模板类型. 可以为 ftl, vm, or jsp -->     
       V; ?. A3 e. r8 V& H6 @
110.     <cosntant name="struts.ui.templateSuffix" value="ftl" />     
     4 h3 h' L( ]! Q7 O
111.      
     
112.     <!-- 定位velocity.properties 文件. 默认velocity.properties -->     
     
113.     <cosntant name="struts.velocity.configfile" value="velocity.properties" />     
     
114.          
     ) \5 t4 o& f, g; l7 s& N  Z# \5 p! w
115.     <!-- 设置velocity的context. -->     
     ) }* Q! S* h# U% I! y
116.     <cosntant name="struts.velocity.contexts" value="...." />     
     % C0 T' s. ?' {3 z
117.          
     . B* d2 R$ o! I7 N4 c5 j$ _
118.     <!-- 定位toolbox -->     
     
119.     <cosntant name="struts.velocity.toolboxlocation" value="...." />     
     7 |+ ]1 I7 s  M; ^* n) u0 I5 O: B
120.      
     
121.     <!-- 指定web应用的端口 -->     
     
122.     <cosntant name="struts.url.http.port" value="80" />     
     
123.          
     9 q# {* }3 a0 b$ u
124.     <!-- 指定加密端口 -->            
     
125.     <cosntant name="struts.url.https.port" value="443" />     
     3 V6 T: F* h# n. ~; I
126.      
     
127.     <!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->     
     
128.     <cosntant name="struts.url.includeParams" value="get" />     
     ; w6 V: e1 A8 ~: a" E; z
129.      
     
130.     <!-- 设置要加载的国际化资源文件，以逗号分隔. -->     
     
131.     <cosntant name="struts.custom.i18n.resources" value="application" />     
     ! e* D6 r4 L2 c0 s+ b2 s
132.          
     
133.     <!-- 对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(),      
     
134.         像 WebLogic,Orion, and OC4J等，须设置成true,默认为false. -->     
     8 l/ @8 w- {' `
135.     <cosntant name="struts.dispatcher.parametersWorkaround" value="false" />        
     ; z5 i% w4 ~: }8 b0 t- y
136.      
     9 u* i& l2 B9 e) J6 ]
137.     <!-- 指定freemarker管理器 -->     
     1 ?" s* r7 Z+ W2 ~1 k
138.     <cosntant name="struts.freemarker.manager.classname" value="org.apache.struts2.views.freemarker.FreemarkerManager" />      
     9 @  L  |, {, W  G! c
139.      
     
140.     <!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->     
     + @/ V- }) e1 n; m
141.     <cosntant name="struts.freemarker.templatesCache" value="false" />         
     1 L; c3 ?: w: n% a
142.      
     
143.     <!-- 通常不需要修改此属性. -->     
     0 q* O; G! w+ _, Q
144.     <cosntant name="struts.freemarker.wrapper.altMap" value="true" />      
     
145.          
     1 [( e2 ~* [7 M( ?# {' R
146.     <!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->     
     
147.     <cosntant name="struts.xslt.nocache" value="false" />      
     
148.          
     
149.     <!-- 设置struts自动加载的文件列表. -->     
     ' O4 V; u+ Z  V
150.     <cosntant name="struts.configuration.files" value="struts-default.xml,struts-plugin.xml,struts.xml" />     
     , A' J9 ?9 Z3 S; r
151.               
     
152.     <!-- 设定是否一直在最后一个slash之前的任何位置选定namespace. -->     
     
153.     <cosntant name="struts.mapper.alwaysSelectFullNamespace" value="false" />     
     6 u8 c0 Q" o# H& y, V& B
154. </struts>   
     
155.   
     " ~) \2 z' Q# D' ^6 \0 b0 e
156.    
     
157.   
     
158. <struts>  
     
159.   
     % j4 ^  b" p2 w- t' x8 }% U
160.     <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->  
     
161.     <include file="struts-default.xml"></include>  
     9 u, u" s9 x- @* c% c
162.       
     ; V* F4 N& q1 \1 Q7 \+ t/ M
163.       
       ?( @9 j6 a; A0 |- j
164.     <!-- package提供了将多个Action组织为一个模块的方式  
     2 w! v- k0 {) K3 m) T
165.         package的名字必须是唯一的 package可以扩展 当一个package扩展自  
     
166.         另一个package时该package会在本身配置的基础上加入扩展的package  
     8 q' s+ J  q" n3 r( c
167.         的配置 父package必须在子package前配置   
     
168.         name：package名称  
     
169.         extends:继承的父package名称  
     
170.         abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false  
     - [/ c9 N: C. b5 o9 T
171.         namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action  
     % V9 E9 r1 b* Q% C9 b1 L0 W
172.      -->  
     ) S3 k, K  z: Z
173.     <package name="com.kay.struts2" extends="struts-default" namespace="/test">  
     
174.         <interceptors>  
     2 K: Z; m/ N9 a1 b$ J5 _
175.             <!-- 定义拦截器   
     $ s, T9 @5 i! p7 r8 y) i7 _5 q
176.                 name:拦截器名称  
     
177.                 class:拦截器类路径  
     % [9 w. j2 p" G; N& U
178.              -->  
     
179.             <interceptor name="timer" class="com.kay.timer"></interceptor>  
     
180.             <interceptor name="logger" class="com.kay.logger"></interceptor>  
     
181.             <!-- 定义拦截器栈 -->  
     ! N, H, z" [5 H% t
182.             <interceptor-stack name="mystack">  
     + Z: K* X# }+ e$ Y- d' D& n. \$ n
183.                 <interceptor-ref name="timer"></interceptor-ref>  
     ' Y" A$ b' s. l6 V0 I9 y2 A
184.                 <interceptor-ref name="logger"></interceptor-ref>  
     
185.             </interceptor-stack>  
     
186.         </interceptors>  
     ' L: H/ ]8 k: r
187.          
     
188.         <!-- 定义默认的拦截器 每个Action都会自动引用  
     
189.          如果Action中引用了其它的拦截器 默认的拦截器将无效 -->  
     ! L* n8 W: Q' g6 T+ m  j
190.         <default-interceptor-ref name="mystack"></default-interceptor-ref>  
     
191.          
     / W6 B. n' H& R# y/ e9 o+ h/ K
192.          
     1 Z7 ~0 S: A2 E  Z
193.         <!-- 全局results配置 -->  
     9 D7 a! w  y3 _( t' I
194.         <global-results>  
     
195.             <result name="input">/error.jsp</result>  
       b" [. {' s4 C6 P3 a6 P) x/ _
196.         </global-results>  
     
197.          
     
198.         <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)  
     
199.              name：action名称  
     2 z8 Q9 t% |. s) _) A' z) x: V
200.              class: 对应的类的路径  
     / b0 m- K+ q  p1 F0 G7 g
201.              method: 调用Action中的方法名  
     
202.         -->  
     0 P2 n5 e1 l# E, p( \6 L
203.         <action name="hello" class="com.kay.struts2.Action.LoginAction">  
     
204.             <!-- 引用拦截器  
     
205.                 name:拦截器名称或拦截器栈名称  
     
206.              -->  
     / r2 g7 y0 P4 Z, h
207.             <interceptor-ref name="timer"></interceptor-ref>  
     + {. o" v+ R) b
208.          
     
209.             <!-- 节点配置  
     3 {/ N$ k  w/ g* K7 |) O- |
210.                 name : result名称 和Action中返回的值相同  
     
211.                 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher  
     
212.              -->  
     
213.          <result name="success" type="dispatcher">/talk.jsp</result>  
     - S4 Q! ]& h) L' f) ~4 [5 L& K) Z
214.          <!-- 参数设置   
     
215.              name：对应Action中的get/set方法   
     , d1 c+ D- Z% u
216.          -->  
     # m9 y+ ~0 t4 g/ f1 d6 g
217.          <param name="url">http://www.sina.com</param>  
     
218.         </action>  
     2 R, d& q! N$ k+ w0 L4 c
219.     </package>  
     
220. </struts></b></font></font></font>

复制代码

这些是常用的struts配置文件常量,如果想把struts用好,就要懂得每个配置是怎么一回事.不光光需要学习技术,更要学习好理论知识.技术的高度是由理论知识的深度决定的.
7 d8 P8 E" L3 B2 H% R  j# H
# c5 p  Z) ]9 z2 F/ C$ D