Struts2详细配置文件说明

89竹林

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

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

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

' R$ ?* d2 U. S4 P

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

5 u3 \5 d+ u1 q) Y/ W

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

$ p" @+ v+ l8 w& U! U/ s) k8 d) [

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

' ^( o8 m  }1 v+ }3 ~+ p
# \( e. u1 L4 R0 @7 a+ T  O4 b

二：配置文件的加载顺序

1 Y# d, v4 G# F% A+ R2 y4 a

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

% u2 x& L6 }( p5 `

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

三: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"      
   
4.     "http://struts.apache.org/dtds/struts-2.0.dtd">     
   
5.      
   : g, l: k( _3 x
6. <struts>     
   5 x) P$ g& W- j/ l! X
7.     <!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->     
   8 }8 z: \$ c# k" N+ C
8.     <constant name="struts.i18n.encoding" value="UTF-8" />     
   
9.      
   1 s7 \, v6 T- ]; n! P& @
10.     <!--      
    + q: L; L4 b5 d. P- m3 C
11.         该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。      
    - |8 U( s3 k, X- t6 M& G+ l! V, c7 a- E
12.         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。      
    
13.     -->     
    3 c4 L% l3 C" [0 M
14.     <constant name="struts.action.extension" value="do" />     
    : w4 E& z6 z8 v
15.      
    8 Y% q& J$ ~) Y" m
16.     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->     
    ( L' u+ C9 g% ~4 y- Y! J
17.     <constant name="struts.serve.static.browserCache" value="false" />     
    2 m# F3 H+ }& F" I& O
18.      
    2 v% @' q  Y8 l3 J5 W
19.     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->     
    
20.     <constant name="struts.configuration.xml.reload" value="true" />     
    
21.      
    
22.     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->     
    5 u; I4 w% Y3 T$ h- E' N, t
23.     <constant name="struts.devMode" value="true" />     
      t2 x/ i) q! L6 r
24.      
    ! l2 H8 s1 v# [2 Q* t" B
25.     <!-- 默认的视图主题 -->     
    
26.     <constant name="struts.ui.theme" value="simple" />     
    5 P: S9 u& {1 H% M
27.      
    - L  s/ Z8 d; |- U
28.     <!-- spring 托管 -->     
    3 a- s* ]# P. R9 M
29.     <constant name="struts.objectFactory" value="spring" />     
    
30.      
    1 e) d8 w% b5 Y* e' H
31.     <!--      
    
32.         指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration      
    
33.         开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。      
    ( k) q: v5 i/ h& D; s! j
34.     -->     
    
35.     <constant name="struts.configuration"     
    
36.         value="org.apache.struts2.config.DefaultConfiguration" />     
    0 B3 }9 K3 a$ p7 z
37.      
    
38.     <!-- 设置默认的locale和字符编码 -->     
    / y1 t& Z8 q3 c+ M  F8 v
39.     <constant name="struts.locale" value="zh_CN" />     
    
40.     <constant name="struts.i18n.encoding" value="GBK" />     
    
41.      
    
42.     <!-- 指定Struts的工厂类 -->     
    5 Z/ m+ B2 ?4 `- S, a/ S( `
43.     <constant name="struts.objectFactory" value="spring"></constant>     
    " ?( A8 u1 a, M2 y- [  Z9 ^
44.      
    
45.     <!--      
    
46.         指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name      
    ) L% a1 [3 h$ D+ v  K* {
47.         是默认装配模式)      
    7 f2 \" L: Z+ w. x* |: P! T/ s
48.     -->     
    . d' @9 S5 w, _. c
49.     <constant name="struts.objectFactory.spring.autoWire" value="name" />     
    
50.      
    
51.     <!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->     
    
52.     <cosntant name="struts.objectFactory.spring.useClassCache" />     
    $ `# e5 I: ~2 G8 ^
53.      
    
54.     <!-- 指定类型检查,包含tiger和notiger -->     
    
55.     <cosntant name="struts.objectTypeDeterminer" value="tiger" />     
    
56.      
    
57.     <!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->     
    - z, x; B) c, B7 T7 U* k4 i
58.     <constant name="struts.multipart.parser" value="cos" />     
    - v# S5 b- i" U3 s' E) P/ j1 o
59.     <constant name="struts.multipart.parser" value="pell" />     
      O, d9 `6 {2 M2 y+ `+ h  X
60.     <constant name="struts.multipart.parser" value="jakarta" />     
    , M- w0 l$ Z# V
61.      
    , J/ g  l% S6 N) a
