The web.xml web application descriptor file represents the core of the Java web application, so it is appropriate that it is also part of the core of the Struts framework. In theweb.xml file, Struts defines its FilterDispatcher, the Servlet Filter class that initializes the Struts framework and handles all requests. This filter can contain initialization parameters that affect what, if any, additional configuration files are loaded and how the framework should behave.
In addition to the FilterDispatcher, Struts also provides an ActionContextCleanUp class that handles special cleanup tasks when other filters, such as those used by Sitemesh, need access to an initialized Struts framework.
Key Initialization Parameters
- config - a comma-delimited list of XML configuration files to load.(如果没有设置这个参数,默认加载struts-default.xml,struts-plugin.xml,struts.xml)
- actionPackages - a comma-delimited list of Java packages to scan for Actions.
- configProviders - a comma-delimited list of Java classes that implement theConfigurationProvider interface that should be used for building the Configuration.(Struts2使用StrutsXmlConfigurationProvider从xml文档中加载它的配置。configProviders参数让你可以指定自己的ConfigurationProvider接口实现。
- * - any other parameters are treated as framework constants.
Simple Example
Configuring web.xml for the framework is a matter of adding a filter and filter-mapping.
<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>
Taglib Example
Typically, configuring a taglib is neither required nor recommended. The taglib is included instruts-core.jar, and the container will discover it automatically.
If, for some reason, a taglib configuration is needed within web.xml, extract the TLD file from thestruts-core.jarMETA-INF folder, and add a taglib element to theweb.xml.
<!-- ... -->
</welcome-file-list>
<taglib>
<taglib-uri>/s</taglib-uri>
<taglib-location>/WEB-INF/struts-tags.tld</taglib-location>
</taglib>
</web-app>
http://struts.apache.org/2.0.8/docs/webxml.html