Struts2详细配置文件说明

89竹林

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

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

: o1 b3 G- G, R: o* h6 Q' d

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

. K% t8 ]6 |: l

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

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

! ^# |, |1 V7 R) s- H

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

6 l- I; O( M$ T% e# C5 N

二：配置文件的加载顺序

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

! Q% q8 j3 m1 k$ ~

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

三: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      
   , `8 _; S$ t$ |) l* @) m0 c
3.     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"      
   
4.     "http://struts.apache.org/dtds/struts-2.0.dtd">     
   
5.      
   
6. <struts>     
   
7.     <!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->     
     t# r/ S3 l  S0 T5 w5 ~7 t
8.     <constant name="struts.i18n.encoding" value="UTF-8" />     
   0 g& V; ^) P. X4 a* O0 I
9.      
   
10.     <!--      
    
11.         该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。      
    6 R& F% C1 y; L- G) O9 p
12.         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。      
    & [% c; k; p7 g5 S$ c4 b6 Z: H' k
13.     -->     
    
14.     <constant name="struts.action.extension" value="do" />     
    + U9 ?: {) {- A* Y3 q2 z
15.      
    * R& \$ e* _% s9 W3 _$ Y/ c+ y' \
16.     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->     
    ) R, d4 U2 `/ ?3 j* C- C# M
17.     <constant name="struts.serve.static.browserCache" value="false" />     
    3 Q! C/ ~6 g+ |5 J
18.      
    ; K6 V! j& ^8 s2 S
19.     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->     
    4 v* r5 p" }! m3 L
20.     <constant name="struts.configuration.xml.reload" value="true" />     
    
21.      
    
22.     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->     
    & f8 b% k5 ]) i3 ]
23.     <constant name="struts.devMode" value="true" />     
      e+ \, G: ]1 f
24.      
    0 S: ?) u0 W2 `( V0 |  B* Y
25.     <!-- 默认的视图主题 -->     
    & b2 C1 N) t+ x# s1 v% }
26.     <constant name="struts.ui.theme" value="simple" />     
    / p9 g( ?( G7 g/ @
27.      
    9 b4 l! [1 C# E8 b  k1 s5 p- Q
28.     <!-- spring 托管 -->     
    1 s$ d3 j# k; h7 V  F
29.     <constant name="struts.objectFactory" value="spring" />     
    1 }) Q( P: e6 U: K# r. s6 @. U1 R, [
30.      
    
31.     <!--      
    , _& T) K1 W& o6 y1 I
32.         指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration      
    9 \4 c% Y* G& r+ B( L' G( K8 ^
33.         开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。      
    
34.     -->     
    2 ^) u4 d; ?( P" ^+ ~
35.     <constant name="struts.configuration"     
    
36.         value="org.apache.struts2.config.DefaultConfiguration" />     
    
37.      
    
38.     <!-- 设置默认的locale和字符编码 -->     
    ' k0 C  y3 P+ j+ U' z, E5 L
39.     <constant name="struts.locale" value="zh_CN" />     
    5 w, j' O% J( L6 q' _
40.     <constant name="struts.i18n.encoding" value="GBK" />     
    & d2 N0 M; c" X
41.      
    1 {5 d& \3 J, i4 z5 o
42.     <!-- 指定Struts的工厂类 -->     
    7 c3 @, ?/ d( ?! ?$ D
43.     <constant name="struts.objectFactory" value="spring"></constant>     
    
44.      
    % k+ k7 A$ H* p* {/ O, H
45.     <!--      
    ) r& y$ \! t; b* {! |8 i
46.         指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name      
    
47.         是默认装配模式)      
    % `; ~- B) `; A3 `3 `
48.     -->     
    
49.     <constant name="struts.objectFactory.spring.autoWire" value="name" />     
    
50.      
    
51.     <!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->     
    4 S6 S0 K; U% j5 X: x' {. F3 q
52.     <cosntant name="struts.objectFactory.spring.useClassCache" />     
    7 {3 L7 ~, `8 ]
53.      
    
