Reference:《[Java] Web.xml配置详解》《主题:java web开发 web.xml配置文件说明》《Struts2的配置文件——web.xml(原创)》《Struts2 配置相关问题》---这个讲了很多Strust2的小问题,很详细。
位于每个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里面找到的。