Struts2详细配置文件说明

89竹林

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

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

7 ?) k  q9 C. J5 L. Q

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

, `/ [6 [; N/ C3 R& t

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

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

# A# u. Q# V9 K7 h

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

" l" d9 j: S3 j& ]$ ]9 B
5 o3 g8 H) H# e( d! ]

二：配置文件的加载顺序

5 g+ V" K# M& m+ k9 Y6 {7 ^

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" ?>     
   ' V# g2 C, y; E% m8 R7 y2 A
2. <!DOCTYPE struts PUBLIC      
   
3.     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"      
   
4.     "http://struts.apache.org/dtds/struts-2.0.dtd">     
   ' s( g' F( s- i  ^7 ]9 @  P/ U
5.      
   
6. <struts>     
   
7.     <!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->     
   ! o9 B( ~8 ^8 p! d4 Z; R; h; e0 }
8.     <constant name="struts.i18n.encoding" value="UTF-8" />     
   2 P+ S8 F! i6 v  o' S& a
9.      
   , C2 b' }$ W' y% _
10.     <!--      
    
11.         该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。      
    $ R% e: _: `2 k8 N7 m: B' }
12.         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。      
    ' O, i6 {, Q: O* N
13.     -->     
    
14.     <constant name="struts.action.extension" value="do" />     
    
15.      
    5 |5 m& g6 T, h, T, z2 N$ w
16.     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->     
    
17.     <constant name="struts.serve.static.browserCache" value="false" />     
    3 n! U) J* l( q
18.      
    + c8 w/ v0 V' V( t% k
19.     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->     
    
20.     <constant name="struts.configuration.xml.reload" value="true" />     
    
21.      
    
22.     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->     
      ~4 Z# l8 X! C% d1 v1 v  G
23.     <constant name="struts.devMode" value="true" />     
    $ T- s  n. L& W3 p$ o9 }
24.      
    
25.     <!-- 默认的视图主题 -->     
    
26.     <constant name="struts.ui.theme" value="simple" />     
    , k- s$ @1 G% Q. \" k3 b
27.      
    
28.     <!-- spring 托管 -->     
    + C" t5 r8 p# E+ W3 Z
29.     <constant name="struts.objectFactory" value="spring" />     
    
30.      
    
31.     <!--      
    " v* z) @" m8 \, f1 @; g
32.         指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration      
    & p3 F0 W8 x5 `4 l- ?
33.         开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。      
    
34.     -->     
    
35.     <constant name="struts.configuration"     
    
36.         value="org.apache.struts2.config.DefaultConfiguration" />     
    
37.      
    " f# W2 j7 P- @% \) g- m
38.     <!-- 设置默认的locale和字符编码 -->     
    
39.     <constant name="struts.locale" value="zh_CN" />     
    
40.     <constant name="struts.i18n.encoding" value="GBK" />     
    
41.      
    
42.     <!-- 指定Struts的工厂类 -->     
    
43.     <constant name="struts.objectFactory" value="spring"></constant>     
    
44.      
    
45.     <!--      
    0 K$ z: Z' ^; J; C, \4 f3 m
46.         指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name      
    8 j  Y+ Q3 Z; @$ l
47.         是默认装配模式)      
    " |' ]+ ]$ o6 e$ R$ |4 U$ e) ^& `
48.     -->     
    / i1 z  K# K) d/ Y! f' x+ r; k