62.     <!-- 指定上传文件时的临时目录，默认使用 javax.servlet.context.tempdir -->     
    
63.     <constant name="struts.multipart.saveDir" value="/tmpuploadfiles" />     
    
64.      
    
65.     <!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->     
    
66.     <constant name="struts.multipart.maxSize" value="2097152" />     
    , K2 Q) D: z0 K6 [( M; Y" Y
67.      
      W8 B; ]' ~# T+ U+ m
68.     <!--      
    
69.         该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖      
    $ B& o" x6 ?  P- s: S- X5 T/ @( ]
70.         struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文      
    / E( _4 C8 p7 O0 E# F: i6 g% a
71.         件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)      
    & A; c( y# W7 M. N4 M+ G$ j: `
72.     -->     
    
73.     <constant name="struts.custom.properties"     
    - B2 U6 k$ a7 `7 J4 Y5 x
74.         value="application,org/apache/struts2/extension/custom" />     
    
75.               
    
76.     <!-- 指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper -->     
    , q6 n- W$ j' J. _6 ^; }7 E
77.     <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />     
    " m: V6 A% ^, `2 M
78.      
    
79.     <!-- 指定action的后缀，默认为action -->     
    - U$ u" k* {. K
80.     <constant name="struts.action.extension" value="do" />     
    ( w5 u7 q3 p5 I  Y
81.          
    
82.     <!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->     
    
83.     <constant name="struts.serve.static.browserCache" value="true" />     
    $ i0 O1 g* f, v2 Q: m
84.      
    
85.     <!-- 设置是否支持动态方法调用，true为支持，false不支持. -->     
    
86.     <constant name="struts.enable.DynamicMethodInvocation" value="true" />     
    
87.               
    1 V; K6 V* X9 S; M8 ~* u5 C! H; n% d
88.     <!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->     
    
89.     <constant name="struts.enable.SlashesInActionNames" value="true" />     
    
90.          
    
91.     <!-- 是否允许使用表达式语法，默认为true. -->     
    
92.     <constant name="struts.tag.altSyntax" value="true" />     
    $ h9 k# V. ?5 i0 ^: g2 V
93.      
    * Y  v+ B$ j1 z
94.     <!-- 设置当struts.xml文件改动时，是否重新加载 -->     
    
95.     <cosntant name="struts.configuration.xml.reload" value="true" />     
    
96.          
    
97.     <!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->     
    
98.     <cosntant name="struts.devMode" value="true" />     
    $ l% t" J: I5 @
99.      
    
100.     <!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->     
     - e# T# ?" }# ?: q7 c& Z# n
101.     <cosntant name="struts.i18n.reload" value="false" />     
     
102.      
     
103.     <!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->     
     + P4 ?0 q0 X, I5 o: [2 s; }
104.     <cosntant name="struts.ui.theme" value="xhtml" />     
     ( ~) o0 T! y( ^  l3 V/ @
105.               
       G2 D9 f2 z$ z' i* V
106.     <!-- 模板目录 -->     
     ) N; r7 u- K) I* C" u
107.     <cosntant name="struts.ui.templateDir" value="template" />     
     # a" @2 ^: l# }
108.      
     
109.     <!-- 设置模板类型. 可以为 ftl, vm, or jsp -->     
     7 }; h" }3 W9 }3 d
110.     <cosntant name="struts.ui.templateSuffix" value="ftl" />     
     
111.      
     
112.     <!-- 定位velocity.properties 文件. 默认velocity.properties -->     
     
113.     <cosntant name="struts.velocity.configfile" value="velocity.properties" />     
     
114.          
     : O; S+ o$ k8 C% h  r  o' J# \8 F
115.     <!-- 设置velocity的context. -->     
     
116.     <cosntant name="struts.velocity.contexts" value="...." />     
     0 H& P4 ^2 A  V  H6 r/ G
117.          
     7 p4 m7 u0 L  V! e* m
118.     <!-- 定位toolbox -->     
     
119.     <cosntant name="struts.velocity.toolboxlocation" value="...." />     
     
120.      
     
121.     <!-- 指定web应用的端口 -->     
     ; w: V9 T% E* B2 Z
122.     <cosntant name="struts.url.http.port" value="80" />     
     
123.          
     
124.     <!-- 指定加密端口 -->            
     " ?/ [6 k: N" |' p; x
125.     <cosntant name="struts.url.https.port" value="443" />     
     
126.      
     
127.     <!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->     
     7 z* \6 Y3 l) [0 o
128.     <cosntant name="struts.url.includeParams" value="get" />     
     
129.      
     9 r$ b, S' c; z! Y, ^# n# |
130.     <!-- 设置要加载的国际化资源文件，以逗号分隔. -->     
     
131.     <cosntant name="struts.custom.i18n.resources" value="application" />     
     
132.          
     
133.     <!-- 对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(),      
     5 V& s3 ]8 g- x; ^  z2 M" \( \
134.         像 WebLogic,Orion, and OC4J等，须设置成true,默认为false. -->     
     
