struts2 配置文件详解

struts.xml

---->在这个文件中可以定义一些自己的action,interceptor，package等，该文件的package 通常继承struts-default包

<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd" >
<struts>

    <!-- 就是当项目比较庞大的时候  action  配置比较多 比较臃肿  include节点是struts2中组件化的方式 可以将每个功能模块独立到一个xml配置文件中 然后用include节点引用 -->
    <include file="struts-default.xml"></include>
    
    
    <!-- package提供了将多个Action组织为一个模块的方式
        package的名字必须是唯一的 package可以扩展 当一个package扩展自
        另一个package时该package会在本身配置的基础上加入扩展的package
        的配置 父package必须在子package前配置 
        name：package名称
        extends:继承的父package名称
        abstract:设置package的属性为抽象的 抽象的package不能定义action 值true:false
        namespace:定义package命名空间 该命名空间影响到url的地址，例如此命名空间为/test那么访问是的地址为http://localhost:8080/struts2/test/XX.action
     -->
    <package name="com.kay.struts2" extends="struts-default" namespace="/test">
        <interceptors>
            <!-- 定义拦截器 
                name:拦截器名称
                class:拦截器类路径
             -->
            <interceptor name="timer" class="com.kay.timer"></interceptor>
            <interceptor name="logger" class="com.kay.logger"></interceptor>
            <!-- 定义拦截器栈 -->
            <interceptor-stack name="mystack">
                <interceptor-ref name="timer"></interceptor-ref>
                <interceptor-ref name="logger"></interceptor-ref>
            </interceptor-stack>
        </interceptors>
        
        <!-- 定义默认的拦截器 每个Action都会自动引用
         如果Action中引用了其它的拦截器 默认的拦截器将无效 -->
        <default-interceptor-ref name="mystack"></default-interceptor-ref>
        
        
        <!-- 全局results配置 -->
        <global-results>
            <result name="input">/error.jsp</result>
        </global-results>
        
        <!-- Action配置 一个Action可以被多次映射(只要action配置中的name不同)
             name：action名称
             class: 对应的类的路径
             method: 调用Action中的方法名
        -->
        <action name="hello" class="com.kay.struts2.Action.LoginAction">
            <!-- 引用拦截器
                name:拦截器名称或拦截器栈名称
             -->
            <interceptor-ref name="timer"></interceptor-ref>
        
            <!-- 节点配置
                name : result名称 和Action中返回的值相同
                type : result类型 不写则选用superpackage的type struts-default.xml中的默认为dispatcher
             -->
         <result name="success" type="dispatcher">/talk.jsp</result>
         <!-- 参数设置 
             name：对应Action中的get/set方法 
         -->
         <param name="url">http://www.sina.com</param>
        </action>
    </package>
</struts>

sttuts-default.xml

----->这个文件是struts2框架默认加载的配置文件。它定义struts2一些核心的bean和拦截器。

