1.  <?xml version="1.0" encoding="UTF-8"?>  

2.  

3.  <web-app  xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" version="2.4">  

4.      

5.    <display-name>网站名称</display-name>  

6.    <description>网站描述</description>  

7.          

8.    <!-- icon元素包含small-icon和large-icon两个子元素.用来指定web站台中小图标和大图标的路径. -->  

9.    <icon>  

10.        <!--small-icon元素应指向web站台中某个小图标的路径,大小为16 X 16 pixel,但是图象文件必须为GIF或JPEG格式,扩展名必须为:.gif或.jpg. -->  

11.        <small-icon>路径/small.gif</small-icon>  

12.        <!--large-icon元素应指向web站台中某个大图表路径,大小为32 X 32 pixel,但是图象文件必须为GIF或JPEG的格式,扩展名必须为; gif或jpg.-->  

13.        <large-icon>路径/large.jpg</large-icon>  

14.    </icon>  

15.      

16.    <!-- 配置集群的时候,要用到,在这篇文章:“apache+tomcat集群、负载均衡及session复制”里的第三条(http://jiajun.iteye.com/admin/blogs/278586) -->  

17.    <distributable/>  

18.      

19.    <!-- context-param 元素用来设定web站台的环境参数(context),它包含两个子元素:param-name和param-value.,如spring的典型配置  -->  

20.    <context-param>  

21.        <!-- 设定Context名称  -->  

22.        <param-name>contextConfigLocation</param-name>  

23.        <!-- 设定Context名称的值  -->  

24.        <param-value>/WEB-INF/spring-config.xml</param-value>  

25.    </context-param>  

26.    <!-- 备注:此所设定的参数,在JSP网页中可以使用下列方法来取得:${initParam.param_name}  

27.           若在Servlet可以使用下列方法来获得:String param_name=getServletContext().getInitParamter("param_name");   

28.    -->  

29.      

30.   <!-- filter元素用来声明filter的相关设定.filter元素除了下面介绍的的子元素之外,还包括下面<servlet>绍过的<icon>,<display-name>,<description>,<init-param>,其用途一样.-->  

31.   <filter>  

32.      <!-- 定义Filter的名称.  -->  

33.      <filter-name>URIFilter</filter-name>  

34.      <!-- 定义Filter的类名称 -->  

35.      <filter-class>org.cjj.filter.URIFilter</filter-class>  

36.      <init-param>  

37.         <param-name>encoding</param-name>  

38.         <param-value>UTF-8</param-value>  

39.      </init-param>  

40.   </filter>  

41.   <!-- filter-mapping 元素的两个主要子元素filter-name和url-pattern.用来定义Filter所对应的URL.和下面的servlet-mapping一样  -->  

42.   <filter-mapping>  

43.      <!-- 定义Filter的名称,和上面定义的Filter名称要一致 -->  

44.      <filter-name>URIFilter</filter-name>  

45.      <!-- ilter所对应的RUL,这里是所有的URL -->  

46.      <url-pattern>/*</url-pattern>  

47.   </filter-mapping>  

48.  

49.   <!-- 这里配置和上面的Filter配置一样 -->  

50.   <servlet>  

51.      <description><![CDATA[Application Setup]]></description>  

52.      <servlet-name>HTML Action Servlet</servlet-name>  

53.      <servlet-class>org.cjj.servlet.ActionServlet</servlet-class>  

54.      <init-param>  

55.         <param-name>config</param-name>  

56.         <param-value>/WEB-INF/struts-config.xml</param-value>  

57.      </init-param>  

58.      <init-param>  

59.         <param-name>debug</param-name>  

60.         <param-value>2</param-value>  

61.      </init-param>  

62.      <init-param>  

63.         <param-name>detail</param-name>  

64.         <param-value>2</param-value>  

65.      </init-param>  

66.      <load-on-startup>0</load-on-startup>  

67.   </servlet>  

68.   <!-- 和上面的filter-mapping,一样 -->  

69.   <servlet-mapping>  

70.      <servlet-name>HTML Action Servlet</servlet-name>  

71.      <url-pattern>*.do</url-pattern>  

72.   </servlet-mapping>  

73.  

74.    <!-- listener元素用来定义Listener接口,它的主要子元素为<listener-class>  -->  

75.    <listener>  

76.      <!-- ServletContextListener接口的实现,监听Content -->  

77.      <listener-class>org.cjj.listener.ContextListener</listener-class>  

78.   </listener>  

79.   <listener>  

80.      <!-- HttpSessionListener, HttpSessionAttributeListener接口的实现,监听session -->  

81.      <listener-class>org.cjj.listener.SessionListener</listener-class>  

82.   </listener>  

83.     

84.   <!-- session-config包含一个子元素session-timeout.定义web站台中的session参数.  -->  

85.   <session-config>  

86.      <!-- 定义这个web站台所有session的有效期限.单位为分钟. 例子中为600分钟 -->  

87.      <session-timeout>600</session-timeout>  

88.   </session-config>  

89.  

90.    <!-- mime-mapping包含两个子元素extension和mime-type.定义某一个扩展名和某一MIME Type做对映.  -->  

91.    <mime-mapping>  

92.        <!-- 扩展名称  -->  

93.        <extension>htm</extension>  

94.        <!-- MIME格式  -->  

95.        <mime-type>text/html</mime-type>  

96.    </mime-mapping>  

97.    <mime-mapping>  

98.        <extension>flv</extension>  

99.        <mime-type>video/x-flv</mime-type>  

100.    </mime-mapping>  

101.    <mime-mapping>  

102.        <extension>doc</extension>  

103.        <mime-type>application/vnd.ms-word</mime-type>  

104.    </mime-mapping>  

105.    <mime-mapping>  

106.        <extension>xls</extension>  

107.        <mime-type>application/vnd.ms-excel</mime-type>  

108.    </mime-mapping>   

109.  

110.    <!-- welcome-file-list包含子元素welcome-file,用来定义首页列单,如:  -->  

111.    <welcome-file-list>  

112.        <welcome-file>index.jsp</welcome-file>  

113.        <welcome-file>index.html</welcome-file>  

114.    </welcome-file-list>  

115.  

116.    <!-- error-page元素包含三个子元素error-code,exception-type和location.将错误代码(Error Code)或异常(Exception)的种类对应到web站台资源路径.-->  

117.    <error-page>  

118.        <!-- HTTP Error code -->  

119.        <error-code>403</error-code>  

120.        <!-- 在web站点内的相关资源路径  -->  

121.        <location>路径/403.jsp</location>  

122.    </error-page>  

123.    <error-page>  

124.        <error-code>404</error-code>  

125.        <location>路径/404.jsp</location>  

126.    </error-page>  

127.    <error-page>  

128.        <error-code>500</error-code>  

129.        <location>路径/500.jsp</location>  

130.    </error-page>  

131.    <error-page>  

132.        <!-- 一个完整名称的Java异常类型  -->  

133.        <exception-type>java.lang.Exception</exception-type>  

134.         <location>路径/exception.jsp</location>  

135.    </error-page>   

136.  

137.    <!-- jsp-config元素主要用来设定JSP的相关配置,<jsp:config>包括<taglib>和<jsp-property-group>两个子元素.  

138.                  其中<taglib>元素在JSP 1.2时就已经存在了;而<jsp-property-group>是JSP 2.0新增的元素.  

139.    -->  

140.    <jsp-config>  

141.        <!-- taglib元素包含两个子元素taglib-uri和taglib-location.用来设定JSP网页用到的Tag Library路径.  -->  

142.        <taglib>  

143.            <!-- 定义TLD文件的URI,JSP网页的taglib指令可以经由这个URI存取到TLD文件.  -->  

144.            <taglib-uri>core</taglib-uri>  

145.            <!-- TLD文件对应Web站台的存放位置.  -->  

146.            <taglib-location>/WEB-INF/tld/jstl-1-core.tld</taglib-location>  

147.        </taglib>  

148.        <taglib>  

149.            <taglib-uri>bean</taglib-uri>  

150.            <taglib-location>/WEB-INF/tld/struts-bean.tld</taglib-location>  

151.        </taglib>  

152.        <taglib>  

153.            <taglib-uri>html</taglib-uri>  

154.            <taglib-location>/WEB-INF/tld/struts-html.tld</taglib-location>  

155.        </taglib>  

156.        <taglib>  

157.            <taglib-uri>logic</taglib-uri>  

158.            <taglib-location>/WEB-INF/tld/struts-logic.tld</taglib-location>  

159.        </taglib>  

160.        <taglib>  

161.            <taglib-uri>tiles</taglib-uri>  

162.            <taglib-location>/WEB-INF/tld/struts-tiles.tld</taglib-location>  

163.        </taglib>  

164.         <!-- jsp-property-group元素包含8个元素 -->  

165.         <jsp-property-group>  

166.            <!-- 此设定的说明  -->  

167.            <description>Special property group for JSP Configuration JSP example.</description>  

168.            <!-- 此设定的名称  -->  

169.            <display-name>JSPConfiguration</display-name>  

170.            <!-- 设定值所影响的范围,如:/CH2 或者/*.jsp  -->  

171.            <uri-pattern>/*</uri-pattern>  

172.            <!-- 若为true,表示不支持EL语法.  -->  

173.            <el-ignored>true</el-ignored>  

174.            <!-- 若为true表示不支持<%scription%>语法.  -->  

175.            <scripting-invalid>false</scripting-invalid>   

176.            <!-- 设置JSP网页的抬头,扩展名为.jspf  -->  

177.            <include-prelude>.jspf</include-prelude>   

178.            <!-- 设置JSP网页的结尾,扩展名为.jspf  -->  

179.            <include-coda>.jspf</include-coda>   

180.            <!-- 编码 -->  

181.            <page-encoding>utf-8</page-encoding>  

182.        </jsp-property-group>  

183.    </jsp-config>  

184.      

185.    <!-- esource-ref元素包括五个子元素description,res-ref-name,res-type,res-auth,res-sharing-scope.利用JNDI取得站台可  -->  

186.    <resource-ref>  

187.        <!-- 资源说明  -->  

188.        <description>JNDI JDBC DataSource of JSPBook</description>  

189.        <!-- 资源名称  -->  

190.        <res-ref-name>jdbc/sample_db</res-ref-name>  

191.        <!-- 资源种类  -->  

192.        <res-type>javax.sql.DataSoruce</res-type>  

193.        <!-- 资源由Application或Container来许可,如下面为Container  -->  

194.        <res-auth>Container</res-auth>  

195.        <!-- 资源是否可以共享.默认值为 Shareable 可选择Shareable|Unshareable -->  

196.        <res-sharing-scope>Unshareable</res-sharing-scope>   

197.    </resource-ref>   

198.      

199.</web-app>