Struts2详细配置文件说明

89竹林

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

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

8 ~0 x1 W3 B+ h+ G; T% ]

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

" J3 ~0 @0 y5 Y8 @' e/ o: D

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

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

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

6 f5 m8 o3 y3 d8 W0 V

二：配置文件的加载顺序

& y5 C% P( Z# M- |

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

/ T: w8 g% \' U: C

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

三: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      
   
3.     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"      
   7 u6 P  v! w- u4 R8 M
4.     "http://struts.apache.org/dtds/struts-2.0.dtd">     
     B2 i0 I5 j: M% f3 P
5.      
   
6. <struts>     
   # x: B  T+ a$ z$ U0 B, I/ M; {  U
7.     <!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->     
   / _! I; Z7 \, B/ n* n. S4 [/ m
8.     <constant name="struts.i18n.encoding" value="UTF-8" />     
   
9.      
   0 b8 W, ^0 S/ g$ s# i' w7 o6 }
10.     <!--      
    2 i: {% N# u* s, U  g& d
11.         该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。      
    ! Z; V3 C+ }( W' @) A" d# H/ D+ K$ g
12.         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。      
    
13.     -->     
      W* J, \0 c# [' X9 h# g
14.     <constant name="struts.action.extension" value="do" />     
    
15.      
    * a% P8 V) b+ h  U! c
16.     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->     
    0 @1 }/ V9 v0 \  j
17.     <constant name="struts.serve.static.browserCache" value="false" />     
    6 n1 J# t& v: N+ o. b& H0 P
18.      
    2 D3 ~6 x4 v5 n! b8 `  M* Y! C
19.     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->     
      M0 m3 o6 x& U  B2 Y5 c4 F6 `
20.     <constant name="struts.configuration.xml.reload" value="true" />     
    0 E# N! i  T5 q9 v% F' {3 F( a, M
21.      
    5 Z0 s4 e4 Y2 F2 h- ]
22.     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->     
    
23.     <constant name="struts.devMode" value="true" />     
    
24.      
    
25.     <!-- 默认的视图主题 -->     
    
26.     <constant name="struts.ui.theme" value="simple" />     
    8 C. E/ n  `( V. h; u0 m/ g
27.      
    , w: {0 H; L) U) I8 x
28.     <!-- spring 托管 -->     
    7 f. h/ N6 Z3 M4 M& k5 Q
29.     <constant name="struts.objectFactory" value="spring" />     
    0 B% w. U' p) T5 q0 |
30.      
    - @, t0 q% q0 N2 _) t/ @- N+ L
31.     <!--      
    ) _( u: e2 s# k" `6 p. u
32.         指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration      
    
