web.xml文件解读

每一个站的WEB-INF下都有一个web.xml的设定文件，它提供了我们站台的配置设定.

web.xml定义：
.站台的名称和说明
.针对环境参数(Context)做初始化工作
.Servlet的名称和映射
.Session的设定
.Tag library的对映
.JSP网页设定
.Mime Type处理
.错误处理
.利用JDNI取得站台资源

要了解web.xml的设定值，必须了解它的schema,从web.xml中知道它的schema是由Sum Microsystems公司定制的，如果你想更为详细的了解它，
可以到http://java.sun.com/xml/ns/j2ee/web-mapp_2_4.xsd网页，那里有更为详细的介绍。这里我介绍我们平常见得最都的.

 

1.站台的描述，站台名：<description>,<display-name>,<icon>

<description>站台描述</discription>                               <!--  对站台做出描述.-->

<display-name>站台名称</display-name>                    <!-- 定义站台的名称 .-->

<icon>
icon元素包含small-icon和large-icon两个子元素.用来指定web站台中小图标和大图标的路径.
<small-icon>/路径/smallicon.gif</small-icon>
small-icon元素应指向web站台中某个小图标的路径,大小为16 X 16 pixel,但是图象文件必须为GIF或JPEG格式,扩展名必须为:       .gif或.jpg.

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

范例:
<display-name>Develop Example</display-name>
<description>JSP 2.0 Tech Book's Examples</description>

<icon>
      <small-icon>/images/small.gif</small-icon>
      <large-icon>/images/large.gir</large-icon>
</icon>

 

2.<context-param> 设定web站台的环境参数(context),它包含两个子元素:param-name和param-value.
<param-name>参数名称</param-name>         <!--  设定Context名称 -->
<param-value>值</param-value>                       <!--  设定Context名称的值 -->

范例:
<context-param>
<param-name>param_name</param-name>
<param-value>param_value</param-value>
</context-param>

此所设定的参数,在JSP网页中可以使用下列方法来取得:
${initParam.param_name}
若在Servlet可以使用下列方法来获得:
String param_name=getServletContext().getInitParamter("param_name");

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

<filter-name>Filter的名称</filter-name>                  <!--  定义Filter的名称.  -->
<filter-class>Filter的类名称</filter-class>               <!-- 定义Filter的类名称.例如:com.foo.hello  -->

范例：

<filter>
<filter-name>setCharacterEncoding</filter-name>
<filter-class>coreservlet.javaworld.CH11.SetCharacterEncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>GB2312</param-value>
</init-param>
</filter>

4.<filter-mapping>的两个主要子元素filter-name和url-pattern.用来定义Filter所对应的URL.
<filter-name>Filter的名称</filter-name>     <!--  定义Filter的名称.  -->
<url-pattern>URL</url-pattern>                    <!-- Filter所对应的RUL.例如:<url-pattern>/Filter/Hello</url-pattern>   -->

<servlet-name>Servlet的名称<servlet-name>                                                   <!--  定义servlet的名称.  -->
<dispatcher>REQUEST|INCLUDE|FORWARD|ERROR</disaptcher>        <!--  设定Filter对应的请求方式,有RQUEST,INCLUDE,FORWAR,ERROR四种,默认为REQUEST.-->

范例:
<filter-mapping>
<filter-name>GZIPEncoding</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

 

5.<listener>用来定义Listener接口,它的主要子元素为<listener-class>
<listen-class>Listener的类名称</listener-class>           <!--   定义Listener的类名称.例如: com.foo.hello -->

<listener-class>coreservlet.javaworld.CH11.ContenxtListener</listener-class>
</listener>

 

6.<session-cofing>包含一个子元素session-timeout.定义web站台中的session参数.
<session-timeout>30</session-timeout>    <!--  定义这个web站台所有session的有效期限.单位为30分钟.  -->

7.<servlet-mapping>元素包含两个子元素servlet-name和url-pattern.用来定义servlet所对应URL.

<servlet-name>Servlet的名称</servlet-name>          <!--  定义Servlet的名称. -->
<url-pattern>Servlet URL</url-pattern>                       <!--  定义Servlet所对应的RUL.例如:<url-pattern>/Servlet/Hello</url-pattern>  -->
范例:
<servlet-mapping>
<servlet-name>LoginChecker</servlet-name>
<url-pattern>/LoginChecker</url-pattern>
</servlet-mapping>