54.     <!-- 指定类型检查,包含tiger和notiger -->     
    2 b+ T+ U) M4 I' l
55.     <cosntant name="struts.objectTypeDeterminer" value="tiger" />     
    
56.      
    ' {& e: {( Z$ V0 \3 ]' |/ I" F
57.     <!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->     
      f' }. z7 Y0 U3 E3 |$ R7 |3 K
58.     <constant name="struts.multipart.parser" value="cos" />     
    
59.     <constant name="struts.multipart.parser" value="pell" />     
    . A8 I3 s. Y) y+ [) t- c; J* e' e- Z- p
60.     <constant name="struts.multipart.parser" value="jakarta" />     
    
61.      
    
62.     <!-- 指定上传文件时的临时目录，默认使用 javax.servlet.context.tempdir -->     
    
63.     <constant name="struts.multipart.saveDir" value="/tmpuploadfiles" />     
    
64.      
    ; n" P2 b0 T8 x. p
65.     <!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->     
    
66.     <constant name="struts.multipart.maxSize" value="2097152" />     
    
67.      
    
68.     <!--      
    4 ?) u* a* F: j' D" i
69.         该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖      
    
70.         struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文      
    ' z* M) V4 e: b* G
71.         件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)      
    # ?! a3 j; Z, S& d
72.     -->     
    
73.     <constant name="struts.custom.properties"     
    
74.         value="application,org/apache/struts2/extension/custom" />     
    
75.               
    + k+ F# C! f2 f$ T- K. E% G
76.     <!-- 指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper -->     
    ( J5 r. H/ _+ m; T
77.     <constant name="struts.mapper.class" value="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />     
    ; a% I0 [0 ?9 i0 i  w' l
78.      
    
79.     <!-- 指定action的后缀，默认为action -->     
    + e# |0 ~6 i; A$ {( r- R
80.     <constant name="struts.action.extension" value="do" />     
    * {* Y7 k5 u$ p: e$ l
81.          
    ) h9 M7 m3 h) W
82.     <!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->     
    / _6 k* F$ w% w
83.     <constant name="struts.serve.static.browserCache" value="true" />     
    6 h& l- }* V# U, u- ?7 g0 \2 p
84.      
    5 I( e' S3 w$ U
85.     <!-- 设置是否支持动态方法调用，true为支持，false不支持. -->     
    * Z- C: P3 j  ~" ~9 z0 X. C5 }* E. {# O
86.     <constant name="struts.enable.DynamicMethodInvocation" value="true" />     
    % o' G  l* d6 U1 a4 [
87.               
    . `9 `! s& p3 O
88.     <!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->     
    / t0 c; P& N% q" j) z  q
89.     <constant name="struts.enable.SlashesInActionNames" value="true" />     
    1 s! ]* p# ~6 q0 N9 Z. b
90.          
    
91.     <!-- 是否允许使用表达式语法，默认为true. -->     
    
92.     <constant name="struts.tag.altSyntax" value="true" />     
    , Q4 P/ S# ~6 D! ^3 T
93.      
    4 R1 G  H( G% p' E
94.     <!-- 设置当struts.xml文件改动时，是否重新加载 -->     
    ) ?0 u: t9 P$ w& |1 g5 ?
95.     <cosntant name="struts.configuration.xml.reload" value="true" />     
    
96.          
    
97.     <!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->     
    ! p. u( c$ K9 c3 d
98.     <cosntant name="struts.devMode" value="true" />     
    $ ^0 v% u: U0 B
99.      
    
100.     <!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->     
     + i3 D) I! ~8 A* V! V, h: O3 x
101.     <cosntant name="struts.i18n.reload" value="false" />     
     # O8 \5 z7 {  p9 |5 {
102.      
     
103.     <!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->     
     
104.     <cosntant name="struts.ui.theme" value="xhtml" />     
     2 Z# H: l& ?6 ~2 q
105.               
     
106.     <!-- 模板目录 -->     
     
107.     <cosntant name="struts.ui.templateDir" value="template" />     
     2 {: }. G4 H0 f2 E4 X/ z3 C/ o