135.     <cosntant name="struts.dispatcher.parametersWorkaround" value="false" />        
     ) r$ I8 G1 e2 R) Z. Y5 J- Z
136.      
     - ?5 h" o0 k3 A4 Y! l3 \
137.     <!-- 指定freemarker管理器 -->     
     
138.     <cosntant name="struts.freemarker.manager.classname" value="org.apache.struts2.views.freemarker.FreemarkerManager" />      
     
139.      
     6 C2 b; C. y  Y* z- Y& j4 {: V
140.     <!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->     
     ' {; X. s/ k  r) N+ }
141.     <cosntant name="struts.freemarker.templatesCache" value="false" />         
     ! W0 a, r( Q. ~9 ~6 _- p% e
142.      
     
143.     <!-- 通常不需要修改此属性. -->     
     
144.     <cosntant name="struts.freemarker.wrapper.altMap" value="true" />      
     : O: g4 R0 s  v' t) j1 i
145.          
     
146.     <!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->     
     
147.     <cosntant name="struts.xslt.nocache" value="false" />      
     , M2 o. j# L, S
148.          
     % J' I$ m5 O0 ?1 l+ _
149.     <!-- 设置struts自动加载的文件列表. -->     
     * O) L: a" I% m6 y; g: P) d+ U) x! H
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" />     
     ' ]9 k- q: c' g8 S- i
154. </struts>   
     * d  s1 @/ l0 B' t) C
155.   
     + \1 f; l4 f9 f1 `6 w2 y$ G
156.    
     - {( ~# F9 T4 w, f8 y* x' w5 W* K' U
157.   
     + q8 Q4 R! @+ R2 I+ E
158. <struts>  
     # [& x6 }; q& x% g+ t4 w0 [$ e
159.   
     
160.     <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->  
     
161.     <include file="struts-default.xml"></include>  
     
162.       
     
163.       
     1 ?6 n8 C. ~2 h; K0 X
164.     <!-- package提供了将多个Action组织为一个模块的方式  
     
165.         package的名字必须是唯一的 package可以扩展 当一个package扩展自  
     
166.         另一个package时该package会在本身配置的基础上加入扩展的package  
     
167.         的配置 父package必须在子package前配置   
     
168.         name：package名称  
     / J8 d' ~4 u7 P1 w* q5 M  _
169.         extends:继承的父package名称  
     - J( D% [" {$ i2 o
170.         abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false  
     9 o9 {6 l4 k; J& u
171.         namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action  
     3 j1 Z! Q8 h) A4 _2 k( j
172.      -->  
     
173.     <package name="com.kay.struts2" extends="struts-default" namespace="/test">  
     
174.         <interceptors>  
     
175.             <!-- 定义拦截器   
     . I+ ]  ~; j2 e+ F/ ^, T; c9 x! y
176.                 name:拦截器名称  
     
177.                 class:拦截器类路径  
     
178.              -->  
     
179.             <interceptor name="timer" class="com.kay.timer"></interceptor>  
     9 T, l7 E3 z4 ~7 l: g* w
180.             <interceptor name="logger" class="com.kay.logger"></interceptor>  
     
181.             <!-- 定义拦截器栈 -->  
     
182.             <interceptor-stack name="mystack">  
     
183.                 <interceptor-ref name="timer"></interceptor-ref>  
     
184.                 <interceptor-ref name="logger"></interceptor-ref>  
     
185.             </interceptor-stack>  
     , Z( }% G% d4 K3 k6 L& {4 |) l
186.         </interceptors>  
     
187.          
     : f; t2 i+ U& w, H8 m% b
188.         <!-- 定义默认的拦截器 每个Action都会自动引用  
     
189.          如果Action中引用了其它的拦截器 默认的拦截器将无效 -->  
     
190.         <default-interceptor-ref name="mystack"></default-interceptor-ref>  
     
191.          
     # ~, }' {  i: i
192.          
     ! Y" D) E. Q$ x4 o% u3 C- m; J+ h. I
193.         <!-- 全局results配置 -->  
     ! V' t+ x8 X' {
194.         <global-results>  
     
195.             <result name="input">/error.jsp</result>  
     
196.         </global-results>  
     
197.          
     
198.         <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)  
     
199.              name：action名称  
     
200.              class: 对应的类的路径  
     . M* w+ O5 h+ j2 V# g1 z# _
201.              method: 调用Action中的方法名  
     
202.         -->  
     ; p- c0 A3 i7 M& Y# m8 o8 [5 h
203.         <action name="hello" class="com.kay.struts2.Action.LoginAction">  
     
204.             <!-- 引用拦截器  
     ' z$ w) z+ k7 u3 {/ q  h- `& O
205.                 name:拦截器名称或拦截器栈名称  
     
206.              -->  
     $ J2 c4 b: ]0 Z' M
