web.xml

 

位于每个Web应用的WEB-INF路径下的web.xml文件被称为配置描述符。这个 web.xml文件对于Java Web应用十分重要，每个Java Web应用都必须包含一个web.xml文件，且必须放在WEB-INF路径下。

对于Java Web应用而言，WEB-INF是一个特殊的文件夹，Web容器会包含该文件夹下的内容，客户端浏览器无法访问WEB-INF路径下的任何内容。 
Java Web应用的绝大部分内容都由web.xml文件来配置管理。

每个Web容器都会提供一个系统的web.xml文件，用于描述所有Web应用共同的配置属性。例如，Tomcat的系统web.xml放在Tomcat的conf路径下。

头和根元素：

所有部署描述符文件的顶层（根）元素为web-app。XML元素不像HTML，他们是大小写敏感的。因此，web-App和WEB-APP都是不合法的，web-app必须用小写。

下面的列表给出了所有可直接出现在web-app元素内的合法元素所必需的次序。例如，此列表说明servlet元素必须出现在所有servlet-mapping元素之前。请注意，所有这些元素都是可选的。因此，可以省略掉某一元素，但不能把它放于不正确的位置。

icon	icon元素指出IDE和GUI工具用来表示Web应用的一个和两个图像文件的位置。
display-name	display-name元素提供GUI工具可能会用来标记这个特定的Web应用的一个名称。
description	description元素给出与此有关的说明性文本。
context-param	声明应用范围内的初始化参数。
filter	过滤器元素将一个名字与一个实现javax.servlet.Filter接口的类相关联。  //Struts2用的就是filter
filter-mapping	一旦命名了一个过滤器，就要利用filter-mapping元素把它与一个或多个servlet或JSP页面相关联
listener	servlet API的版本2.3增加了对事件监听程序的支持，事件监听程序在建立、修改和删除会话或servlet环境时得到通知。Listener元素指出事件监听程序类
servlet	在向servlet或JSP页面制定初始化参数或定制URL时，必须首先命名servlet或JSP页面。Servlet元素就是用来完成此项任务的。
servlet-mapping	服务器一般为servlet提供一个缺省的URL：http://host/webAppPrefix/servlet/ServletName。但是，常常会更改这个URL，以便servlet可以访问初始化参数或更容易地处理相对URL。在更改缺省URL时，使用servlet-mapping元素。
session-config	如果某个会话在一定时间内未被访问，服务器可以抛弃它以节省内存。可通过使用HttpSession的setMaxInactiveInterval方法 明确设置单个会话对象的超时值，或者可利用session-config元素制定缺省超时值。
mime-mapping	如果Web应用具有想到特殊的文件，希望能保证给他们分配特定的MIME类型，则mime-mapping元素提供这种保证。
welcom-file-list	指示服务器在收到引用一个目录名而不是文件名的URL时，使用哪个文件。
error-page	error-page元素使得在返回特定HTTP状态代码时，或者特定类型的异常被抛出时，能够制定将要显示的页面。
taglib	对标记库描述符文件（Tag Libraryu Descriptor file）指定别名。此功能使你能够更改TLD文件的位置，而不用编辑使用这些文件的JSP页面。
resource-env-ref	声明与资源相关的一个管理对象。
resource-ref	声明一个资源工厂使用的外部资源
security-constraint	制定应该保护的URL。它与login-config元素联合使用
login-config	指定服务器应该怎样给试图访问受保护页面的用户授权。它与sercurity-constraint元素联合使用。
security-role	给出安全角色的一个列表，这些角色将出现在servlet元素内的security-role-ref元素的role-name子元素中。分别地声明角色可使高级IDE处理安全信息更为容易。
env-entry	声明Web应用的环境项
ejb-ref	声明一个EJB的主目录的引用。
ejb-local-ref	声明一个EJB的本地主目录的应用。

 

配置详解里面东西太多了我也懒得一一研究，主要关注的是servlet的那个<load-on-startup>标签。

<servlet>

<servlet-name> … </servlet-name>

<servlet-class> … </servlet-class> <!-- Or jsp-file -->

<load-on-startup/>

</servlet>

或者启动时按指定顺序装在多个servlet：

<servlet>

<servlet-name>Search</servlet-name>

<servlet-class>myPackage.SearchServlet</servlet-class> <!-- Or jsp-file -->