33.         开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。      
    % j% }, `+ \+ F( D/ s! x" r
34.     -->     
    
35.     <constant name="struts.configuration"     
    3 f5 ^6 }1 g4 t% m. Q. I4 P; {4 \
36.         value="org.apache.struts2.config.DefaultConfiguration" />     
    " \! j! n' |( d% x* v
37.      
    * x$ s) f0 A- l- L- C  v
38.     <!-- 设置默认的locale和字符编码 -->     
    : ?2 {6 x2 ]4 C  X
39.     <constant name="struts.locale" value="zh_CN" />     
    
40.     <constant name="struts.i18n.encoding" value="GBK" />     
    6 ~' p: ^2 @* H! @, t- R
41.      
    
42.     <!-- 指定Struts的工厂类 -->     
    
43.     <constant name="struts.objectFactory" value="spring"></constant>     
    9 k  ^# c# B2 y+ [% t0 z
44.      
    
45.     <!--      
    ; g2 i! C* m& F1 ?7 A
46.         指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name      
    
47.         是默认装配模式)      
    
48.     -->     
    6 j  H; L+ m0 \( j# _& M2 D
49.     <constant name="struts.objectFactory.spring.autoWire" value="name" />     
    $ p! W. s& R- i0 F8 s
50.      
    
51.     <!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->     
    + K' Z! E3 s% f2 _/ p
52.     <cosntant name="struts.objectFactory.spring.useClassCache" />     
    - H% u) Z/ @3 ~
53.      
    
54.     <!-- 指定类型检查,包含tiger和notiger -->     
    
55.     <cosntant name="struts.objectTypeDeterminer" value="tiger" />     
    8 t0 \" U, j, X/ x* b8 L
56.      
    
57.     <!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->     
    
58.     <constant name="struts.multipart.parser" value="cos" />     
    
59.     <constant name="struts.multipart.parser" value="pell" />     
    ! m9 J* y. _0 p) Z8 E$ p
60.     <constant name="struts.multipart.parser" value="jakarta" />     
    . m5 ?/ M& R9 j/ ^0 K& F8 a
61.      
    
62.     <!-- 指定上传文件时的临时目录，默认使用 javax.servlet.context.tempdir -->     
    ' X* s; R( N0 @, J5 }
63.     <constant name="struts.multipart.saveDir" value="/tmpuploadfiles" />     
    1 o: v  B# C; \' u' f/ T
64.      
    ! N' w- n. G" E' W, Z$ a5 h1 h- S3 S
65.     <!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->     
    : L9 H1 k6 T' m# ~" B, @; D! L% M
66.     <constant name="struts.multipart.maxSize" value="2097152" />     
    
67.      
    ) g2 n0 O1 k/ ~* b* I& {
68.     <!--      
    , c  I# R8 W( |# {9 ~" |
69.         该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖      
    
70.         struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文      
    ) I; v( V! i: ~& o
71.         件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)      
    8 S: s9 W% T: D7 P+ B6 x
72.     -->     
    
73.     <constant name="struts.custom.properties"     
    
74.         value="application,org/apache/struts2/extension/custom" />     
    
75.               
    + V: o: C9 w0 ?# }
76.     <!-- 指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper -->     
    . E! ?8 e1 J8 s( l6 _, b3 _$ r7 v
77.     <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />     
    ! y; S: \1 g) c+ C( K  f
78.      
    
79.     <!-- 指定action的后缀，默认为action -->     
    
80.     <constant name="struts.action.extension" value="do" />     
    5 E3 _7 w+ x4 C2 \
81.          
    
82.     <!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->     
    $ m+ f; h3 p# g0 H
83.     <constant name="struts.serve.static.browserCache" value="true" />     
    - n+ \! o- E  @" n
84.      
    1 x8 C: o& |4 a" H6 o) A, z" `
85.     <!-- 设置是否支持动态方法调用，true为支持，false不支持. -->     
      M" E1 ^+ p, J3 Q- p' X( i2 i+ w
86.     <constant name="struts.enable.DynamicMethodInvocation" value="true" />     
    
87.               
    
88.     <!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->     
    
89.     <constant name="struts.enable.SlashesInActionNames" value="true" />     
    ! ?4 x: J1 ^0 f
90.          
    
