web.xml详解

<?xml version="1.0" encoding="GB2312"?>

<!DOCTYPE web-app
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">

<web-app>
<display-name>Struts Blank Application</display-name>
<!--
配置ActionServlet 不管应用中包含多少个子应用,都只需配置一个ActionServlet,因为ActionServlet支持多线程,目前的Structs框架只允许在应用中配置一个ActionServlet
-->
<!--
这是struts中的Controller（控制器），系统的指令由其(ActionServlet 类)中转; 它从struts-config.xml中读取配置信息，并在服务器后台自动启动一个线程。
如果没有特别的要求（如添加语言编转功能），程序员可以不管这部分，照用就可以了.
-->
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>org.apache.struts.action.ActionServlet</servlet-class>
<!--init-param设置ActionServlet运行参数，对Servlet的运行环境进行初始化配置-->
<!--
以相对路径的方式指明Struts应用程序的配置文件位置;
如不设置，则默认值为/WEB-INF/struts-config.xml;
-->
<init-param>
<param-name>config</param-name>
<param-value>/WEB-INF/struts-config.xml</param-value>
</init-param>
<!--以相对路径的方式指明Struts子应用程序的配置文件位置;-->
<init-param>
<param-name>config/lfj</param-name>
<param-value>/WEB-INF/lfj/struts-config.xml</param-value>
</init-param>
<!--
设置Servlet的debug级别，控制日志记录的详细程度。
默认为0，记录相对最少的日志信息
-->
<init-param>
<param-name>debug</param-name>
<param-value>2</param-value>
</init-param>
<!--
设置Digester的debug级别 Digester是Struts框架所使用的用来解析xml配置文件的一个框架，通过该设置，可以查看不同详细等级的解析日志。
默认为0，记录相对最少的日志信息。
-->
<init-param>
<param-name>detail</param-name>
<param-value>2</param-value>
</init-param>
<!--
这个标记指示Web应用服务器在启动时加载这个Servlet（实例化并调用实例的init()方法），
标记的内容必须使用一个整数指定Servlet加载的顺序。
如果这个整数是负值，或者这个值没有出现，那么容器任意选择Servlet加载。
如果这个整数大于等于零，那么容器必须按照部署的顺序加载他们。
容器必须保证，拥有小的load-on-startup值的Servlet必须首先被加载，
如果Servlet有相同的load-on-start-up值，那么，容器将自动选择这些Servlet的加载顺序。
-->
<load-on-startup>2</load-on-startup>
</servlet>

<!-- Standard Action Servlet Mapping -->
<!--指定Sevrlet所要映射的后缀名，这个后缀名可以任意指定。-->
<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>

<!-- The Usual Welcome File List -->
<!--指定首先访问的页面-->
<!--
当客户访问Web应用时，如果仅仅给出Web应用的Root URL
没用指定具体的文件名，Web容器会自动调用Web应用的欢迎文件.
如果在Jboss中，Roor Url应该就是jboss-web.xml中context-root节点所指定的目录。
-->
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<!--welcome-file>index2.jsp</welcome-file-->
</welcome-file-list>
<!--指定错误处理页-->
<error-page>
<error-code>404</error-code>
<location>/commom/404.jsp</location>
</error-page>
<error-page>
<error-code>505</error-code>
<location>/commom/505.jsp</location>
</error-page>
<!--
为Web容器捕获的Java异常配置<error-page>,
需要设置<exception-type>子元素，它用于指定Java异常类。
Web容器可能捕获如下异常：
RuntimeException或Error、ServletException或它的子类、IOException或它的子类
-->
<error-page>
<exception-type>java.io.IOException</exception-type>
<location>/common/system_ioerror.jsp</location>
</error-page>

<!-- Struts Tag Library Descriptors -->
<!--配置标记库-->

<taglib>
<!--用于指定标签库的相对或者绝对URI地址，Web应用根据这一URI来访问标签库-->
<taglib-uri>/tags/struts-bean</taglib-uri>
<!--指定标签描述文件在文件资源系统中的物理位置-->
<taglib-location>/WEB-INF/struts-bean.tld</taglib-location>
</taglib>

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

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

<taglib>
<taglib-uri>/tags/struts-nested</taglib-uri>
<taglib-location>/WEB-INF/struts-nested.tld</taglib-location>
</taglib>

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

</web-app>
<!-- -->