1. <?xml version="1.0" encoding="UTF-8" ?>  
2. <!DOCTYPE struts PUBLIC"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd">  
3.   
4. <struts>  
5.   
6. <!--struts2中工厂bean的定义-->  
7.   
8. <bean class="com.opensymphony.xwork2.ObjectFactory" name="xwork" />  
9.   
10. <bean type="com.opensymphony.xwork2.ObjectFactory" name="struts" class="org.apache.struts2.impl.StrutsObjectFactory" />  
11.   
12. <bean type="com.opensymphony.xwork2.ActionProxyFactory" name="xwork" class="com.opensymphony.xwork2.DefaultActionProxyFactory"/>  
13.   
14. <bean type="com.opensymphony.xwork2.ActionProxyFactory" name="struts" class="org.apache.struts2.impl.StrutsActionProxyFactory"/>  
15.   
16. <!--类型检测bean的定义-->  
17.   
18. <bean type="com.opensymphony.xwork2.util.ObjectTypeDeterminer" name="tiger" class="com.opensymphony.xwork2.util.GenericsObjectTypeDeterminer"/>  
19.   
20. <bean type="com.opensymphony.xwork2.util.ObjectTypeDeterminer" name="notiger" class="com.opensymphony.xwork2.util.DefaultObjectTypeDeterminer"/>  
21.   
22. <bean type="com.opensymphony.xwork2.util.ObjectTypeDeterminer" name="struts" class="com.opensymphony.xwork2.util.DefaultObjectTypeDeterminer"/>  
23.   
24. <!--文件上传bean的定义-->  
25.   
26. <bean type="org.apache.struts2.dispatcher.mapper.ActionMapper" name="struts" class="org.apache.struts2.dispatcher.mapper.DefaultActionMapper" />  
27.   
28. <bean type="org.apache.struts2.dispatcher.mapper.ActionMapper" name="composite" class="org.apache.struts2.dispatcher.mapper.CompositeActionMapper" />  
29.   
30. <bean type="org.apache.struts2.dispatcher.mapper.ActionMapper" name="restful" class="org.apache.struts2.dispatcher.mapper.RestfulActionMapper" />  
31.   
32. <bean type="org.apache.struts2.dispatcher.mapper.ActionMapper" name="restful2" class="org.apache.struts2.dispatcher.mapper.Restful2ActionMapper" />  
33.   
34. <bean type="org.apache.struts2.dispatcher.multipart.MultiPartRequest" name="struts" class="org.apache.struts2.dispatcher.multipart.JakartaMultiPartRequest" scope="default" optional="true"/>  
35.   
36. <bean type="org.apache.struts2.dispatcher.multipart.MultiPartRequest" name="jakarta" class="org.apache.struts2.dispatcher.multipart.JakartaMultiPartRequest" scope="default" optional="true" />  
37.   
38. <!--标签库bean的定义-->  
39.   
40. <bean type="org.apache.struts2.views.TagLibrary" name="s" class="org.apache.struts2.views.DefaultTagLibrary" />  
41.   
42. <!--一些常用视图bean的定义-->  
43.   
44. <bean class="org.apache.struts2.views.freemarker.FreemarkerManager" name="struts" optional="true"/>  
45.   
46. <bean class="org.apache.struts2.views.velocity.VelocityManager" name="struts" optional="true" />  
47.   
48. <bean class="org.apache.struts2.components.template.TemplateEngineManager" />  
49.   
50. <bean type="org.apache.struts2.components.template.TemplateEngine" name="ftl" class="org.apache.struts2.components.template.FreemarkerTemplateEngine" />  
51.   
52. <bean type="org.apache.struts2.components.template.TemplateEngine" name="vm" class="org.apache.struts2.components.template.VelocityTemplateEngine" />  
53.   
54. <bean type="org.apache.struts2.components.template.TemplateEngine" name="jsp" class="org.apache.struts2.components.template.JspTemplateEngine" />  
55.   
56. <!--类型转换bean的定义-->  
57.   
58. <bean type="com.opensymphony.xwork2.util.XWorkConverter" name="xwork1" class="com.opensymphony.xwork2.util.XWorkConverter" />  
59.   
60. <bean type="com.opensymphony.xwork2.util.XWorkConverter" name="struts" class="com.opensymphony.xwork2.util.AnnotationXWorkConverter" />  
61.   
62. <bean type="com.opensymphony.xwork2.TextProvider" name="xwork1" class="com.opensymphony.xwork2.TextProviderSupport" />  
63.   
64. <bean type="com.opensymphony.xwork2.TextProvider" name="struts" class="com.opensymphony.xwork2.TextProviderSupport" />  
65.   
66.   
67. <!-- Struts2中一些可以静态注入的bean,也就是不需要实例化的 -->  
68.   
69. <bean class="com.opensymphony.xwork2.ObjectFactory" static="true" />  
70.   
71. <bean class="com.opensymphony.xwork2.util.XWorkConverter" static="true" />  
72.   
73. <bean class="com.opensymphony.xwork2.util.OgnlValueStack" static="true" />  
74.   
75. <bean class="org.apache.struts2.dispatcher.Dispatcher" static="true" />  
76.   
77. <bean class="org.apache.struts2.components.Include" static="true" />  
78.   
79. <bean class="org.apache.struts2.dispatcher.FilterDispatcher" static="true" />  
80.   
81. <bean class="org.apache.struts2.views.util.ContextUtil" static="true" />  
82.   
83. <bean class="org.apache.struts2.views.util.UrlHelper" static="true" />  
84.   
85. <!-- 定义Struts2默认包-->  
86.   
87. <package name="struts-default" abstract="true">  
88.   
89. <!-- 结果类型的种类-->  
90.   
91. <result-types>  
92.   
93. <result-type name="chain" class="com.opensymphony.xwork2.ActionChainResult"/>  
94.   
95. <result-type name="dispatcher" class="org.apache.struts2.dispatcher.ServletDispatcherResult" default="true"/>  
96.   
97. <result-type name="freemarker" class="org.apache.struts2.views.freemarker.FreemarkerResult"/>  
98.   
99. <result-type name="httpheader" class="org.apache.struts2.dispatcher.HttpHeaderResult"/>  
100.   
101. <result-type name="redirect" class="org.apache.struts2.dispatcher.ServletRedirectResult"/>  
102.   
103. <result-type name="redirectAction" class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/>  
104.   
105. <result-type name="stream" class="org.apache.struts2.dispatcher.StreamResult"/>  
106.   
107. <result-type name="velocity" class="org.apache.struts2.dispatcher.VelocityResult"/>  
108.   
109. <result-type name="xslt" class="org.apache.struts2.views.xslt.XSLTResult"/>  
110.   
111. <result-type name="plainText" class="org.apache.struts2.dispatcher.PlainTextResult" />  
112.   
113. <result-type name="redirect-action" class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/>  
114.   
115. <result-type name="plaintext" class="org.apache.struts2.dispatcher.PlainTextResult" />  
116.   
117. </result-types>  
118.   
119.   
120.   
121. <!--struts2中拦截器的定义-->  
122.   
123. <interceptors>  
124.   
125. <!--实现在不同请求中相似参数别名的准换-->  
126.   
127. <interceptor name="alias" class="com.opensymphony.xwork2.interceptor.AliasInterceptor"/>  
128.   
129. <!--与Spring整合时自动装配的拦截器-->  
130.   
131. <interceptor name="autowiring" class="com.opensymphony.xwork2.spring.interceptor.ActionAutowiringInterceptor"/>  
132.   
133. <!--构建一个action链，使当前action可以访问前一个action，与<result-type="chain" />配合使用-->  
134.   
135. <interceptor name="chain" class="com.opensymphony.xwork2.interceptor.ChainingInterceptor"/>  
136.   
137. <!--负责类型转换的拦截器-->  
138.   
139. <interceptor name="conversionError" class="org.apache.struts2.interceptor.StrutsConversionErrorInterceptor"/>  
140.   
141. <!--使用配置的name,value来是指cookies -->  
142.   
143. <interceptor name="cookie" class="org.apache.struts2.interceptor.CookieInterceptor"/>  
144.   
145. <!--负责创建httpSession-->  
146.   
147. <interceptor name="createSession" class="org.apache.struts2.interceptor.CreateSessionInterceptor" />  
148.   
149. <!--输出调试信息-->  
150.   
151. <interceptor name="debugging" class="org.apache.struts2.interceptor.debugging.DebuggingInterceptor" />  
152.   
153. <!--扩展引用-->  
154.   
155. <interceptor name="externalRef" class="com.opensymphony.xwork2.interceptor.ExternalReferencesInterceptor"/>  
156.   
157. <!--后台执行action负责发送等待画面给用户-->  
158.   
159. <interceptor name="execAndWait" class="org.apache.struts2.interceptor.ExecuteAndWaitInterceptor"/>  
160.   
161. <!--异常处理-->  
162.   
163. <interceptor name="exception" class="com.opensymphony.xwork2.interceptor.ExceptionMappingInterceptor"/>  
164.   
165. <!--文件上传，解析表单域的内容-->  
166.   
167. <interceptor name="fileUpload" class="org.apache.struts2.interceptor.FileUploadInterceptor"/>  
168.   
169. <!--支持国际化-->  
170.   
171. <interceptor name="i18n" class="com.opensymphony.xwork2.interceptor.I18nInterceptor"/>  
172.   
173. <!--日志记录-->  
174.   
175. <interceptor name="logger" class="com.opensymphony.xwork2.interceptor.LoggingInterceptor"/>  
176.   
177. <!--模型拦截器，当action实现了ModelDriven接口时，负责把getModel的结果放入valueStack中-->  
178.   
179. <interceptor name="modelDriven" class="com.opensymphony.xwork2.interceptor.ModelDrivenInterceptor"/>  
180.   
181. <!--有生命周期的ModelDriven-->  
182.   
183. <interceptor name="scopedModelDriven" class="com.opensymphony.xwork2.interceptor.ScopedModelDrivenInterceptor"/>  
184.   
185. <!--负责解析请求中的参数，并赋值给action中对应的属性-->  
186.   
187. <interceptor name="params" class="com.opensymphony.xwork2.interceptor.ParametersInterceptor"/>  
188.   
189. <!--实现该Preparable接口的action，会调用拦截器的prepare方法-->  
190.   
191. <interceptor name="prepare" class="com.opensymphony.xwork2.interceptor.PrepareInterceptor"/>  
192.   
193. <!--负责将action 标签下的param参数值传递给action实例-->  
194.   
195. <interceptor name="staticParams" class="com.opensymphony.xwork2.interceptor.StaticParametersInterceptor"/>  
196.   
197. <!--范围转换-->  
198.   
199. <interceptor name="scope" class="org.apache.struts2.interceptor.ScopeInterceptor"/>  
200.   
201. <!--用于访问Servlet API-->  
202.   
203. <interceptor name="servletConfig" class="org.apache.struts2.interceptor.ServletConfigInterceptor"/>  
204.   
205.   
206.   
207. <interceptor name="sessionAutowiring" class="org.apache.struts2.spring.interceptor.SessionContextAutowiringInterceptor"/>  
208.   
209. <!--输出action执行时间-->  
210.   
211. <interceptor name="timer" class="com.opensymphony.xwork2.interceptor.TimerInterceptor"/>  
212.   
213. <!--防止表单重复提交-->  
214.   
215. <interceptor name="token" class="org.apache.struts2.interceptor.TokenInterceptor"/>  
216.   
217. <!--与token拦截器相似，只是把token保存到HttpSession-->  
218.   
219. <interceptor name="tokenSession" class="org.apache.struts2.interceptor.TokenSessionStoreInterceptor"/>  
220.   
221. <!--负责表单字段的验证 *-validation.xml-->  
222.   
223. <interceptor name="validation" class="org.apache.struts2.interceptor.validation.AnnotationValidationInterceptor"/>  
224.   
225. <!--负责执行action的validate()-->  
226.   
227. <interceptor name="workflow" class="com.opensymphony.xwork2.interceptor.DefaultWorkflowInterceptor"/>  
228.   
229. <!--存储和重新获取Action 消息/错误/字段错误为Action，实现ValidationAware接口到seesion-->  
230.   
231. <interceptor name="store" class="org.apache.struts2.interceptor.MessageStoreInterceptor" />  
232.   
233. <!--添加自动checkbox处理代码,这样检探测checkbox和添加它作为一个参数使用默认值(通常’false’).使用一个指定名字隐藏字段探测没提交的checkbox-->  
234.   
235. <interceptor name="checkbox" class="org.apache.struts2.interceptor.CheckboxInterceptor" />  
236.   
237. <interceptor name="profiling" class="org.apache.struts2.interceptor.ProfilingActivationInterceptor" />  
238.   
239. <!--JAAS服务拦截器-->  
240.   
241. <interceptor name="roles" class="org.apache.struts2.interceptor.RolesInterceptor" />  
242.   
243.   
244.   
245. <!-- 一个基本的拦截器栈 -->  
246.   
247. <interceptor-stack name="basicStack">  
248.   
249. <interceptor-ref name="exception"/>  
250.   
251. <interceptor-ref name="servletConfig"/>  
252.   
253. <interceptor-ref name="prepare"/>  
254.   
255. <interceptor-ref name="checkbox"/>  
256.   
257. <interceptor-ref name="params"/>  
258.   
259. <interceptor-ref name="conversionError"/>  
260.   
261. </interceptor-stack>  
262.   
263.   
264.   
265. <!-- 简单的validtion和webflow栈 -->  
266.   
267. <interceptor-stack name="validationWorkflowStack">  
268.   
269. <interceptor-ref name="basicStack"/>  
270.   
271. <interceptor-ref name="validation"/>  
272.   
273. <interceptor-ref name="workflow"/>  
274.   
275. </interceptor-stack>  
276.   
277.   
278.   
279. <!-- 文件上传的拦截器栈 -->  
280.   
281. <interceptor-stack name="fileUploadStack">  
282.   
283. <interceptor-ref name="fileUpload"/>  
284.   
285. <interceptor-ref name="basicStack"/>  
286.   
287. </interceptor-stack>  
288.   
289.   
290.   
291. <!-- model-driven 栈 -->  
292.   
293. <interceptor-stack name="modelDrivenStack">  
294.   
295. <interceptor-ref name="modelDriven"/>  
296.   
297. <interceptor-ref name="basicStack"/>  
298.   
299. </interceptor-stack>  
300.   
301.   
302.   
303. <!-- action链的拦截器栈 -->  
304.   
305. <interceptor-stack name="chainStack">  
306.   
307. <interceptor-ref name="chain"/>  
308.   
309. <interceptor-ref name="basicStack"/>  
310.   
311. </interceptor-stack>  
312.   
313.   
314.   
315. <!-- i18n 拦截器栈 -->  
316.   
317. <interceptor-stack name="i18nStack">  
318.   
319. <interceptor-ref name="i18n"/>  
320.   
321. <interceptor-ref name="basicStack"/>  
322.   
323. </interceptor-stack>  
324.   
325.   
326.   
327. <!-- 结合preparable和ModenDriven拦截器-->  
328.   
329. <interceptor-stack name="paramsPrepareParamsStack">  
330.   
331. <interceptor-ref name="exception"/>  
332.   
333. <interceptor-ref name="alias"/>  
334.   
335. <interceptor-ref name="params"/>  
336.   
337. <interceptor-ref name="servletConfig"/>  
338.   
339. <interceptor-ref name="prepare"/>  
340.   
341. <interceptor-ref name="i18n"/>  
342.   
343. <interceptor-ref name="chain"/>  
344.   
345. <interceptor-ref name="modelDriven"/>  
346.   
347. <interceptor-ref name="fileUpload"/>  
348.   
349. <interceptor-ref name="checkbox"/>  
350.   
351. <interceptor-ref name="staticParams"/>  
352.   
353. <interceptor-ref name="params"/>  
354.   
355. <interceptor-ref name="conversionError"/>  
356.   
357. <interceptor-ref name="validation">  
358.   
359. <param name="excludeMethods">input,back,cancel</param>  
360.   
361. </interceptor-ref>  
362.   
363. <interceptor-ref name="workflow">  
364.   
365. <param name="excludeMethods">input,back,cancel</param>  
366.   
367. </interceptor-ref>  
368.   
369. </interceptor-stack>  
370.   
371.   
372.   
373. <!--定义默认的拦截器栈 -->  
374.   
375. <interceptor-stack name="defaultStack">  
376.   
377. <interceptor-ref name="exception"/>  
378.   
379. <interceptor-ref name="alias"/>  
380.   
381. <interceptor-ref name="servletConfig"/>  
382.   
383. <interceptor-ref name="prepare"/>  
384.   
385. <interceptor-ref name="i18n"/>  
386.   
387. <interceptor-ref name="chain"/>  
388.   
389. <interceptor-ref name="debugging"/>  
390.   
391. <interceptor-ref name="profiling"/>  
392.   
393. <interceptor-ref name="scopedModelDriven"/>  
394.   
395. <interceptor-ref name="modelDriven"/>  
396.   
397. <interceptor-ref name="fileUpload"/>  
398.   
399. <interceptor-ref name="checkbox"/>  
400.   
401. <interceptor-ref name="staticParams"/>  
402.   
403. <interceptor-ref name="params">  
404.   
405. <param name="excludeParams">dojo\..*</param>  
406.   
407. </interceptor-ref>  
408.   
409. <interceptor-ref name="conversionError"/>  
410.   
411. <interceptor-ref name="validation">  
412.   
413. <param name="excludeMethods">input,back,cancel,browse</param>  
414.   
415. </interceptor-ref>  
416.   
417. <interceptor-ref name="workflow">  
418.   
419. <param name="excludeMethods">input,back,cancel,browse</param>  
420.   
421. </interceptor-ref>  
422.   
423. </interceptor-stack>  
424.   
425.   
426. <interceptor-stack name="completeStack">  
427.   
428. <interceptor-ref name="defaultStack"/>  
429.   
430. </interceptor-stack>  
431.   
432.   
433. <interceptor-stack name="executeAndWaitStack">  
434.   
435. <interceptor-ref name="execAndWait">  
436.   
437. <param name="excludeMethods">input,back,cancel</param>  
438.   
439. </interceptor-ref>  
440.   
441. <interceptor-ref name="defaultStack"/>  
442.   
443. <interceptor-ref name="execAndWait">  
444.   
445. <param name="excludeMethods">input,back,cancel</param>  
446.   
447. </interceptor-ref>  
448.   
449. </interceptor-stack>  
450.   
451.   
452. <interceptor name="external-ref" class="com.opensymphony.xwork2.interceptor.ExternalReferencesInterceptor"/>  
453.   
454. <interceptor name="model-driven" class="com.opensymphony.xwork2.interceptor.ModelDrivenInterceptor"/>  
455.   
456. <interceptor name="static-params" class="com.opensymphony.xwork2.interceptor.StaticParametersInterceptor"/>  
457.   
458. <interceptor name="scoped-model-driven" class="com.opensymphony.xwork2.interceptor.ScopedModelDrivenInterceptor"/>  
459.   
460. <interceptor name="servlet-config" class="org.apache.struts2.interceptor.ServletConfigInterceptor"/>  
461.   
462. <interceptor name="token-session" class="org.apache.struts2.interceptor.TokenSessionStoreInterceptor"/>  
463.   
464.   
465.   
466. </interceptors>  
467.   
468. <!--定义默认拦截器为"defaultStack"-->  
469.   
470. <default-interceptor-ref name="defaultStack"/>  
471.   
472. </package>  
473.   
474.   
475. </struts>  
     

struts-default.xml

 struts.properties文

------->这个文件是struts2框架的全局属性文件，也是自动加载的文件。该文件包含了系列的key-value对。该文件完全可以配置在struts.xml文件中，使用constant元素。