<load-on-startup>1</load-on-startup>

</servlet>

<servlet>

<servlet-name>Results</servlet-name>

<servlet-class>/results/index.jsp</servlet-class> <!-- Or jsp-file -->

<load-on-startup>2</load-on-startup>

</servlet>

在这里给出安装Struts2的web.xml代码：

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

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

	xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"

	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"

	id="WebApp_ID" version="3.0">

	

     <display-name>myStruts2</display-name>

     <filter>  

        <!-- 配置Struts2核心Filter的名字 -->  

        <filter-name>struts2</filter-name>  

        <!-- 配置Struts2核心Filter的实现类 -->  

        <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>  

          <init-param>  

              <!-- 配置Struts2框架默认加载的Action包结构，可以没有。 -->  

              <param-name>actionPackages</param-name>  

              <param-value>org.apache.struts2.showcase.person</param-value>  

          </init-param>  

          <!-- 配置Struts2框架的配置提供者类 -->  

          <init-param>  

              <param-name>configProviders</param-name>  

              <param-value>lee.MyConfigurationProvider</param-value>  

          </init-param>  

    </filter>  

    <!-- 配置Filter拦截的URL -->  

    <filter-mapping>  

        <!-- 配置Struts2的核心FilterDispatcher拦截所有用户请求 -->  

        <filter-name>struts2</filter-name>  

        <url-pattern>/*</url-pattern>  

    </filter-mapping>  

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

    </welcome-file-list>  

</web-app>

当配置Struts2的FilterDispatcher类时，可以指定一系列的初始化参数，为该Filter配置初始化参数时，其中有3个初始化参数有特殊意义： 
config：使用逗号隔开的字符串，每个字符串都是一个XML配置文件的位置。Struts框架将自动加载该属性指定的系列配置文件。 
actionPackages：使用逗号隔开的字符串，每个字符串都是一个包空间，Struts2框架将扫描这些包空间下的Action。 
configProviders：配置自己的ConfigurationProvider类。 
还可以在此处配置Struts2常量，每个<init-param>元素配置一个Struts2常量，其中<param-name>子元素指定了常量name，而<param-value>子元素指定了常量value。 
*在web.xml中配置了<Filter>元素，还需要配置该Filter拦截的URL。通常，我们让该Filter拦截所有的用户请求。可以能过<filter-mapping>元素配置。

 

上述代码是Struts2.1的，Struts 2.2.1 配置略有不同

<filter>

  <filter-name>struts2</filter-name>

  <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>

</filter>

<filter-mapping>
  <filter-name>struts2</filter-name>

   <url-pattern>/*</url-pattern>

</filter-mapping>

有一点比较坑爹是struts2.2.1 会报错,原因是少包.Struts2最新版本2.2.1中所设计的核心库文件，包括以下内容:

struts2-core-2.2.1.jar ：Struts2框架的核心类库。 
xwork-core-2.2.1.jar ：Xwork核心类库，Struts2在其上构建。 
ognl-3.0.jar ：对象图导航语言（Object Graph Navigation Language），它是一种功能强大的表达式语言（Expression Language，简称为EL），通 过它简单一致的表达式语法，可以存取对象的任意属性，调用对象的方法，遍历整个对象的结构图，实现字段类型转化等功能。 
freemarker-2.3.16.jar ：Struts 2的UI标签的模板使用FreeMarker编写。 
commons-fileupload-1.2.1.jar ：文件上传组件，2.1.6版本后必须加入此文件。 
commons-io-1.3.2.jar ：IO输入输出流组件，主要完成文件的读写功能。 
javassist-3.7.ga.jar ：Javassist是一个开源的分析、编辑和创建Java字节码的类库。

-------------------------------------------------------------------

commons-logging-1.0.4.jar ：ASF出品的日志包，Struts2框架使用这个日志包来支持Log4J和JDK 1.4版本之上的日志记录

注意: javassist-3.7.ga.jar struts2源码包里没有，可以去下载。也可以ognl-3.0.jar  替换成ognl-2.6.11.jar，这 样就不必要加javassist-3.7.ga.jar。我是在其随源码包一起下载来Demo WenApp里面找到的。

文章转自http://www.cnblogs.com/jersey/archive/2011/03/28/1997662.html