转

容器加載Web工程的Web.xml文件介紹

 

这篇文章主要是综合网上关于web.xml的一些介绍，希望对大家有所帮助，也欢迎大家一起讨论。 ---题记

一、            Web.xml详解：

(一)  web.xml加载过程（步骤）

首先简单说一下，web.xml的加载过程。
当我们去启动一个WEB项目时，容器包括（JBoss、Tomcat等）首先会读取项目web.xml配置文件里的配置，当这一步骤没有出错并且完成之后，项目才能正常地被启动起来。
l  启动WEB项目的时候，容器首先会去它的配置文件web.xml读取两个节点:  
<listener></listener>和<context-param></context-param>。
l  紧接着，容器创建一个ServletContext（application），这个WEB项目所有部分都将共享这个上下文。
l  容器以<context-param></context-param>的name作为键，value作为值，将其转化为键值对，存入ServletContext。
l  容器创建<listener></listener>中的类实例，根据配置的class类路径<listener-class>来创建监听，在监听中会有contextInitialized(ServletContextEvent args)初始化方法，启动Web应用时，系统调用Listener的该方法，在这个方法中获得：
ServletContext application =ServletContextEvent.getServletContext();
context-param的值= application.getInitParameter("context-param的键");
得到这个context-param的值之后，你就可以做一些操作了。
l   举例：你可能想在项目启动之前就打开数据库，那么这里就可以在<context-param>中设置数据库的连接方式（驱动、url、user、password），在监听类中初始化数据库的连接。这个监听是自己写的一个类，除了初始化方法，它还有销毁方法，用于关闭应用前释放资源。比如:说数据库连接的关闭，此时，调用contextDestroyed(ServletContextEvent args)，关闭Web应用时，系统调用Listener的该方法。
l  接着，容器会读取<filter></filter>，根据指定的类路径来实例化过滤器。
l  以上都是在WEB项目还没有完全启动起来的时候就已经完成了的工作。如果系统中有Servlet，则Servlet是在第一次发起请求的时候被实例化的，而且一般不会被容器销毁，它可以服务于多个用户的请求。所以，Servlet的初始化都要比上面提到的那几个要迟。
总的来说，web.xml的加载顺序是: <context-param>-> <listener> -> <filter> -> <servlet>。其中，如果web.xml中出现了相同的元素，则按照在配置文件中出现的先后顺序来加载。
对于某类元素而言，与它们出现的顺序是有关的。以<filter>为例，web.xml中当然可以定义多个<filter>，与<filter>相关的一个元素是<filter-mapping>，注意，对于拥有相同<filter-name>的<filter>和<filter-mapping>元素而言，<filter-mapping>必须出现在<filter>之后，否则当解析到<filter-mapping>时，它所对应的<filter-name>还未定义。web容器启动初始化每个<filter>时，按照<filter>出现的顺序来初始化的，当请求资源匹配多个<filter-mapping>时，<filter>拦截资源是按照<filter-mapping>元素出现的顺序来依次调用doFilter()方法的。<servlet>同<filter>类似，此处不再赘述。

(二)    web.xml标签详解

1.      XML文档有效性检查

<!DOCTYPE web-app PUBLIC

"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun.com/dtd/web-app_2_3.dtd" >

这段代码指定文件类型定义(DTD)，可以通过它检查XML文档的有效性。下面显示的<!DOCTYPE>元素有几个特性，这些特性告诉我们关于DTD的信息：

  • web-app定义该文档(部署描述符，不是DTD文件)的根元素
  • PUBLIC意味着DTD文件可以被公开使用
  • "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"意味着DTD由Sun Microsystems, Inc.维护。该信息也表示它描述的文档类型是DTD Web Application 2.3，而且DTD是用英文书写的。
  • URL"http://java.sun.com/dtd/web-app_2_3.dtd"表示D文件的位置。

2.      <web-app></web-app>

部署描述符的根元素是<web-app>。DTD文件规定<web-app>元素的子元素的语法如下：

<!ELEMENT web-app (icon?, display-name?, description?, 
distributable?, context-param*, filter*, filter-mapping*, 
listener*, servlet*, servlet-mapping*, session-config?, 
mime-mapping*, welcome-file-list?, 
error-page*, taglib*, resource-env-ref*, resource-ref*, 
security-constraint*, login-config?, security-role*,env-entry*, 
ejb-ref*, ejb-local-ref*)> 
    正如您所看到的，这个元素含有23个子元素，而且子元素都是可选的。问号(？)表示子元素是可选的，而且只能出现一次。星号(*)表示子元素可在部署描述符中出现零次或多次。有些子元素还可以有它们自己的子元素。web.xml文件中<web-app>元素声明的是下面每个子元素的声明。下面讲述部署描述符中可能包含的所有子元素。

注意：

在Servlet 2.3中，子元素必须按照DTD文件语法描述中指定的顺序出现。比如：如果部署描述符中的<web-app>元素有<servlet>和<servlet-mapping>两个子元素，则<servlet>子元素必须出现在<servlet-mapping>子元素之前。在Servlet2.4中，顺序并不重要。

3.      <display-name></display-name>

<display-name>test-hwp-web-application</display-name>定义了web应用的名称，可以在http://localhost:8080/manager/html中显示。如下所示：

4.      <distributable/>

<distributable/>可以使用distributable元素来告诉servlet/JSP容器，Web容器中部署的应用程序适合在分布式环境下运行。

5.      <context-param></context-param>