49.     <constant name="struts.objectFactory.spring.autoWire" value="name" />     
    , w$ U* K( L* l( X2 L3 s$ z" |' n
50.      
    
51.     <!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->     
    ; V6 @9 O- n& U" l& l# E+ k) d
52.     <cosntant name="struts.objectFactory.spring.useClassCache" />     
    ( U2 }3 A0 @3 }. Z
53.      
    2 Z" M' f2 \" c5 X1 a( [
54.     <!-- 指定类型检查,包含tiger和notiger -->     
    2 S. w% {  {+ }( c
55.     <cosntant name="struts.objectTypeDeterminer" value="tiger" />     
    . N  b' I0 l" Q, V0 O
56.      
    ' g3 \- ]& f: D! x! L0 n. m( T
57.     <!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->     
    ! v: r0 g5 o! Z, ]  h" P4 r
58.     <constant name="struts.multipart.parser" value="cos" />     
    
59.     <constant name="struts.multipart.parser" value="pell" />     
    ) H* J/ F* n- G/ s; i. ^4 p- Y4 Z
60.     <constant name="struts.multipart.parser" value="jakarta" />     
    " @: d0 Y1 e/ m2 _
61.      
    
62.     <!-- 指定上传文件时的临时目录，默认使用 javax.servlet.context.tempdir -->     
    " h3 _" m2 l# U0 D* [  U7 L0 p
63.     <constant name="struts.multipart.saveDir" value="/tmpuploadfiles" />     
    5 u% h6 O9 ^5 S8 l, c: w9 p
64.      
    ' ~+ _2 ~/ l6 B4 q/ j- t7 E
65.     <!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->     
    
66.     <constant name="struts.multipart.maxSize" value="2097152" />     
    
67.      
    ; Y/ V3 X& V5 \/ z# }# z% v" X% T+ P
68.     <!--      
    
69.         该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖      
    
70.         struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文      
    
71.         件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)      
    
72.     -->     
    7 R) i+ ]; s; O  h' ~, I" a; b
73.     <constant name="struts.custom.properties"     
    
74.         value="application,org/apache/struts2/extension/custom" />     
    
75.               
    
76.     <!-- 指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper -->     
    
77.     <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />     
    