108.      
     7 V. P0 t' _( R% l& o, _; B
109.     <!-- 设置模板类型. 可以为 ftl, vm, or jsp -->     
     ( m5 o4 Q1 U; ]  x3 ?
110.     <cosntant name="struts.ui.templateSuffix" value="ftl" />     
     3 @; h' S- g$ M, S
111.      
     
112.     <!-- 定位velocity.properties 文件. 默认velocity.properties -->     
     ) N& g' y7 r, O, ?. h+ ?3 q
113.     <cosntant name="struts.velocity.configfile" value="velocity.properties" />     
     , ~. d) }7 @# I
114.          
     
115.     <!-- 设置velocity的context. -->     
     
116.     <cosntant name="struts.velocity.contexts" value="...." />     
     
117.          
     + s2 @- J) l9 S3 H
118.     <!-- 定位toolbox -->     
     
119.     <cosntant name="struts.velocity.toolboxlocation" value="...." />     
     " S, X7 s( t; @$ g- G( K2 Q8 y3 a
120.      
     
121.     <!-- 指定web应用的端口 -->     
     
122.     <cosntant name="struts.url.http.port" value="80" />     
     
123.          
     
124.     <!-- 指定加密端口 -->            
     / r( o+ a5 H2 I: \2 Y$ M
125.     <cosntant name="struts.url.https.port" value="443" />     
     ) P- E! N& x/ t) H1 z2 v
126.      
     + G. g: q  S/ L6 u/ e+ a
127.     <!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->     
     
128.     <cosntant name="struts.url.includeParams" value="get" />     
     7 a9 e6 k; g7 M& \
129.      
     
130.     <!-- 设置要加载的国际化资源文件，以逗号分隔. -->     
     $ g6 {) {7 q% b+ ^
131.     <cosntant name="struts.custom.i18n.resources" value="application" />     
     
132.          
     ' Q! N2 s# a& t' `
133.     <!-- 对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(),      
     ) H, }3 d# ]4 ^5 K
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" />      
     - S- |9 L0 ]* t1 @
139.      
     
140.     <!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->     
     
141.     <cosntant name="struts.freemarker.templatesCache" value="false" />         
     
142.      
     & A4 _/ F% p8 Q0 ~6 h* i; o
143.     <!-- 通常不需要修改此属性. -->     
     
144.     <cosntant name="struts.freemarker.wrapper.altMap" value="true" />      
     5 ~7 d' u6 m7 H" i( r' i. P
145.          
     * s" m$ K2 X! ~
146.     <!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->     
     
147.     <cosntant name="struts.xslt.nocache" value="false" />      
     ) w5 R( [( I4 d( J) x
148.          
     
149.     <!-- 设置struts自动加载的文件列表. -->     
     - S; _; f- @9 q
150.     <cosntant name="struts.configuration.files" value="struts-default.xml,struts-plugin.xml,struts.xml" />     
     ( m  m7 [7 E# @7 v$ w
151.               
     9 z  P- `- `7 T* }3 o
152.     <!-- 设定是否一直在最后一个slash之前的任何位置选定namespace. -->     
     : R/ ^) y3 S9 E" V  I
153.     <cosntant name="struts.mapper.alwaysSelectFullNamespace" value="false" />     
     # r, f# e/ {1 P  P, c0 H( L
154. </struts>   
     $ N6 l& N6 ]) I8 b
155.   
     1 K$ Q- E1 q4 x# P6 c5 O* g
156.    
     
157.   
     1 m4 @5 g/ m4 q0 s! y
158. <struts>  
     , O/ x2 G. z& c7 `, a4 v! Q
159.   
     
160.     <!-- include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->  
     - Z# z7 ]* W3 w  N* e9 d5 V# T
161.     <include file="struts-default.xml"></include>  
     ! o7 D$ A1 e1 B$ ]* E9 J& v7 M2 X
162.       
     
163.       
     
164.     <!-- package提供了将多个Action组织为一个模块的方式  
     + L: R* B- p+ c
