web.xml 文件是web应用程序描述符文件,表示了Java web应用程序的核心内容,所以它自然也是Struts框架的核心部分之一。在 web.xml 文件中,Struts 定义了 FilterDispatcher, 这个Servlet Filter 类初始化Struts框架并且处理所有的请求。这个过滤器可以包含初始化参数,这些参数会影响其他加载的配置文件,和框架的行文。
除了 FilterDispatcher,Struts 也提供一个ActionContextCleanUp 类,它在其他的过滤器,例如被sitemesh所使用的,需要访问一个初始化后的Struts框架时,会处理特殊的清理任务。
关键初始化参数
config - 要加载的用逗号分隔的XML配置文件列表
actionPackages - 用来扫描Action的Java包,用逗号分隔
configProviders - 用来构建Configuration的实现了ConfigurationProvider接口的Java类,用逗号分隔
loggerFactory - LoggerFactory实现类的名字。
* - 任意其他的参数都被当成框架的常量对待。
简单的例子
给框架配置 web.xml 只是添加一个过滤器和过滤器映射的问题。
FilterDispatcher 例子 (web.xml)
<web-app id="WebApp_9" version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<filter>
<filter-name>struts</filter-name>
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
<init-param>
<param-name>actionPackages</param-name>
<param-value>com.mycompany.myapp.actions</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>struts</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- ... -->
</web-app>
过滤器映射特别注意的地方
上面的例子中,我们把Struts的dispatcher映射到/*,这样Struts 2可以处理所有的接入请求。这是因为Struts 2 为产生HTML的标签从其自身的jar文件中提供静态内容,包括Dojo JavaScript 文件 (如果 S2.0, 或Dojo 插件,版本 S2.1+) 和 FreeMarker 模板。
如果过滤器映射到其他的样式,例如 /*.html,这是必须考虑到的情况,并且要单独抽出那些有Struts 2 jar文件和其他解决方案提供的内容。(因为有些内容是不对外开放的,所以URL样式要考虑清楚)
Taglib 例子
典型的,对标签库的配置是即不需要也不推荐的。标签库包含在 struts-core.jar文件中,并且容器会自动发现它的。
如果因特殊情况要在web.xml中配置标签库,那么就从 struts-core.jar META-INF 文件夹下抽取出TLD文件,并且给 web.xml添加一个 taglib 元素。
<!-- ... -->
</welcome-file-list>
<taglib>
<taglib-uri>/s</taglib-uri>
<taglib-location>/WEB-INF/struts-tags.tld</taglib-location>
</taglib>
</web-app>
除了 FilterDispatcher,Struts 也提供一个ActionContextCleanUp 类,它在其他的过滤器,例如被sitemesh所使用的,需要访问一个初始化后的Struts框架时,会处理特殊的清理任务。
关键初始化参数
config - 要加载的用逗号分隔的XML配置文件列表
actionPackages - 用来扫描Action的Java包,用逗号分隔
configProviders - 用来构建Configuration的实现了ConfigurationProvider接口的Java类,用逗号分隔
loggerFactory - LoggerFactory实现类的名字。
* - 任意其他的参数都被当成框架的常量对待。
简单的例子
给框架配置 web.xml 只是添加一个过滤器和过滤器映射的问题。
FilterDispatcher 例子 (web.xml)
<web-app id="WebApp_9" version="2.4"
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<filter>
<filter-name>struts</filter-name>
<filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class>
<init-param>
<param-name>actionPackages</param-name>
<param-value>com.mycompany.myapp.actions</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>struts</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- ... -->
</web-app>
过滤器映射特别注意的地方
上面的例子中,我们把Struts的dispatcher映射到/*,这样Struts 2可以处理所有的接入请求。这是因为Struts 2 为产生HTML的标签从其自身的jar文件中提供静态内容,包括Dojo JavaScript 文件 (如果 S2.0, 或Dojo 插件,版本 S2.1+) 和 FreeMarker 模板。
如果过滤器映射到其他的样式,例如 /*.html,这是必须考虑到的情况,并且要单独抽出那些有Struts 2 jar文件和其他解决方案提供的内容。(因为有些内容是不对外开放的,所以URL样式要考虑清楚)
Taglib 例子
典型的,对标签库的配置是即不需要也不推荐的。标签库包含在 struts-core.jar文件中,并且容器会自动发现它的。
如果因特殊情况要在web.xml中配置标签库,那么就从 struts-core.jar META-INF 文件夹下抽取出TLD文件,并且给 web.xml添加一个 taglib 元素。
<!-- ... -->
</welcome-file-list>
<taglib>
<taglib-uri>/s</taglib-uri>
<taglib-location>/WEB-INF/struts-tags.tld</taglib-location>
</taglib>
</web-app>