web.xml是web应用中加载有关servlet信息的重要配置文件,起着初始化servlet,filter等web程序的作用。
通常,所有的MVC框架都需要Web应用加载一个核心控制器,那采取什么方法加载这样的核心控制器呢,servlet或filter成为了很好的选择,
因为它们会随着web服务的启用而自动的载入。对于Struts 2框架而言,需要加载FilterDispatcher,
只要Web应用负责加载FilterDispatcher,FilterDispatcher将会加载应用的Struts 2框架。
因为Struts 2将核心控制器设计成Filter,而不是一个普通Servlet。故为了让Web应用加载FilterDispacher,只需要在web.xml文件中配置FilterDispatcher即可。
在web.xml里面配置struts。如果是2.1.3之前的版本,用 org.apache.struts2.dispatcher.FilterDispatcher,
以后的版本则配置org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter。
<!-- 配置Struts 2框架的核心Filter -->
<filter>
<!-- 配置Struts 2核心Filter的名字 -->
<filter-name>struts2</filter-name>
<!-- 配置Struts 2核心Filter的实现类 -->
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher
</filter-class>
<init-param>
<param-name>config </param-name>
<param-value>struts-default.xml,struts-plugin.xml,/WEB-INF/struts.xml </param-value>
</init-param>
<init-param>
<!-- 配置Struts 2框架默认加载的Action包结构 -->
<param-name>actionPackages</param-name>
<param-value>org.apache.struts2.showcase.person</param-value>
</init-param>
<!-- 配置Struts 2框架的配置提供者类 -->
<init-param>
<param-name>configProviders </param-name>
<param-value>lee.MyConfigurationProvider</param-value>
</init-param>
<!-- 配置Struts 2框架的常量 -->
<init-param>
<param-name>truts.enable.DynamicMethodInvocation</param-name>
<param-value>false</param-value>
</init-param>
<init-param>
<param-name>struts.devMode</param-name>
<param-value>false</param-value>
</init-param>
<init-param>
<param-name>struts.objectFactory</param-name>
<param-value>spring</param-value>
</init-param>
</filter>
<!-- 配置Filter拦截的URL -->
<filter-mapping>
<!-- 配置Struts 2的核心FilterDispatcher拦截所有用户请求 -->
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
其中有3个初始化参数有特殊意义:
config:该参数的值是一个以英文逗号(,)隔开的字符串,每个字符串都是一个XML配置文件的位置。Struts 2框架将自动加载该属性指定的系列配置文件。
actionPackages:该参数的值也是一个以英文逗号(,)隔开的字符串,每个字符串都是一个包空间,Struts 2框架将扫描这些包空间下的Action类。
configProviders:如果用户需要实现自己的ConfigurationProvider类,用户可以提供一个或多个实现了ConfigurationProvider接口的类,
然后将这些类的类名设置成该属性的值,多个类名之间以英文逗号(,)隔开。
除此之外,还可在此处配置Struts 2常量,每个<init-param>元素配置一个Struts 2常量,其中<param-name>子元素指定了常量name,
而<param-value>子元素指定了常量value。
至于filter-mapping属性是过滤器(Filter)必须的一个属性,用于过滤请求的路径,此处一般就设为/*形式,
对所有请求uri进行拦截(过滤),除非你要做一些特殊的处理。
到此,配置完struts2的核心控制器后,基本完成了struts2在web.xml文件中的配置。
注意点:如果web容器是J2EE1.3(servlet2.3),由于不会自动加载struts的标签库,所以需要在web.xml文件中手动加载struts的标签库,
文件名struts-tags.tld,一般放在WEB-INF下面,可以自己指定但如果web容器是J2EE1.4(servlet2.4),那么web容器会自动加载标签库,
Struts 2的标签库定义文件包含在struts2-core-2.0.6.jar文件里,在struts2-core-2.0.6.jar文件的META-INF路径下,包含了一个struts-tag.tld文件,
这个文件就是Struts 2的标签库定义文件,Servlet 2.4规范会自动加载该标签库文件,其中struts-tags.tld文件里包含了加载信息的片断:如下:
<taglib>
<!-- 定义标签库的版本 -->
<tlib-version>2.2.3</tlib-version>
<!-- 定义标签库所需的JSP版 -->
<jsp-version>1.2</jsp-version>
<short-name>s</short-name>
<!-- 定义Struts 2标签库的URI,jsp文件中应用的uri-->
<uri>/struts-tags</uri>...
</taglib>
而servlet2.3手动配置如下:
<!-- 手动配置Struts 2的标签库 -->
<taglib>
<!-- 配置Struts 2标签库的URI jsp文件中应用的uri,类似于名字空间-->
<taglib-uri>/s</taglib-uri>
<!-- 指定Struts 2标签库定义文件的物理位置 -->
<taglib-location>/WEB-INF/struts-tags.tld</taglib-location>
</taglib>