165.         package的名字必须是唯一的 package可以扩展 当一个package扩展自  
     % E' z5 P3 W* h$ B, q1 ]
166.         另一个package时该package会在本身配置的基础上加入扩展的package  
     
167.         的配置 父package必须在子package前配置   
     
168.         name：package名称  
     9 Z) J% ]* Z: F+ i# ^6 X- V% f+ Z
169.         extends:继承的父package名称  
     
170.         abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false  
     
171.         namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action  
     ! `. g4 ]% ?) l2 r# Y6 b
172.      -->  
     
173.     <package name="com.kay.struts2" extends="struts-default" namespace="/test">  
     " m0 V) _  U' g- d( y; I9 `
174.         <interceptors>  
     ' G3 H7 L# j8 w8 W0 D
175.             <!-- 定义拦截器   
     
176.                 name:拦截器名称  
     
177.                 class:拦截器类路径  
     
178.              -->  
     * w* z, J# e5 B* h
179.             <interceptor name="timer" class="com.kay.timer"></interceptor>  
     
180.             <interceptor name="logger" class="com.kay.logger"></interceptor>  
     ' b" E* q# _6 j7 H0 ]
181.             <!-- 定义拦截器栈 -->  
     7 t+ k4 j3 n' n$ J1 C
182.             <interceptor-stack name="mystack">  
     
183.                 <interceptor-ref name="timer"></interceptor-ref>  
     
184.                 <interceptor-ref name="logger"></interceptor-ref>  
     
185.             </interceptor-stack>  
     
186.         </interceptors>  
       D) Z( m8 z" K* ^# U) K8 G  z
187.          
     ) J$ z# w3 @' d% ~7 d3 [8 y
188.         <!-- 定义默认的拦截器 每个Action都会自动引用  
     , A; U' m+ G( O  u
189.          如果Action中引用了其它的拦截器 默认的拦截器将无效 -->  
     # t' c, G+ D" H/ v% x
190.         <default-interceptor-ref name="mystack"></default-interceptor-ref>  
     : I, _& o: h! X
191.          
     
192.          
     
193.         <!-- 全局results配置 -->  
     + _  V( _; g/ ?' r8 S
194.         <global-results>  
     8 B( L3 Z% v2 B( |
195.             <result name="input">/error.jsp</result>  
     $ e; r; g3 M9 h
196.         </global-results>  
     
197.          
     
198.         <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)  
     " O5 b: O  Y7 R* s! x( Z2 b
199.              name：action名称  
     4 p4 v7 P8 m* }; p1 ?: E6 h
200.              class: 对应的类的路径  
     * Q( G# W& @6 C  Y) |
201.              method: 调用Action中的方法名  
       e1 z2 j5 e3 R2 w( v' V# a- T
202.         -->  
     , q+ ?+ f# j! Y0 A, g- \
203.         <action name="hello" class="com.kay.struts2.Action.LoginAction">  
     
204.             <!-- 引用拦截器  
     
205.                 name:拦截器名称或拦截器栈名称  
     
206.              -->  
     ' u3 V2 k7 a  h' R
207.             <interceptor-ref name="timer"></interceptor-ref>  
     
208.          
     : h8 x9 ?5 v5 i
209.             <!-- 节点配置  
     1 H4 x7 y6 w7 B3 r' D
210.                 name : result名称 和Action中返回的值相同  
     
211.                 type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher  
     6 Q5 S: K  H" P7 Z
212.              -->  
     $ `7 k+ G* L, w) A/ _' q! e9 [( J
213.          <result name="success" type="dispatcher">/talk.jsp</result>  
     
214.          <!-- 参数设置   
     2 H  h1 _) E& ^
215.              name：对应Action中的get/set方法   
     
216.          -->  
     9 U6 e+ ]' C& u  v* Z2 g8 n
217.          <param name="url">http://www.sina.com</param>  
       l  q4 j( J6 {4 M! S$ K
218.         </action>  
     
219.     </package>  
     $ r9 G8 J- v6 S3 S3 X* x, r
220. </struts></b></font></font></font>

复制代码

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