Struts应用配置的web.xml文件

1. # *******************上面是头文件，不用理它们是什么***********************************    
2. # <?xml version="1.0" encoding="UTF-8"?>    
3. # <web-app xmlns="http://java.sun.com/xml/ns/j2ee"    
4. #   
5. # xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.4"    
6. #   
7. # xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee    
8. #   
9. # http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">    
10. # 大约就是些版本号呀，字符编码啊之类的东东吧，没研究过，貌似也不用研究头文件吧    
11. #   
12. #   
13. #   
14. # *********************配置ActionServlet*********************************************    
15. # <servlet>    
16. # <servlet-name>action</servlet-name>    
17. # <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>    
18. #   
19. # 不管应用中包含多少个子应用,都只需配置一个ActionServlet,因为ActionServlet支持多线程,目前的Struts框架只允许在应用中配置一个ActionServlet。    
20. #   
21. #   
22. # *****************初始化参数对Servlet的运行环境进行初始化配置***************************    
23. #   
24. # <init-param>    
25. # <param-name>config</param-name>    
26. # <param-value>/WEB-INF/struts-config.xml</param-value>    
27. # </init-param>    
28. # 这里是以相对路径的方式指明Struts应用程序的配置文件位置。如不设置，则默认值为/WEB-INF/struts-config.xml。    
29. #   
30. #   
31. # <init-param>    
32. # <param-name>debug</param-name>    
33. # <param-value>3</param-value>    
34. # </init-param>    
35. # 设置Servlet的debug级别，控制日志记录的详细程度。默认为0，记录相对最少的日志信息。    
36. #   
37. #   
38. # <init-param>    
39. # <param-name>detail</param-name>    
40. # <param-value>3</param-value>    
41. # </init-param>    
42. # <load-on-startup>0</load-on-startup>    
43. # 设置Digester的debug级别，Digester是Struts框架所使用的用来解析xml配置文件的一个框架，通过该设置，可以查看不同详细等级的解析日志。默认为0，记录相对最少的日志信息。    
44. #   
45. # </servlet>    
46. #   
47. #   
48. # *********************这里也是配置ActionServlet**************************************    
49. # <servlet-mapping>    
50. # <servlet-name>action</servlet-name>    
51. # <url-pattern>*.do</url-pattern>    
52. # </servlet-mapping>    
53. # 就是将所有的*.do请求提交给action，从这里又找到上面那个配置可以读到ActionServlet的位置。    
54. #   
55. #   
56. # **************************配置Struts标签库*****************************************    
57. # <taglib>    
58. # 　　<tag-uri>/WEB-INF/struts-html.tld<tag-uri>    
59. # 　　<taglib-location>/WEB-INF/struts-html.tld</taglib-location>    
60. # 　　</taglib>    
61. # 其中<tag-uri>用于指定标签库的相对或者绝对URI地址，Web应用根据这一URI来访问标签库。    
62. # <taglib-location>指定标签描述文件在文件资源系统中的物理位置。    
63. # </web-app>    
65. # web.xml文件对于配置任何Java Web应用都必需的。   
66. # （1）配置Struts的ActionServlet   
67. #   
68. # <servlet>元素来声明ActionServlet   
69. # <servlet-name>元素：用来定义Servlet的名称   
70. # <servlet-class>元素:用来指定Servlet的完整类名   
71. #   
72. # <servlet>  
73. # <servlet-name>action</servlet-name>  
74. # <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>  
75. # </servlet>  
76. #   
77. # 还要配置<servlet-mapping>元素,它用来指定ActionServlet可以处理哪些URL   
78. # <servlet-mapping>  
79. # <servlet-name>action</servlet-name>  
80. # <url-pattern>*.do</url-pattern>  
81. # </servlet-mapping>  
82. #   
83. # 注意:(1)<servlet-mapping>和<servlet>中的<servlet-name>?</servlet-name>的要填写一致，它就是一根线，把<servlet-mapping>和<servlet>联接在一起的。   
84. #      (2)在Struts框架中只能有一个Servlet,因为Servlet支持多线程。而<servlet-class>org.apache.struts.action.ActionServlet</servlet-class>中的ActionServlet是在Struts.jar包中的.在导入Struts包时会导入。   
85. #      (3)在显示层以*.do提交的，都会过个Servlet。*.do可以改写成你想要的任何形式。例如:/do/*   
86. # 扩展 (1)我们可以继承 org.apache.struts.action.ActionServlet 得到我们可以扩允的子类，在子类中重写一个方法init()。这时<servlet-class>?</servlet-class>中的？是我们新建的类的路径，同样只能存在一个。   
87. #         
88. #   
89. # (2)声明ActionServlet的初始化参数   
90. #    初始化参数用来对Servlet的运行时环境进行初始配置。<servlet>的<init-param>子元素用于配置Servlet初始化参数。   
91. #       
92. #    config ：以相对路径的方式指明Struts应用程序的配置文件位置,如不设置，则默认值为/WEB-INF/struts-config.xml   
93. #    debug  : 设置Servlet的debug级别,控制日志记录的详细程度。默认为0，记录相对最少的日志信息。   
94. #    detail : 设置Digester的debug级别，Digester是Struts框架所使用的用来解析xml配置文件的一个框架，通过此设置，可以查看不同详细等级的解析日志。默认为0，记录相对最少的日志信息。   
95. #    <load-on-startup>？</load-on-startup>中？号的值是此ActionServlet在服务器开启时加载的次序，数值越低，越先加载。   
96. #   
97. #     <servlet>  
98. #       <servlet-name>action</servlet-name>  
99. #       <servlet-class>org.apache.struts.action.ActionServlet</servlet-class>  
100. #       <init-param>  
101. #         <param-name>config</param-name>  
102. #         <param-value>/WEB-INF/struts-config.xml</param-value>  
103. #       </init-param>  
104. #       <init-param>  
105. #         <param-name>debug</param-name>  
106. #         <param-value>3</param-value>  
107. #       </init-param>  
108. #       <init-param>  
109. #         <param-name>detail</param-name>  
110. #         <param-value>3</param-value>  
111. #        </init-param>  
112. #       <load-on-startup>0</load-on-startup>  
113. #   </servlet>  
114. #      
115. #   扩展：(1)当服务器启动后，加载ActionServlet，而ActionServlet会调用相关的方法去，会根据它下面的参数的初始值，对这个ActionServlet中的参数时行初始化   
116. #         (2)当多人协作开发项目时可以对Strutst的配置文件进行适当的扩充，但必须为config开头。如   
117. #          <init-param>  
118. #         <param-name>config/XXXXXXXXX</param-name>  
119. #         <param-value>/WEB-INF/XXXXX.xml</param-value>  
120. #          </init-param>  
121. #             
122. #  (3) 配置欢迎文件清单   
123. #      当客户访问Web应用时，如果仅仅给出Web应用的Root URL,没有指定具体的文件名。Web容器会自动调用Web应用的欢迎文件。<welcome-file-list>是用来设置此项.   
124. #      <welcome-file-list>  
125. #      <welcome-file>welcome.jsp</welcome-file>  
126. #      </welcome-file-list>     
127. #       说明:在<welcome-file-list> 下可以有多个<welcom-file>。Web容器会依次寻找欢迎界面，直到找到为止。但如果不存在会向客户端返回”HTTP 404 NOT Found“错误信息。   
128. #          
129. #       由于在<welcome-file-list>元素中不能配置Servlet映射，则不能直接把Struts的Action作为欢迎文件。但可以通过Struts中的全局的(global)转发项来配置。   
130. #       A：welcome.jsp页面(可换文件名)   
131. #       <%@ taglib uri="http://jakarta.apache.org/struts/tags-logic" prefix="logic"%>  
132. #       <html>  
133. #       <body>  
134. #       <logic:forward name="welcome"/>  
135. #       </body>  
136. #       </html>  
137. #       B: web.xml   
138. #       <welcome-file-list>  
139. #       <welcome-file>welcome.jsp</welcome-file>  
140. #       </welcome-file-list>  
141. #       C:  struts-config.xml   
142. #       <global-forwards>  
143. #       <forward name="welcome" path="hello.do">     
144. #       </global-forwards>  
145. #        我自已理解，仅供参考   
146. #       运行机制：当服务器启动时还是会加载 B中<welcome-file>welcome.jsp</welcome-file>中的welcome.jsp,然后读到(A)welcome.jsp中的 <logic:forward name="welcome"/>,接下来会转到C中的<forward name="welcome" path="HelloWorld.do">,这是由于它是以.do(hello.do)结尾的，所以它会找到C文件中的<action>相配配的，最后在转到这个<action>的JSP页面。   
147. #       运行错误示例:    
148. #   
149. # (a)把C中的<forwrod>改成<forward name="welcome" path="liusong.do"> liusong.do根本就不成在。   
150. #   
151. #   
152. #     
153. #   
154. #   
155. #   
156. #   
157. # (b)把C中的 <forward name="welcome" path="hello"> 因为服务器不知是hello.do还是hello.jsp不能转向   
158. #   
159. #   
160. #     
161. #   
162. #   
163. #  (c)把B中的 <welcome-file >/hello.do</welcome-file>因为它不会调用Servlet类,   
164. #   
165. #   
166. #   
167. #         
168. #   
169. #  运行正确示例:   
170. #   
171. #  (d)把C中的<forward name="welcome" path="hello.jsp">   运行成功   
172. #   (e)把B中的<welcome-file >/hello.jsp</welcome-file>   运行成功   
173. #                       
174. #   
175. # (4)配置错误处理   
176. # Struts框架中不能处理所有的错误或异常。当Struts框架发生不能处理所有的错误或异常时，就把错误抛给Web容器。在默认情况下，Web容器会向用户浏览器直接返回原始的错误，为了避免可以使用<error-page>。   
177. # <erro-page>  
178. # <error-code>4040</error-code>  
179. # <location>/commmon/404.jsp</location>  
180. # </error-page>  
181. # <erro-page>  
182. # <error-code>4040</error-code>  
183. # <location>/commmon/404.jsp</location>  
184. # </error-page>  
185. #   
186. # Weg容器捕获的Java异常配置<error-page>，这时需要设置<exception-type>子元素，它用于指定Java异常类。Web容器可能捕获如下的异常:   
187. # RuntimeException 或 Error   
188. # ServletException 或它的子类   
189. # IOException　或它的子类   
190. #   
191. # <error-page>  
192. # <exception-type>javax.servlet.ServletException</exception-type>  
193. # <location>/system_error.jsp</location>  
194. # </error-page>  
195. # <error-page>  
196. # <exception-type>java.io.IOException</exception-type>  
197. # <location>/system_ioerror.jsp</location>  
198. # </error-page>  
199. #   
200. # (5)配置Struts标签库   
201. # Struts框架提供了一些实用的客户化标签标签库,如果在应用中使用可以在web.xml中配置   
202. # <taglib>  
203. # <taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri>  
204. # <taglib-location>/WEB-INF/struts-bean.tld</taglib-location>  
205. # </taglib>  
206. # 由于Eclipse对<taglib>会产生错误,所以   
207. # <jsp-config>      
208. # <taglib>      
209. #   <taglib-uri>/WEB-INF/validator-user.tld</taglib-uri>      
210. #   <taglib-location>/WEB-INF/validator-user.tld</taglib-location>      
211. # </taglib>      
212. # </jsp-config>