78.      
      d! K/ U3 [3 O# y  ~- b/ m$ z/ h
79.     <!-- 指定action的后缀，默认为action -->     
    # J/ a8 Q' N7 o2 W% ^6 ]
80.     <constant name="struts.action.extension" value="do" />     
    
81.          
    
82.     <!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->     
    , b7 y' t- w/ z1 N2 |  p
83.     <constant name="struts.serve.static.browserCache" value="true" />     
    
84.      
    0 i' r2 o$ q( M/ t" L& u
85.     <!-- 设置是否支持动态方法调用，true为支持，false不支持. -->     
    
86.     <constant name="struts.enable.DynamicMethodInvocation" value="true" />     
    # b. Y' V9 U; g6 s: v' h
87.               
    9 r& x3 [% h  U+ K! M
88.     <!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->     
    0 D3 Q3 T4 i. N" h' o0 d
89.     <constant name="struts.enable.SlashesInActionNames" value="true" />     
    5 G1 e! c% d4 v' j
90.          
    + Y( \1 a6 F8 H7 J
91.     <!-- 是否允许使用表达式语法，默认为true. -->     
    0 ]7 g2 Y' i! U
92.     <constant name="struts.tag.altSyntax" value="true" />     
    
93.      
    
94.     <!-- 设置当struts.xml文件改动时，是否重新加载 -->     
    ' ^/ ^5 j3 I% ]
95.     <cosntant name="struts.configuration.xml.reload" value="true" />     
    
96.          
    
97.     <!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->     
    # O2 K' W, K* O' I6 Z2 L
98.     <cosntant name="struts.devMode" value="true" />     
    
99.      
    
100.     <!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->     
     5 u$ B/ w. ?% `3 {, P
101.     <cosntant name="struts.i18n.reload" value="false" />     
     
102.      
     
103.     <!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->     
     
104.     <cosntant name="struts.ui.theme" value="xhtml" />     
     $ R" N0 b) b* K! L3 I5 O, C: \
105.               
     
106.     <!-- 模板目录 -->     
     
107.     <cosntant name="struts.ui.templateDir" value="template" />     
     
108.      
     
109.     <!-- 设置模板类型. 可以为 ftl, vm, or jsp -->     
     3 s' @) E, h! a( J6 n% ^
110.     <cosntant name="struts.ui.templateSuffix" value="ftl" />     
     
111.      
     ; y& H* X5 I/ k& |- z$ V& s% ^
112.     <!-- 定位velocity.properties 文件. 默认velocity.properties -->     
     
113.     <cosntant name="struts.velocity.configfile" value="velocity.properties" />     
     : ^3 g8 W0 s6 A- X; Q! k$ \
114.          
     
115.     <!-- 设置velocity的context. -->     
     
116.     <cosntant name="struts.velocity.contexts" value="...." />     
     , a4 `3 P+ u- r. J- p" W0 C
117.          
     3 ]0 m$ s. g; c% P
118.     <!-- 定位toolbox -->     
     1 a, L% w9 i4 z& L& X3 E
119.     <cosntant name="struts.velocity.toolboxlocation" value="...." />     
     + w+ z! X4 P8 w& i: k$ O# Y) R( H
120.      
     3 e7 k7 E: d8 t( T0 o( L& y7 J+ W
121.     <!-- 指定web应用的端口 -->     
     
122.     <cosntant name="struts.url.http.port" value="80" />     
     
123.          
     
124.     <!-- 指定加密端口 -->            
     1 L$ d: J0 `/ t/ s
125.     <cosntant name="struts.url.https.port" value="443" />     
     " d! [( b$ C9 E3 j
126.      
     " h/ i# S- X/ \. K. J5 x6 K
127.     <!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->     
     ! I/ E$ R3 o6 H# j, s
128.     <cosntant name="struts.url.includeParams" value="get" />     
     - [7 F& Y$ f- s% V
129.      
     : Y" P: L1 C, e7 \! x2 O5 j
130.     <!-- 设置要加载的国际化资源文件，以逗号分隔. -->     
       e4 N1 F2 q1 K0 Z
131.     <cosntant name="struts.custom.i18n.resources" value="application" />     
     * k2 K4 W7 |" \" @* A0 d5 m$ I
132.          
     
133.     <!-- 对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(),      
     
134.         像 WebLogic,Orion, and OC4J等，须设置成true,默认为false. -->     
     4 Y% {9 l3 \/ `8 U! P
135.     <cosntant name="struts.dispatcher.parametersWorkaround" value="false" />        
     , l8 A' m  S) v0 ]
136.      
     ( E% `% {; R5 R
137.     <!-- 指定freemarker管理器 -->     
     
138.     <cosntant name="struts.freemarker.manager.classname" value="org.apache.struts2.views.freemarker.FreemarkerManager" />      
     % {2 H3 C! f4 ^8 _
139.      
     
140.     <!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->     
     + C5 O# z' U7 @
141.     <cosntant name="struts.freemarker.templatesCache" value="false" />         
     
142.      
     3 n8 Y( H; `; T7 C
143.     <!-- 通常不需要修改此属性. -->     
     
144.     <cosntant name="struts.freemarker.wrapper.altMap" value="true" />      
     3 [+ o1 T4 P# G  ?
145.          
     
146.     <!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->     
     9 A; r9 W1 b! C+ s
147.     <cosntant name="struts.xslt.nocache" value="false" />      
     9 \, t6 j. B' c& F2 v+ H1 B
148.          
     
149.     <!-- 设置struts自动加载的文件列表. -->     
     ) U1 c: t" Z0 {7 p8 j* s1 \* `
150.     <cosntant name="struts.configuration.files" value="struts-default.xml,struts-plugin.xml,struts.xml" />     
     6 j* L& [5 |+ Q+ j6 o2 T
151.               
     ( |* W5 |5 A8 f! e( H
152.     <!-- 设定是否一直在最后一个slash之前的任何位置选定namespace. -->     
     # c' k4 Z+ t7 u  ~2 R+ [+ Y
153.     <cosntant name="struts.mapper.alwaysSelectFullNamespace" value="false" />     
     
154. </struts>   
     " }- T  a/ R! }" R/ h% |. O8 g
155.   
     
156.    
     2 r; E  o* u/ V7 E  m: O! R0 Y* Z
157.   
     
158. <struts>  
     6 J; _, F+ ]/ }' j9 L; h6 \
159.   
     
160.     <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->  
     " G; h% h5 H: g2 [  Q
161.     <include file="struts-default.xml"></include>  
     
162.       
     
163.       
     & X8 m# }. Q% v9 L% Y- t9 Z, h
164.     <!-- package提供了将多个Action组织为一个模块的方式  
     
165.         package的名字必须是唯一的 package可以扩展 当一个package扩展自  
     7 v( \6 H1 `( Z$ V, s
166.         另一个package时该package会在本身配置的基础上加入扩展的package  
     
167.         的配置 父package必须在子package前配置   
     
168.         name：package名称  
     9 Y4 y* y  h6 o: @
169.         extends:继承的父package名称  
     
170.         abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false  
     . i0 q" }6 {6 i: I# W0 a1 Q
171.         namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action  
     2 |- {& e1 I0 U+ v/ b$ |: m* {
172.      -->  
     ; e- x6 |. ~4 h7 P
173.     <package name="com.kay.struts2" extends="struts-default" namespace="/test">  
     ) k# A9 R1 S' ]) e: e
174.         <interceptors>  
     
175.             <!-- 定义拦截器   
     
176.                 name:拦截器名称  
     
177.                 class:拦截器类路径  
     5 D, i% I! D6 Y( A2 _
178.              -->  
     ( r% b5 S+ n* f: \; ]
179.             <interceptor name="timer" class="com.kay.timer"></interceptor>  
     
180.             <interceptor name="logger" class="com.kay.logger"></interceptor>  
     . f# k" y$ z" A( n" n/ |
181.             <!-- 定义拦截器栈 -->  
     
182.             <interceptor-stack name="mystack">  
     ( ^& X, ^  s; k; `( p" u# V
183.                 <interceptor-ref name="timer"></interceptor-ref>  
     8 d) _1 d4 X! g$ v5 m' ^$ i
184.                 <interceptor-ref name="logger"></interceptor-ref>  
       w" o, t' t4 J! v+ A0 \
185.             </interceptor-stack>  
     ' h9 W- ~: k* d4 T
186.         </interceptors>  
     5 e  U0 w2 h  t0 V7 l0 m
187.          
     2 `4 x2 p$ \9 b
188.         <!-- 定义默认的拦截器 每个Action都会自动引用  
     3 c$ P! O7 c" Y- h0 W
189.          如果Action中引用了其它的拦截器 默认的拦截器将无效 -->  
     / Y' T) j. r9 h0 z/ e
190.         <default-interceptor-ref name="mystack"></default-interceptor-ref>  
     + t* I6 v5 ?) r7 {+ x7 V+ u/ R% S2 p
191.          
     
192.          
     5 Q/ F& g5 F' U* l
193.         <!-- 全局results配置 -->  
     / G% X, R1 |3 u8 O, g4 l5 L, x2 z
194.         <global-results>  
     
195.             <result name="input">/error.jsp</result>  
     
196.         </global-results>  
     
197.          
     / M  I% b- e0 d' R3 |! ?2 u, w8 x0 q
198.         <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)  
     4 i) C, _- R0 ^
199.              name：action名称  
       o9 e* w3 r& u) d9 w
200.              class: 对应的类的路径  
     
201.              method: 调用Action中的方法名  
       I# E% [- {* M$ a: {
202.         -->  
     $ \( k! g9 R4 f$ [0 W9 w: c
203.         <action name="hello" class="com.kay.struts2.Action.LoginAction">  
     
204.             <!-- 引用拦截器  
     ( T* j: z4 [5 v8 o) G
205.                 name:拦截器名称或拦截器栈名称  
     5 {# C: b  C. f8 c- D/ K( I
206.              -->  
     
207.             <interceptor-ref name="timer"></interceptor-ref>  
     ' H# A) F" D7 B$ E$ n
208.          
     , t% T5 c+ N8 {# S/ N6 B
209.             <!-- 节点配置  
     
210.                 name : result名称 和Action中返回的值相同  
     
211.                 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher  
     2 m! W* e" C& f8 c
212.              -->  
     
213.          <result name="success" type="dispatcher">/talk.jsp</result>  
     
214.          <!-- 参数设置   
     / m+ v1 g, {9 t! g( P) y7 V
215.              name：对应Action中的get/set方法   
     
216.          -->  
     
217.          <param name="url">http://www.sina.com</param>  
     
218.         </action>  
     
219.     </package>  
     / Z' X8 Y1 M; g5 x4 g
220. </struts></b></font></font></font>

复制代码

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

# i, s, [7 [8 t0 V: ^