207.             <interceptor-ref name="timer"></interceptor-ref>  
     
208.          
     8 i# j' }2 p) i  H* X9 k
209.             <!-- 节点配置  
     
210.                 name : result名称 和Action中返回的值相同  
     $ T) m' H% N9 R3 ?; ^! N
211.                 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher  
     
212.              -->  
     
213.          <result name="success" type="dispatcher">/talk.jsp</result>  
     3 Q/ u8 G9 V4 F, |3 Y* v9 _* H4 m
214.          <!-- 参数设置   
     ) n9 k  U7 Y# i, H
215.              name：对应Action中的get/set方法   
     * I5 `7 Y7 B3 X6 Z$ x$ j
216.          -->  
     2 }/ ~0 r. |/ f, h) r+ ]/ r; w
217.          <param name="url">http://www.sina.com</param>  
     1 t; b% d. Z" Y  p
218.         </action>  
     
219.     </package>  
     
220. </struts></b></font></font></font>

复制代码

这些是常用的struts配置文件常量,如果想把struts用好,就要懂得每个配置是怎么一回事.不光光需要学习技术,更要学习好理论知识.技术的高度是由理论知识的深度决定的.
1 v  k, A6 p. I" }) M0 Z4 B" Y
) x6 J: m5 T, R3 }2 q