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元素。