91.     <!-- 是否允许使用表达式语法，默认为true. -->     
    ) [0 b* B2 f1 e  M
92.     <constant name="struts.tag.altSyntax" value="true" />     
    
93.      
    
94.     <!-- 设置当struts.xml文件改动时，是否重新加载 -->     
    4 V" R; L! {7 s1 X  F! o
95.     <cosntant name="struts.configuration.xml.reload" value="true" />     
    
96.          
    + M- y& ^: o: ?. m- |
97.     <!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->     
    
98.     <cosntant name="struts.devMode" value="true" />     
    
99.      
    
100.     <!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->     
     4 t2 X0 q# A5 k& r
101.     <cosntant name="struts.i18n.reload" value="false" />     
     
102.      
     " Z; x/ K) B7 f: I3 T" g* u, W0 `
103.     <!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->     
     % k" w9 s+ P' z0 S/ |2 D# g- Z: V/ |- s
104.     <cosntant name="struts.ui.theme" value="xhtml" />     
     
105.               
     2 d2 f. X8 f+ O
106.     <!-- 模板目录 -->     
     
107.     <cosntant name="struts.ui.templateDir" value="template" />     
     ! ?4 I0 r& y, ]/ K! C! e9 t9 P
108.      
     " a! L- ]. M5 D6 s# F
109.     <!-- 设置模板类型. 可以为 ftl, vm, or jsp -->     
     
110.     <cosntant name="struts.ui.templateSuffix" value="ftl" />     
     
111.      
     
112.     <!-- 定位velocity.properties 文件. 默认velocity.properties -->     
     
113.     <cosntant name="struts.velocity.configfile" value="velocity.properties" />     
     4 l  g8 _0 E8 H
114.          
     
115.     <!-- 设置velocity的context. -->     
     9 I6 H, h% G% [
116.     <cosntant name="struts.velocity.contexts" value="...." />     
     
117.          
     " b! {3 H: X1 K- {$ {
118.     <!-- 定位toolbox -->     
     " K- |1 c6 w8 K# c& |* U
119.     <cosntant name="struts.velocity.toolboxlocation" value="...." />     
     
120.      
     
121.     <!-- 指定web应用的端口 -->     
     , F6 ~0 `8 q5 I7 V* o
122.     <cosntant name="struts.url.http.port" value="80" />     
     , N3 a( h5 g" V& x
123.          
     : }' a+ ~( T2 h( g3 S' A9 ~3 q
124.     <!-- 指定加密端口 -->            
     * C8 u$ s/ b: j+ G, n* w/ `2 z# f
125.     <cosntant name="struts.url.https.port" value="443" />     
     
126.      
     
127.     <!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->     
     % p  V- h1 u9 Q/ e# Q: n5 [: t8 O
128.     <cosntant name="struts.url.includeParams" value="get" />     
     
129.      
     
130.     <!-- 设置要加载的国际化资源文件，以逗号分隔. -->     
     6 v0 b' W$ b, a
131.     <cosntant name="struts.custom.i18n.resources" value="application" />     
     ) ~) J2 c$ ?) f+ T' ~5 T. B( c
132.          
     
133.     <!-- 对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(),      
     
134.         像 WebLogic,Orion, and OC4J等，须设置成true,默认为false. -->     
     0 e$ i4 b; y- R* H
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" />      
     " O! ]/ ?7 j! A5 K
139.      
     4 a- L6 G! n" p2 L
140.     <!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->     
     
141.     <cosntant name="struts.freemarker.templatesCache" value="false" />         
     
142.      
     
143.     <!-- 通常不需要修改此属性. -->     
     / T/ q) \. G8 _, x. \$ a7 u
144.     <cosntant name="struts.freemarker.wrapper.altMap" value="true" />      
     5 M9 b9 h- E# o- g0 W# [  G1 {
145.          
     
146.     <!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->     
     6 g3 P2 t+ z; @* _! Q0 w
147.     <cosntant name="struts.xslt.nocache" value="false" />      
     # P. F0 ~/ C5 r' ~' I
148.          
     & ~% L8 k- f9 ^  j% _) [6 e* `
149.     <!-- 设置struts自动加载的文件列表. -->     
     ; @  @8 l/ ~2 x0 |- J
150.     <cosntant name="struts.configuration.files" value="struts-default.xml,struts-plugin.xml,struts.xml" />     
     
151.               
     
152.     <!-- 设定是否一直在最后一个slash之前的任何位置选定namespace. -->     
     
153.     <cosntant name="struts.mapper.alwaysSelectFullNamespace" value="false" />     
     ( n- M" E7 v: D3 a
154. </struts>   
     # ~7 ^  X* Z6 Z( C
155.   
     
156.    
     4 [' T$ |; g6 @  c% X2 K
157.   
     
158. <struts>  
     
159.   
     
160.     <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->  
     
161.     <include file="struts-default.xml"></include>  
     
162.       
       D7 p% N7 E% Y. _% F
163.       
     
164.     <!-- package提供了将多个Action组织为一个模块的方式  
     # p; `0 j: [/ i( m5 o
165.         package的名字必须是唯一的 package可以扩展 当一个package扩展自  
     
166.         另一个package时该package会在本身配置的基础上加入扩展的package  
     
167.         的配置 父package必须在子package前配置   
     ' ^  _. Z# u: H( P6 P0 `3 ]
168.         name：package名称  
     
169.         extends:继承的父package名称  
     $ n; W1 k9 d( R" K# }/ H0 d: h
170.         abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false  
     2 {' ?7 E% |% Z  s# B0 P
171.         namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action  
     + p4 {( a1 {2 u$ I! }
172.      -->  
     / H, i. V& F5 ^0 t
173.     <package name="com.kay.struts2" extends="struts-default" namespace="/test">  
     # }( g3 @8 _4 e& j
174.         <interceptors>  
     
175.             <!-- 定义拦截器   
     3 z) U. d5 ]$ x/ O
176.                 name:拦截器名称  
     ' ~( Z, b  s7 a' B6 i- `4 P
177.                 class:拦截器类路径  
     
178.              -->  
     
179.             <interceptor name="timer" class="com.kay.timer"></interceptor>  
     4 F3 U2 M% z( i8 g) S5 v; w. c
180.             <interceptor name="logger" class="com.kay.logger"></interceptor>  
     - s$ b8 `$ }# I3 T" q
181.             <!-- 定义拦截器栈 -->  
     1 t' K6 x8 N( U6 z& K
182.             <interceptor-stack name="mystack">  
     # q$ D; s. Z/ q, Z& ~4 j
183.                 <interceptor-ref name="timer"></interceptor-ref>  
     
184.                 <interceptor-ref name="logger"></interceptor-ref>  
     
185.             </interceptor-stack>  
     
186.         </interceptors>  
     
187.          
     
188.         <!-- 定义默认的拦截器 每个Action都会自动引用  
     7 s3 f) R% N4 {7 K0 e
189.          如果Action中引用了其它的拦截器 默认的拦截器将无效 -->  
     
190.         <default-interceptor-ref name="mystack"></default-interceptor-ref>  
     
191.          
     7 h* j" @$ T( E4 @" ~2 _# p6 E
192.          
       y9 k" `9 e: d$ \" a6 m% n) C
193.         <!-- 全局results配置 -->  
     
194.         <global-results>  
     2 F4 T. d" v# A8 A: S
195.             <result name="input">/error.jsp</result>  
     
196.         </global-results>  
     
197.          
     / O+ q4 h1 N& ?7 `' l# S- y1 o  _
198.         <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)  
     
199.              name：action名称  
     / d- `  W3 S' Z* P( E" m, N
200.              class: 对应的类的路径  
     $ R1 W% b6 f: ~
201.              method: 调用Action中的方法名  
     , J& z) C- r$ x
202.         -->  
     % {" P4 V* s8 |0 m: ~. g6 m
203.         <action name="hello" class="com.kay.struts2.Action.LoginAction">  
     
204.             <!-- 引用拦截器  
     
205.                 name:拦截器名称或拦截器栈名称  
     1 \1 r: s% H$ M2 }* I
206.              -->  
     , [5 n. h$ Y; Z
207.             <interceptor-ref name="timer"></interceptor-ref>  
     " Q7 {1 P& P% @- r5 D: s* j
208.          
     + B. c' O/ b  I6 |- t# S+ L( o. \$ m
209.             <!-- 节点配置  
     
210.                 name : result名称 和Action中返回的值相同  
     
211.                 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher  
     ' _5 p  e/ ~  E4 r; Z! a  a2 l, ^: \
212.              -->  
     
213.          <result name="success" type="dispatcher">/talk.jsp</result>  
     0 n# w) `. W; a7 A
214.          <!-- 参数设置   
     
215.              name：对应Action中的get/set方法   
     * k( j8 `, t$ {& J  y
216.          -->  
     . ~2 e# b* _% y
217.          <param name="url">http://www.sina.com</param>  
     2 E4 H) H2 y* V
218.         </action>  
     
219.     </package>  
     : U* t* x) w0 y8 O
220. </struts></b></font></font></font>

复制代码

这些是常用的struts配置文件常量,如果想把struts用好,就要懂得每个配置是怎么一回事.不光光需要学习技术,更要学习好理论知识.技术的高度是由理论知识的深度决定的.
0 V& o- E) h& @" G: X. u
5 W# y; R5 d) v