关键是web.xml

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里面找到的。

posted on 2011-03-28 13:44  Jersey  阅读(3468)  评论(1编辑  收藏  举报