[html] view
plain copy

 
  1. <!--****************************上下文初始化参数配***************************-->
  2. <context-param>
  3. <param-name>webAppRootKey</param-name>
  4. <param-value>business.root</param-value>
  5. </context-param>
  6. <!-- spring config -->
  7. <context-param>
  8. <param-name>contextConfigLocation</param-name>
  9. <param-value>/WEB-INF/spring-configuration/*.xml</param-value>
  10. </context-param>

<context-param>元素含有一对参数名和参数值，用作应用的Servlet上下文初始化参数，参数名在整个Web应用中必须是惟一的，在web应用的整个生命周期中上下文初始化参数都存在，任意的Servlet和jsp都可以随时随地访问它。<param-name>子元素包含有参数名，而<param-value>子元素包含的是参数值。作为选择，可用<description>子元素来描述参数。

  • 什么情况下使用，为什么使用<context-param>：

比如：定义一个管理员email地址用来从程序发送错误，或者与你整个应用程序有关的其他设置。使用自己定义的设置文件需要额外的代码和管理；直接在你的程序中使用硬编码（Hard-coding）参数值会给你之后修改程序带来麻烦，更困难的是，要根据不同的部署使用不同的设置；通过这种办法，可以让其他开发人员更容易找到相关的参数，因为它是一个用于设置这种参数的标准位置。

  • Spring配置文件：

配置Spring，必须需要<listener>，而<context-param>可有可无，如果在web.xml中不写<context-param>配置信息，默认的路径是/WEB-INF/applicationContext.xml，在WEB-INF目录下创建的xml文件的名称必须是applicationContext.xml。如果是要自定义文件名可以在web.xml里加入contextConfigLocation这个context参数：在<param-value>里指定相应的xml文件名，如果有多个xml文件，可以写在一起并以“,”号分隔，比如在business-client工程中，我们采用了自定义配置方式，<context-param>配置如下：

[html] view
plain copy

 
  1. <!-- spring config -->
  2. <context-param>
  3. <param-name>contextConfigLocation</param-name>
  4. <param-value>/WEB-INF/spring-configuration/*.xml</param-value>
  5. </context-param>
  6. <listener>
  7. <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  8. </listener>

对应工程目录结构如下所示：

  • webAppRootKey配置：

部署在同一容器中的多个Web项目，要配置不同的webAppRootKey，web.xml文件中最好定义webAppRootKey参数，如果不定义，将会缺省为“webapp.root”，如下：

[html] view
plain copy

 
  1. <!-- 应用路径  -->
  2. <context-param>
  3. <param-name>webAppRootKey</param-name>
  4. <param-value>webapp.root</param-value>
  5. </context-param>

当然也不能重复，否则报类似下面的错误：

Web app root system property already set to different value: 'webapp.root' = [/home/user/tomcat/webapps/project1/] instead of [/home/user/tomcat/webapps/project2/] - Choose
unique values for the 'webAppRootKey' context-param in your web.xml files!

意思是“webapp.root”这个key已经指向了项目1，不可以再指向项目2。多个项目要对webAppRootKey进行配置，我们工程主要是让log4j能将日志写到对应项目根目录下，比如：我们的项目的webAppRootKey为

[html] view
plain copy

 
  1. <!—business-client应用路径  -->
  2. <context-param>
  3. <param-name>webAppRootKey</param-name>
  4. <param-value> business.root </param-value>
  5. </context-param>
  6. <!—public-base应用路径  -->
  7. <context-param>
  8. <param-name>webAppRootKey</param-name>
  9. <param-value> pubbase.root</param-value>
  10. </context-param>

这样就不会出现冲突了。就可以在运行时动态地找到项目路径，在log4j.properties配置文件中可以按下面的方式使用${webapp.root}：

log4j.appender.file.File=${webapp.root}/WEB-INF/logs/sample.log

就可以在运行时动态地找出项目的路径。

  • 多个配置文件交叉引用处理：

如果web.xml中有contextConfigLocation参数指定的Spring配置文件，则会去加载相应的配置文件，而不会去加载/WEB-INF/下的applicationContext.xml。但是如果没有指定的话，默认会去/WEB-INF/下加载applicationContext.xml。

在一个团队使用Spring的实际项目中，应该需要多个Spring的配置文件，如何使用和交叉引用的问题：

多个配置文件可以在web.xml里用空格分隔写入，如：

[html] view
plain copy

 
  1. <context-param>
  2. <param-name>contextConfigLocation </param-name>
  3. <param-value> applicationContext-database.xml,applicationContext.xml</param-value>
  4. <context-param>

多个配置文件里的交叉引用可以用ref的external或bean解决，例如：

applicationContext.xml

[html] view
plain copy

 
  1. <bean id="userService" class="domain.user.service.impl.UserServiceImpl">
  2. <property name="dbbean">
  3. <ref bean="dbBean"/>
  4. </property>
  5. </bean>

dbBean在applicationContext-database.xml中。

  • 在不同环境下如何获取：
范例:
[html] view plain copy

 
  1. <context-param>
  2. <param-name>param_name</param-name>
  3. <param-value>param_value</param-value>
  4. </context-param>
此所设定的参数，在JSP网页中可以使用下列方法来取得：
${initParam.param_name}
若在Servlet可以使用下列方法来获得：
String param_name=getServletContext().getInitParamter("param_name");
Servlet的ServletConfig对象拥有该Servlet的ServletContext的一个引用，所以可这样取得上下文初始化参数：getServletConfig().getServletContext().getInitParameter()也可以在Servlet中直接调用getServletContext().getInitParameter()，两者是等价的。

6.       <session-config></session-config>

[html] view plain copy

 
  1. <!-- Set timeout to 120 minutes -->
  2. <session-config>
  3. <session-timeout>120</session-timeout>
  4. </session-config>

<session-config> 用于设置容器的session参数，比如：<session-timeout>用于指定http session的失效时间。默认时间设置在<jakarta>/conf/web.xml (30 minutes)。<session-timeout>用来指定默认的会话超时时间间隔，以分钟为单位。该元素值必须为整数。如果 session-timeout元素的值为零或负数，则表示会话将永远不会超时。

7.      <listener></listener>

[html] view plain copy

 
  1. <!--****************************监听器配置*********************************-->
  2. <!-- Spring的log4j监听器 -->
  3. <listener>
  4. <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
  5. </listener>
  6. <listener>
  7. <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  8. </listener>
  9. <!-- 与CAS Single Sign Out Filter配合，注销登录信息  -->
  10. <listener>
  11. <listener-class>com.yonyou.mcloud.cas.client.session.SingleSignOutHttpSessionListener</listener-class>
  12. </listener>
1.         Listener介绍：

<listener>为web应用程序定义监听器，监听器用来监听各种事件，比如：application和session事件，所有的监听器按照相同的方式定义，功能取决去它们各自实现的接口，常用的Web事件接口有如下几个：

  • ServletContextListener：用于监听Web应用的启动和关闭；
  • ServletContextAttributeListener：用于监听ServletContext范围（application）内属性的改变；
  • ServletRequestListener：用于监听用户的请求；
  • ServletRequestAttributeListener：用于监听ServletRequest范围（request）内属性的改变；
  • HttpSessionListener：用于监听用户session的开始和结束；
  • HttpSessionAttributeListener：用于监听HttpSession范围（session）内属性的改变。

<listener>主要用于监听Web应用事件，其中有两个比较重要的WEB应用事件：应用的启动和停止（starting up or shutting down）和Session的创建和失效（created or destroyed）。应用启动事件发生在应用第一次被Servlet容器装载和启动的时候；停止事件发生在Web应用停止的时候。Session创建事件发生在每次一个新的session创建的时候，类似地Session失效事件发生在每次一个Session失效的时候。为了使用这些Web应用事件做些有用的事情，我们必须创建和使用一些特殊的“监听类”。它们是实现了以下两个接口中任何一个接口的简单java类：javax.servlet.ServletContextListener或javax.servlet.http.HttpSessionListener，如果想让你的类监听应用的启动和停止事件，你就得实现ServletContextListener接口；想让你的类去监听Session的创建和失效事件，那你就得实现HttpSessionListener接口。

2.     Listener配置：
配置Listener只要向Web应用注册Listener实现类即可，无序配置参数之类的东西，因为Listener获取的是Web应用ServletContext（application）的配置参数。为Web应用配置Listener的两种方式：
l  使用@WebListener修饰Listener实现类即可。
l  在web.xml文档中使用<listener>进行配置。
我们选择web.xml这种配置方式，只有一个元素<listener-class>指定Listener的实现类，如下所示：

<listener>

<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>

</listener>

这里的<listener>用于Spring的加载，Spring加载可以利用ServletContextListener实现，也可以采用load-on-startup Servlet 实现，但是当<filter>需要用到bean时，但加载顺序是：先加载<filter>后加载<servlet>，则<filter>中初始化操作中的bean为null；所以，如果过滤器中要使用到bean，此时就可以根据加载顺序<listener> -> <filter> -> <servlet>，将spring的加载改成Listener的方式。

1)     利用ServletContextListener实现：
[html] view plain copy

 
  1. <servlet>
  2. <servlet-name>context</servlet-narne>
  3. <servlet-class>org.springframework.web.context.ContextLoaderServlet</servlet-class>
  4. <load-on-startup>1</load-on-startup>
  5. </servlet>
2)     采用load-on-startup Servlet 实现：
[html] view plain copy

 
  1. <listener>
  2. <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  3. </listener>
我们选择了第二种方式，在J2EE工程中web服务器启动的时候最先调用web.xml，上面这段配置的意思是加载spring的监听器，其中ContextLoaderListener的作用就是启动Web容器时，自动装配applicationContext.xml的配置信息，执行它所实现的方法。

8.      <filter></filter>

[html] view plain copy

 
  1. <!--****************************过滤器配置*********************************-->
  2. <!-- 字符集过滤器 -->
  3. <filter>
  4. <filter-name>CharacterEncodingFilter</filter-name>
  5. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  6. <init-param>
  7. <param-name>encoding</param-name>
  8. <param-value>UTF-8</param-value>
  9. </init-param>
  10. <init-param>
  11. <param-name>forceEncoding</param-name>
  12. <param-value>true</param-value>
  13. </init-param>
  14. </filter>
  15. <!-- 单点登出过滤器 -->
  16. <filter>
  17. <filter-name>CAS Single Sign Out Filter</filter-name>
  18. <filter-class>com.yonyou.mcloud.cas.client.session.SingleSignOutFilter</filter-class>
  19. </filter>
  20. <!-- 认证过滤器 -->
  21. <filter>
  22. <filter-name>CAS Authentication Filter</filter-name>
  23. <filter-class>com.yonyou.mcloud.cas.client.authentication.ExpandAuthenticationFilter</filter-class>
  24. <init-param>
  25. <param-name>casServerLoginUrl</param-name>
  26. <param-value>https://dev.yonyou.com:443/sso-server/login</param-value>
  27. </init-param>
  28. <init-param>
  29. <!--这里的server是服务端的IP -->
  30. <param-name>serverName</param-name>
  31. <param-value>http://10.1.215.40:80</param-value>
  32. </init-param>
  33. </filter>
  34. <!-- 验证ST/PT过滤器 -->
  35. <filter>
  36. <filter-name>CAS Validation Filter</filter-name>
  37. <filter-class>org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>
  38. <init-param>
  39. <param-name>casServerUrlPrefix</param-name>
  40. <param-value>https://dev.yonyou.com:443/sso-server</param-value>
  41. </init-param>
  42. <init-param>
  43. <param-name>serverName</param-name>
  44. <param-value>http://10.1.215.40:80</param-value>
  45. </init-param>
  46. <init-param>
  47. <param-name>proxyCallbackUrl</param-name>
  48. <param-value>https://dev.yonyou.com:443/business/proxyCallback</param-value>
  49. </init-param>
  50. <init-param>
  51. <param-name>proxyReceptorUrl</param-name>
  52. <param-value>/proxyCallback</param-value>
  53. </init-param>
  54. <init-param>
  55. <param-name>proxyGrantingTicketStorageClass</param-name>
  56. <param-value>com.yonyou.mcloud.cas.client.proxy.MemcachedBackedProxyGrantingTicketStorageImpl</param-value>
  57. </init-param>
  58. <!-- 解决中文问题 -->
  59. <init-param>
  60. <param-name>encoding</param-name>
  61. <param-value>UTF-8</param-value>
  62. </init-param>
  63. </filter>
  64. <filter>
  65. <filter-name>CAS HttpServletRequest Wrapper Filter</filter-name>
  66. <filter-class>org.jasig.cas.client.util.HttpServletRequestWrapperFilter</filter-class>
  67. </filter>
  68. <filter>
  69. <filter-name>CAS Assertion Thread Local Filter</filter-name>
  70. <filter-class>org.jasig.cas.client.util.AssertionThreadLocalFilter</filter-class>
  71. </filter>
  72. <filter>
  73. <filter-name>NoCache Filter</filter-name>
  74. <filter-class>com.yonyou.mcloud.cas.client.authentication.NoCacheFilter</filter-class>
  75. </filter>
  76. <!--****************************映射关系配置********************************-->
  77. <filter-mapping>
  78. <filter-name>CharacterEncodingFilter</filter-name>
  79. <url-pattern>/*</url-pattern>
  80. </filter-mapping>
  81. <filter-mapping>
  82. <filter-name>NoCache Filter</filter-name>
  83. <url-pattern>/*</url-pattern>
  84. </filter-mapping>
  85. <filter-mapping>
  86. <filter-name>CAS Single Sign Out Filter</filter-name>
  87. <url-pattern>/*</url-pattern>
  88. </filter-mapping>
  89. <filter-mapping>
  90. <filter-name>CAS Validation Filter</filter-name>
  91. <url-pattern>/proxyCallback</url-pattern>
  92. </filter-mapping>
  93. <filter-mapping>
  94. <filter-name>CAS Authentication Filter</filter-name>
  95. <url-pattern>/*</url-pattern>
  96. </filter-mapping>
  97. <filter-mapping>
  98. <filter-name>CAS Validation Filter</filter-name>
  99. <url-pattern>/*</url-pattern>
  100. </filter-mapping>
  101. <filter-mapping>
  102. <filter-name>CAS HttpServletRequest Wrapper Filter</filter-name>
  103. <url-pattern>/*</url-pattern>
  104. </filter-mapping>
  105. <filter-mapping>
  106. <filter-name>CAS Assertion Thread Local Filter</filter-name>
  107. <url-pattern>/*</url-pattern>
  108. </filter-mapping>
1.      Filter介绍：
Filter可认为是Servle的一种“加强版”，主要用于对用户请求request进行预处理，也可以对Response进行后处理，是个典型的处理链。使用Filter的完整流程是：Filter对用户请求进行预处理，接着将请求HttpServletRequest交给Servlet进行处理并生成响应，最后Filter再对服务器响应HttpServletResponse进行后处理。Filter与Servlet具有完全相同的生命周期，且Filter也可以通过<init-param>来配置初始化参数，获取Filter的初始化参数则使用FilterConfig的getInitParameter()。

换种说法，Servlet里有request和response两个对象，Filter能够在一个request到达Servlet之前预处理request，也可以在离开Servlet时处理response，Filter其实是一个Servlet链。以下是Filter的一些常见应用场合，

(1)认证Filter

(2)日志和审核Filter

(3)图片转换Filter

(4)数据压缩Filter

(5)密码Filter

(6)令牌Filter

(7)触发资源访问事件的Filter

(8)XSLT Filter

(9)媒体类型链Filter

Filter可负责拦截多个请求或响应；一个请求或响应也可被多个Filter拦截。创建一个Filter只需两步：

  • 创建Filter处理类
  • Web.xml文件中配置Filter

Filter必须实现javax.servlet.Filter接口，在该接口中定义了三个方法：

  • void init(FilterConfig config)：用于完成Filter的初始化。FilteConfig用于访问Filter的配置信息。
  • void destroy()：用于Filter销毁前，完成某些资源的回收。
  • void doFilter(ServletRequest request,ServletResponse response,FilterChain chain)：实现过滤功能的核心方法，该方法就是对每个请求及响应增加额外的处理。该方法实现对用户请求request进行预处理，也可以实现对服务器响应response进行后处理---它们的分界线为是否调用了chain.doFilter(request，response)，执行该方法之前，即对用户请求request进行预处理，执行该方法之后，即对服务器响应response进行后处理。
2.      Filter配置：
Filter可认为是Servlet的“增强版”，因此Filter配置与Servlet的配置非常相似，需要配置两部分：配置Filter名称和Filter拦截器URL模式。区别在于Servlet通常只配置一个URL，而Filter可以同时配置多个请求的URL。配置Filter有两种方式：
l  在Filter类中通过Annotation进行配置。
l  在web.xml文件中通过配置文件进行配置。
我们使用的是web.xml这种配置方式，下面重点介绍<filter>内包含的一些元素。
<filter>用于指定Web容器中的过滤器，可包含<filter-name>、<filter-class>、<init-param>、<icon>、<display-name>、<description>。
l  <filter-name>用来定义过滤器的名称，该名称在整个程序中都必须唯一。
l  <filter-class>元素指定过滤器类的完全限定的名称，即Filter的实现类。
l  <init-param>为Filter配置参数，与<context-param>具有相同的元素描述符<param-name>和<param-value>。
l  <filter-mapping>元素用来声明Web应用中的过滤器映射，过滤器被映射到一个servlet或一个URL 模式。这个过滤器的<filter>和<filter-mapping>必须具有相同的<filter-name>，指定该Filter所拦截的URL。过滤是按照部署描述符的<filter-mapping>出现的顺序执行的。
1)  字符集过滤器
 
[html] view plain copy

 
  1. <!-- 字符集过滤器 -->
  2. <filter>
  3. <filter-name>CharacterEncodingFilter</filter-name>
  4. <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
  5. <init-param>
  6. <param-name>encoding</param-name>
  7. <param-value>UTF-8</param-value>
  8. </init-param>
  9. <init-param>
  10. <param-name>forceEncoding</param-name>
  11. <param-value>true</param-value>
  12. </init-param>
  13. </filter>
  14. <filter-mapping>
  15. <filter-name>CharacterEncodingFilter</filter-name>
  16. <url-pattern>/*</url-pattern>
  17. </filter-mapping>
CharacterEncodingFilter类可以通过简单配置来帮我们实现字符集转换的功能，参数encoding用于指定编码类型，参数forceEncoding设为true时，强制执行request.setCharacterEncoding(this.encoding)和reponse.setCharacterEncoding(this.encoding)中的方法。
2)  缓存控制
[html] view plain copy

 
  1. <filter>
  2. <filter-name>NoCache Filter</filter-name>
  3. <filter-class>com.yonyou.mcloud.cas.client.authentication.NoCacheFilter</filter-class>
  4. </filter>
  5. <filter-mapping>
  6. <filter-name>NoCache Filter</filter-name>
  7. <!—表示对URL全部过滤-->
  8. <url-pattern>/*</url-pattern>
  9. </filter-mapping>
3)  登录认证
<!-- 认证过滤器 -->
[html] view plain copy

 
  1. <filter>
  2. <filter-name>CAS Authentication Filter</filter-name>
  3. <filter-class>com.yonyou.mcloud.cas.client.authentication.ExpandAuthenticationFilter</filter-class>
  4. <init-param>
  5. <param-name>casServerLoginUrl</param-name>
  6. <param-value>https://dev.yonyou.com:443/sso-server/login</param-value>
  7. </init-param>
  8. <init-param>
  9. <!--这里的server是服务端的IP -->
  10. <param-name>serverName</param-name>
  11. <param-value>http://10.1.215.40:80</param-value>
  12. </init-param>
  13. </filter>
  14. <filter-mapping>
  15. <filter-name>CAS Authentication Filter</filter-name>
  16. <url-pattern>/*</url-pattern>
  17. </filter-mapping>
登录认证，未登录用户导向CAS Server进行认证。
4)  单点登出
[html] view plain copy

 
  1. <filter>
  2. <filter-name>CAS Single Sign Out Filter</filter-name>
  3. <filter-class>org.jasig.cas.client.session.SingleSignOutFilter</filter-class>
  4. </filter>
  5. <filter-mapping>
  6. <filter-name>CAS Single Sign Out Filter</filter-name>
  7. <url-pattern>/*</url-pattern>
  8. </filter-mapping>
  9. <listener>
  10. <listener-class>org.jasig.cas.client.session.SingleSignOutHttpSessionListener</listener-class>
  11. </listener>
CAS Server通知CAS Client，删除session，注销登录信息。
5)  封装request
[html] view plain copy

 
  1. <filter>
  2. <filter-name>CAS HttpServletRequest Wrapper Filter</filter-name>
  3. <filter-class>org.jasig.cas.client.util.HttpServletRequestWrapperFilter</filter-class>
  4. </filter>
  5. <filter-mapping>
  6. <filter-name>CAS HttpServletRequest Wrapper Filter</filter-name>
  7. <url-pattern>/*</url-pattern>
  8. </filter-mapping>
封装request, 支持getUserPrincipal等方法。
6)  存放Assertion到ThreadLocal中
[html] view plain copy

 
  1. <filter>
  2. <filter-name>CAS Assertion Thread Local Filter</filter-name>
  3. <filter-class>org.jasig.cas.client.util.AssertionThreadLocalFilter</filter-class>
  4. </filter>
  5. <filter-mapping>
  6. <filter-name>CAS Assertion Thread Local Filter</filter-name>
  7. <url-pattern>/*</url-pattern>
  8. </filter-mapping>
7)  禁用浏览器缓存
[html] view plain copy

 
  1. <filter>
  2. <filter-name>NoCache Filter</filter-name>
  3. <filter-class>com.yonyou.mcloud.cas.client.authentication.NoCacheFilter</filter-class>
  4. </filter>
  5. <filter-mapping>
  6. <filter-name>NoCache Filter</filter-name>
  7. <url-pattern>/*</url-pattern>
  8. </filter-mapping>
8)  CAS Client向CAS Server进行ticket验证
[html] view plain copy

 
  1. <!-- 验证ST/PT过滤器 -->
  2. <filter>
  3. <filter-name>CAS Validation Filter</filter-name>
  4. <filter-class>org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter</filter-class>
  5. <init-param>
  6. <param-name>casServerUrlPrefix</param-name>
  7. <param-value>https://dev.yonyou.com:443/sso-server</param-value>
  8. </init-param>
  9. <init-param>
  10. <param-name>serverName</param-name>
  11. <param-value>http://10.1.215.40:80</param-value>
  12. </init-param>
  13. <init-param>
  14. <param-name>proxyCallbackUrl</param-name>
  15. <param-value>https://dev.yonyou.com:443/business/proxyCallback</param-value>
  16. </init-param>
  17. <init-param>
  18. <param-name>proxyReceptorUrl</param-name>
  19. <param-value>/proxyCallback</param-value>
  20. </init-param>
  21. <init-param>
  22. <param-name>proxyGrantingTicketStorageClass</param-name>
  23. <param-value>com.yonyou.mcloud.cas.client.proxy.MemcachedBackedProxyGrantingTicketStorageImpl</param-value>
  24. </init-param>
  25. <!-- 解决中文问题 -->
  26. <init-param>
  27. <param-name>encoding</param-name>
  28. <param-value>UTF-8</param-value>
  29. </init-param>
  30. </filter>
  31. <filter-mapping>
  32. <filter-name>CAS Validation Filter</filter-name>
  33. <url-pattern>/proxyCallback</url-pattern>
  34. </filter-mapping>
  35. <filter-mapping>
  36. <filter-name>CAS Validation Filter</filter-name>
  37. <url-pattern>/*</url-pattern>
  38. </filter-mapping>

9.      <servlet></servlet>

[html] view plain copy

 
  1. <!--****************************servlet配置******************************-->
  2. <!-- Spring view分发器  对所有的请求都由business对应的类来控制转发 -->
  3. <servlet>
  4. <servlet-name>business</servlet-name>
  5. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  6. <init-param>
  7. <param-name>publishContext</param-name>
  8. <param-value>false</param-value>
  9. </init-param>
  10. <load-on-startup>1</load-on-startup>
  11. </servlet>
  12. <!-- 用户登出 -->
  13. <servlet>
  14. <servlet-name>LogOutServlet</servlet-name>
  15. <servlet-class>com.yonyou.mcloud.cas.web.servlet.LogOutServlet</servlet-class>
  16. <init-param>
  17. <param-name>serverLogoutUrl</param-name>
  18. <param-value>https://dev.yonyou.com:443/sso-server/logout</param-value>
  19. </init-param>
  20. <init-param>
  21. <param-name>serverName</param-name>
  22. <param-value>http://10.1.215.40:80/business/</param-value>
  23. </init-param>
  24. </servlet>
  25. <!--****************************servlet映射关系配置*************************-->
  26. <servlet-mapping>
  27. <servlet-name>LogOutServlet</servlet-name>
  28. <url-pattern>/logout</url-pattern>
  29. </servlet-mapping>
  30. <servlet-mapping>
  31. <servlet-name>business</servlet-name>
  32. <url-pattern>/</url-pattern>
  33. </servlet-mapping>
  1. Servlet介绍：

Servlet通常称为服务器端小程序，是运行在服务器端的程序，用于处理及响应客户的请求。Servlet是个特殊的java类，继承于HttpServlet。客户端通常只有GET和POST两种请求方式，Servlet为了响应则两种请求，必须重写doGet()和doPost()方法。大部分时候，Servlet对于所有的请求响应都是完全一样的，此时只需要重写service()方法即可响应客户端的所有请求。

另外HttpServlet有两个方法

  • init(ServletConfig config)：创建Servlet实例时，调用该方法的初始化Servlet资源。
  • destroy()：销毁Servlet实例时，自动调用该方法的回收资源。

通常无需重写init()和destroy()两个方法，除非需要在初始化Servlet时，完成某些资源初始化的方法，才考虑重写init()方法，如果重写了init()方法，应在重写该方法的第一行调用super.init(config)，该方法将调用HttpServlet的init()方法。如果需要在销毁Servlet之前，先完成某些资源的回收，比如关闭数据库连接，才需要重写destory方法()。

Servlet的生命周期：

创建Servlet实例有两个时机：

  • 客户端第一次请求某个Servlet时，系统创建该Servlet的实例，大部分Servlet都是这种Servlet。
  • Web应用启动时立即创建Servlet实例，即load-on-start Servlet。

每个Servlet的运行都遵循如下生命周期：

  1. 创建Servlet实例。
  2. Web容器调用Servlet的init()方法，对Servlet进行初始化。
  3. Servlet初始化后，将一直存在于容器中，用于响应客户端请求，如果客户端发送GET请求，容器调用Servlet的doGet()方法处理并响应请求；如果客户端发送POST请求，容器调用Servlet的doPost()方法处理并响应请求。或者统一使用service()方法处理来响应用户请求。
  4. Web容器决定销毁Servlet时，先调用Servlet的destory()方法，通常在关闭Web应用时销毁Servlet实例。
  1. Servlet配置：

为了让Servlet能响应用户请求，还必须将Servlet配置在web应用中，配置Servlet需要修改web.xml文件。

从Servlet3.0开始，配置Servlet有两种方式：

  • 在Servlet类中使用@WebServlet Annotation进行配置。
  • 在web.xml文件中进行配置。

我们用web.xml文件来配置Servlet，需要配置<servlet>和<servlet-mapping>。

<servlet>用来声明一个Servlet。<icon>、<display-name>和<description>元素的用法和<filter>的用法相同。<init-param>元素与<context-param>元素具有相同的元素描述符，可以使用<init-param>子元素将初始化参数名和参数值传递给Servlet，访问Servlet配置参数通过ServletConfig对象来完成，ServletConfig提供如下方法：

java.lang.String.getInitParameter(java.lang.String name)：用于获取初始化参数

ServletConfig获取配置参数的方法和ServletContext获取配置参数的方法完全一样，只是ServletConfig是取得当前Servlet的配置参数，而ServletContext是获取整个Web应用的配置参数。

  1. <description>、<display-name>和<icon>
  • <description>：为Servlet指定一个文本描述。
  • <display-name>：为Servlet提供一个简短的名字被某些工具显示。
  • <icon>：为Servlet指定一个图标，在图形管理工具中表示该Servlet。
  1. <servlet-name>、<servlet-class>和<jsp-file>元素

<servlet>必须含有<servlet-name>和<servlet-class>，或者<servlet-name>和<jsp-file>。 描述如下：

  • <servlet-name>用来定义servlet的名称，该名称在整个应用中必须是惟一的
  • <servlet-class>用来指定servlet的完全限定的名称。
  • <jsp-file>用来指定应用中JSP文件的完整路径。这个完整路径必须由/开始。
  1. <load-on-startup>

如果load-on-startup元素存在，而且也指定了jsp-file元素，则JSP文件会被重新编译成Servlet，同时产生的Servlet也被载入内存。<load-on-startup>的内容可以为空，或者是一个整数。这个值表示由Web容器载入内存的顺序。

举个例子：如果有两个Servlet元素都含有<load-on-startup>子元素，则<load-on-startup>子元素值较小的Servlet将先被加载。如果<load-on-startup>子元素值为空或负值，则由Web容器决定什么时候加载Servlet。如果两个Servlet的<load-on-startup>子元素值相同，则由Web容器决定先加载哪一个Servlet。

<load-on-startup>1</load-on-startup>表示启动容器时，初始化Servlet。

  1. <servlet-mapping>

<servlet-mapping>含有<servlet-name>和<url-pattern>

  • <servlet-name>：Servlet的名字，唯一性和一致性，与<servlet>元素中声明的名字一致。
  • <url-pattern>：指定相对于Servlet的URL的路径。该路径相对于web应用程序上下文的根路径。<servlet-mapping>将URL模式映射到某个Servlet，即该Servlet处理的URL。
  1. 加载Servlet的过程

容器的Context对象对请求路径(URL)做出处理，去掉请求URL的上下文路径后，按路径映射规则和Servlet映射路径（<url- pattern>）做匹配，如果匹配成功，则调用这个Servlet处理请求。

  1. DispatcherServlet在web.xml中的配置：
[html] view plain copy

 
  1. <!-- Spring view分发器  对所有的请求都由business对应的类来控制转发 -->
  2. <servlet>
  3. <servlet-name>business</servlet-name>
  4. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  5. <init-param>
  6. <param-name>publishContext</param-name>
  7. <param-value>false</param-value>
  8. </init-param>
  9. <load-on-startup>1</load-on-startup>
  10. </servlet>
配置Spring MVC，指定处理请求的Servlet，有两种方式：
l  默认查找MVC配置文件的地址是：/WEB-INF/${servletName}-servlet.xml
l  可以通过配置修改MVC配置文件的位置，需要在配置DispatcherServlet时指定MVC配置文件的位置。
    我们在平台项目两个工程中分别使用了不同的配置方式，介绍如下：
我们在business-client工程中按照默认方式查找MVC的配置文件，配置文件目录为： /WEB-INF/business-servlet.xml。工程目录结构如下所示：


我们在public-base-server工程中，通过第2种方式进行配置，把spring-servlet.xml放到src/main/resources/config/spring-servlet.xml，则需要在配置DispatcherServlet时指定<init-param>标签。具体代码如下：
[html] view plain copy

 
  1. <servlet>
  2. <servlet-name>spring</servlet-name>
  3. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  4. <init-param>
  5. <param-name>publishContext</param-name>
  6. <param-value>false</param-value>
  7. </init-param>
  8. <init-param>
  9. <param-name>contextConfigLocation</param-name>
  10. <param-value>classpath:config/spring-servlet.xml</param-value>
  11. </init-param>
  12. <load-on-startup>1</load-on-startup>
  13. </servlet>
工程目录结构如下：




其中，classpath是web项目的类路径，可以理解为classes下面。因为无论这些配置文件放在哪，编译之后如果没有特殊情况的话都直接在classes下面。jar包的话虽然放在lib文件夹里，但实际上那些类可以直接引用，比如：com.test.ABC，仿佛也在classes下面一样。
在我们的工程里，经过验证，maven工程这两个


 路径经过编译后生成的文件都位于classes目录下，即这两个路径相当于类路径，在下面创建config文件夹（folder），然后创建自定义的xml配置文件即可。
classpath和classpath*区别：
同名资源存在时，classpath只从第一个符合条件的classpath中加载资源，而classpath*会从所有的classpath中加载符合条件的资源。classpath*，需要遍历所有的classpath，效率肯定比不上classpath，因此在项目设计的初期就尽量规划好资源文件所在的路径，避免使用classpath*来加载。
  1. ContextLoaderListener和DispatcherServlet初始化上下文关系和区别：

从上图可以看出，ContextLoaderListener初始化的上下文加载的Bean是对于整个应用程序共享的，一般如：DAO层、Service层Bean；DispatcherServlet初始化的上下文加载的Bean是只对Spring MVC有效的Bean，如：Controller、HandlerMapping、HandlerAdapter等，该初始化上下文只加载Web相关组件。
注意：用户可以配置多个DispatcherServlet来分别处理不同的url请求，每个DispatcherServlet上下文都对应一个自己的子Spring容器，他们都拥有相同的父Spring容器（业务层，持久（dao）bean所在的容器）。

10.<welcome-file-list></welcome-file-list>

[html] view plain copy

 
  1. <!-- welcome page -->
  2. <welcome-file-list>
  3. <welcome-file>index.html</welcome-file>
  4. </welcome-file-list>
<welcome-file-list>包含一个子元素<welcome-file>，<welcome-file>用来指定首页文件名称。<welcome-file-list>元素可以包含一个或多个<welcome-file>子元素。如果在第一个<welcome-file>元素中没有找到指定的文件，Web容器就会尝试显示第二个，以此类推。

容器加載Web工程的Web.xml文件介紹的更多相关文章

  1. 读取web工程中.properties资源文件的模板代码

    读取web工程中.properties资源文件的模板代码 // 读取web工程中.properties资源文件的模板代码 private void test2() throws IOException ...

  2. web工程中web.xml元素加载顺序以及配置实例

    简介 web.xml是web工程的配置文件,容器加载web工程时,会首先从WEB-INF中查询web.xml,并加载其中的配置信息,可以将web.xml认为是web工程的入口. web.xml中包含有 ...

  3. 解决Android工程里的xml文件自动提示问题

    昨天晚上看某培训机构的Android的 视频教程,看到他在写布局的XML文件时,有很方便的自动提示功能.我就在自己的Eclipse里试了一下,可是我的没实现.就到网上查,很多都说:在 Window-& ...

  4. 在WEB工程的web层中的编程技巧

    本篇以看传智播客方立勋老师的<JDBC入门>之<实现客户关系管理案例>视频有感,从中提取方老师在设计管理系统的简单案例中对自己比较有用的部分,以便日后在开发过程中希望能有所帮助 ...

  5. maven新建Spring MVC + MyBatis + Oracle的Web项目中pom.xml文件

    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/20 ...

  6. 关于eclipse创建web工程没有生成webapp文件夹的解决方案

    先看工程建立的是不是配置的打成War包,然后按下图所示

  7. eclipse加载maven工程提示pom.xml无法解析org.apache.maven.plugins:maven-resources-plugin:2.4.3解决方案

    pom文件提示信息: Failure to transfer org.apache.maven.plugins:maven-resources-plugin:pom:2.4.3 from http:/ ...

  8. IDEA 创建JAVA Maven Web 工程 不能建Sevlet文件

    JAVA目录下建包而不是文件夹 需要添加依赖 <dependency> <groupId>javax.servlet</groupId> <artifactI ...

  9. JavaWeb工程中web.xml基本配置

    一.理论准备 先说下我记得xml规则,必须有且只有一个根节点,大小写敏感,标签不嵌套,必须配对. web.xml是不是必须的呢?不是的,只要你不用到里面的配置信息就好了,不过在大型web工程下使用该文 ...

随机推荐

  1. saltstack主机管理项目：主机管理项目需求分析（一）

    1.场景: 我现在又一台裸机要实现一下任务 2.配置管理: 1.装上nginx,mysql 2.nginx用我指定的配置文件 3.mysql用户 4.设置一个默认的数据库访问权限 5.启动mysql ...

  2. 使用SIGALARM为connect设置超时

    static void connect_alarm(int); int connect_timeo(int sockfd, const SA *saptr, socklen_t salen, int ...

  3. CentOS安装VLC

    For EL7: rpm -Uvh https://dl.fedoraproject.org/pub/epel/7/x86_64/e/epel-release-7-9.noarch.rpm rpm - ...

  4. JAVA进阶11

    间歇性混吃等死,持续性踌躇满志系列-------------第11天 1.ArrayList package cn.intcast.demo11; import java.util.ArrayList ...

  5. TP5报错

    Array to string conversion 数组不能用echo来输出,可使用var_dump().dump()或print_r()

  6. oracle利用redo恢复

    oracle媒介恢复(Media Recovery) 官方资料 https://docs.oracle.com/database/121/ADMQS/GUID-CBC5870F-2C9A-4F67-B ...

  7. 论文笔记：Cross-Domain Visual Matching via Generalized Similarity Measure and Feature Learning

    Cross-Domain Visual Matching,即跨域视觉匹配.所谓跨域,指的是数据的分布不一样,简单点说,就是两种数据「看起来」不像.如下图中,(a)一般的正面照片和各种背景角度下拍摄的照 ...

  8. JVM的垃圾回收机制 总结(垃圾收集、回收算法、垃圾回收器)

     相信和小编一样的程序猿们在日常工作或面试当中经常会遇到JVM的垃圾回收问题,有没有在夜深人静的时候详细捋一捋JVM垃圾回收机制中的知识点呢?没时间捋也没关系,因为小编接下来会给你捋一捋. 一. 技术 ...

  9. 响应消息的内容类型 text/html; charset=utf-8 与绑定(application/soap+xml; charset=utf-8)的内容类型不匹配。

    问题表述: 响应消息的内容类型 text/html; charset=utf-8 与绑定(application/soap+xml; charset=utf-8)的内容类型不匹配. 说明: 此类问题当 ...

  10. Beta冲刺（7/7）

    目录 摘要 团队部分 个人部分 摘要 队名:小白吃 组长博客:hjj 作业博客:beta冲刺(7/7) 后敬甲(组长) 过去两天完成了哪些任务 ppt制作 视频拍摄 接下来的计划 准备答辩 还剩下哪些 ...