SpringMVC是创建java web项目时比较常用的框架,其中web.xml配置文件是更不可少的,那么首先先了解java web中的web.xml文件。web.xml的学名叫做部署描述文件(DD),它不是Spring所特有的,而是在Servlet规范中定义的,是web应用的配置文件。
在tomcat容器启动后,会寻找项目中的web.xml文件,加载其中的信息,并创建一个ServletContext上下文对象,以后再web应用中可以获得其中的值。
1、web.xml的作用
首先java web项目中的并不是必须需要web.xml文件的。其次它主要的是用来配置欢迎页、servlet、filter、listener等以及定制servlet、JSP、Context初始化参数。
2、web.xml的模式(Schema)
web.xml的模式文件中定义了很多种的标签元素,在根标签中
中,有很多的模式文件,是由Sun公司定义的,每个都会指明web.xml使用的是哪个模式文件。
3.web.xml常见的标签加载顺序
context-param–> listener –> filter –> servlet
servlet目的是处理请求,而filter目的是拦截和过滤请求
如果在Web容器中使用Spring MVC,就要进行四个方面的配置
编写”(servlet-name)”-servlet.xml:这里的servlet-name是标签
指定的值,必须是相同的,下面例子中是springmvc-servlet.xml。
添加servlet定义配置DispatcherServlet:前端处理器控制器,接受HTTP请求和转发请求的类,是分发Controller请求的,是Spring的核心要素。
配置contextConfigLocation初始化参数:指定Spring IOC容器需要读取的定义了非web层的Bean(DAO/Service)的XML文件路径。可以指定多个XML文件路径,可以用逗号、冒号等来分隔。如果没有指定”contextConfigLocation”参数,则会在 /WEB-INF/下查找 “servlet-name(就是下图中必须相同的servlet-name)-servlet.xml” 这样的文件加载,也就是springmvc-servlet.xml。
配置ContextLoaderListerner:Spring MVC在Web容器中的启动类,负责Spring IOC容器在Web上下文中的初始化。
首先简单讲一下,web.xml的加载过程。当启动一个WEB项目时,容器包括(JBoss、Tomcat等)首先会读取项目web.xml配置文件里的配置,当这一步骤没有出错并且完成之后,项目才能正常地被启动起来。
这段代码指定文件类型定义(DTD),可以通过它检查XML文档的有效性。下面显示的元素有几个特性,这些特性告诉我们关于DTD的信息:
部署描述符的根元素是
正如您所看到的,这个元素含有23个子元素,而且子元素都是可选的。问号(?)表示子元素是可选的,而且只能出现一次。星号(*)表示子元素可在部署描述符中出现零次或多次。有些子元素还可以有它们自己的子元素。web.xml文件中
注意:在Servlet 2.3中,子元素必须按照DTD文件语法描述中指定的顺序出现。比如:如果部署描述符中的
使用上下文初始化参数
webAppRootKey
business.root
contextConfigLocation
/WEB-INF/spring-configuration/*.xml
5.1
5.2 什么情况下使用,为什么使用
比如定义一个管理员email地址用来从程序发送错误,或者与你整个应用程序有关的其他设置。使用自己定义的设置文件需要额外的代码和管理;直接在你的程序中使用硬编码(Hard-coding)参数值会给你之后修改程序带来麻烦,更困难的是,要根据不同的部署使用不同的设置;通过这种办法,可以让其他开发人员更容易找到相关的参数,因为它是一个用于设置这种参数的标准位置。
5.3 Spring配置文件:
配置Spring,必须需要
contextConfigLocation
/WEB-INF/spring-configuration/*.xml
org.springframework.web.context.ContextLoaderListener
对应工程目录结构如下所示:
部署在同一容器中的多个Web项目,要配置不同的webAppRootKey,web.xml文件中最好定义webAppRootKey参数,如果不定义,将会缺省为“webapp.root”,如下:
webAppRootKey
webapp.root
当然也不能重复,否则报类似下面的错误:
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为
webAppRootKey
business.root
webAppRootKey
pubbase.root
这样就不会出现冲突了。就可以在运行时动态地找到项目路径,在log4j.properties配置文件中可以按下面的方式使用webapp.root:log4j.appender.file.File=webapp.root:log4j.appender.file.File={webapp.root}/WEB-INF/logs/sample.log,就可以在运行时动态地找出项目的路径。
5.4 多个配置文件引用处理:
如果web.xml中有contextConfigLocation参数指定的Spring配置文件,则会去加载相应的配置文件,而不会去加载/WEB-INF/下的applicationContext.xml。但是如果没有指定的话,默认会去/WEB-INF/下加载applicationContext.xml。在一个Spring的实际项目中,如果有多个Spring配置文件,多个配置文件可以在web.xml里用空格分隔写入,如:
contextConfigLocation
applicationContext-database.xml,applicationContext.xml
多个配置文件里的交叉引用可以用ref的external或bean解决,
120
用于设置容器的session参数,比如: 用于指定http session的失效时间。默认时间设置在/conf/web.xml (30 minutes)。用来指定默认的会话超时时间间隔,以分钟为单位。该元素值必须为整数。如果 session-timeout元素的值为零或负数,则表示会话将永远不会超时。
org.springframework.web.util.Log4jConfigListener
org.springframework.web.context.ContextLoaderListener
com.yonyou.mcloud.cas.client.session.SingleSignOutHttpSessionListener
7.1 Listener介绍:
7.2 Listener配置:
配置Listener只要向Web应用注册Listener实现类即可,无序配置参数之类的东西,因为Listener获取的是Web应用ServletContext(Application)的配置参数。为Web应用配置Listener的两种方式:
我们选择web.xml这种配置方式,只有一个元素
org.springframework.web.context.ContextLoaderListener
这里的
context
org.springframework.web.context.ContextLoaderServlet
1
CharacterEncodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
forceEncoding
true
CAS Single Sign Out Filter
com.yonyou.mcloud.cas.client.session.SingleSignOutFilter
CAS Authentication Filter
com.yonyou.mcloud.cas.client.authentication.ExpandAuthenticationFilter
casServerLoginUrl
https://dev.yonyou.com:443/sso-server/login
serverName
http://10.1.215.40:80
CAS Validation Filter
org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter
casServerUrlPrefix
https://dev.yonyou.com:443/sso-server
serverName
http://10.1.215.40:80
proxyCallbackUrl
https://dev.yonyou.com:443/business/proxyCallback
proxyReceptorUrl
/proxyCallback
proxyGrantingTicketStorageClass
com.yonyou.mcloud.cas.client.proxy.MemcachedBackedProxyGrantingTicketStorageImpl
encoding
UTF-8
CAS HttpServletRequest Wrapper Filter
org.jasig.cas.client.util.HttpServletRequestWrapperFilter
CAS Assertion Thread Local Filter
org.jasig.cas.client.util.AssertionThreadLocalFilter
NoCache Filter
com.yonyou.mcloud.cas.client.authentication.NoCacheFilter
CharacterEncodingFilter
/*
NoCache Filter
/*
CAS Single Sign Out Filter
/*
CAS Validation Filter
/proxyCallback
CAS Authentication Filter
/*
CAS Validation Filter
/*
CAS HttpServletRequest Wrapper Filter
/*
CAS Assertion Thread Local Filter
/*
8.1 Filter介绍:
Filter可认为是Servle的一种“加强版”,主要用于对用户请求request进行预处理,也可以对Response进行后处理,是个典型的处理链。使用Filter的完整流程是:Filter对用户请求进行预处理,接着将请求HttpServletRequest交给Servlet进行处理并生成响应,最后Filter再对服务器响应HttpServletResponse进行后处理。Filter与Servlet具有完全相同的生命周期,且Filter也可以通过
换种说法,Servlet里有request和response两个对象,Filter能够在一个request到达Servlet之前预处理request,也可以在离开Servlet时处理response,Filter其实是一个Servlet链。以下是Filter的一些常见应用场合,
Filter可负责拦截多个请求或响应;一个请求或响应也可被多个Filter拦截。创建一个Filter只需两步:
Filter必须实现javax.servlet.Filter接口,在该接口中定义了三个方法:
8.2 Filter配置:
Filter配置与Servlet的配置非常相似,需要配置两部分:配置Filter名称和Filter拦截器URL模式。区别在于Servlet通常只配置一个URL,而Filter可以同时配置多个请求的URL。配置Filter有两种方式:
我们使用的是web.xml这种配置方式,下面重点介绍
8.21 字符集过滤器
CharacterEncodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
forceEncoding
true
CharacterEncodingFilter
/*
8.22 缓存控制
NoCache Filter
com.yonyou.mcloud.cas.client.authentication.NoCacheFilter
NoCache Filter
/*
8.23 登录认证
CAS Authentication Filter
com.yonyou.mcloud.cas.client.authentication.ExpandAuthenticationFilter
casServerLoginUrl
https://dev.yonyou.com:443/sso-server/login
serverName
http://10.1.215.40:80
CAS Authentication Filter
/*
登录认证,未登录用户导向CAS Server进行认证。
8.24 单点登出
CAS Single Sign Out Filter
org.jasig.cas.client.session.SingleSignOutFilter
CAS Single Sign Out Filter
/*
org.jasig.cas.client.session.SingleSignOutHttpSessionListener
CAS Server通知CAS Client,删除session,注销登录信息。
8.25 封装request
CAS HttpServletRequest Wrapper Filter
org.jasig.cas.client.util.HttpServletRequestWrapperFilter
CAS HttpServletRequest Wrapper Filter
/*
封装request, 支持getUserPrincipal等方法。
8.26 存放Assertion到ThreadLocal中
CAS Assertion Thread Local Filter
org.jasig.cas.client.util.AssertionThreadLocalFilter
CAS Assertion Thread Local Filter
/*
8.27 禁用浏览器缓存
NoCache Filter
com.yonyou.mcloud.cas.client.authentication.NoCacheFilter
NoCache Filter
/*
8.28 CAS Client向CAS Server进行ticket验证
CAS Validation Filter
org.jasig.cas.client.validation.Cas20ProxyReceivingTicketValidationFilter
casServerUrlPrefix
https://dev.yonyou.com:443/sso-server
serverName
http://10.1.215.40:80
proxyCallbackUrl
https://dev.yonyou.com:443/business/proxyCallback
proxyReceptorUrl
/proxyCallback
proxyGrantingTicketStorageClass
com.yonyou.mcloud.cas.client.proxy.MemcachedBackedProxyGrantingTicketStorageImpl
encoding
UTF-8
CAS Validation Filter
/proxyCallback
CAS Validation Filter
/*
business
org.springframework.web.servlet.DispatcherServlet
publishContext
false
1
LogOutServlet
com.yonyou.mcloud.cas.web.servlet.LogOutServlet
serverLogoutUrl
https://dev.yonyou.com:443/sso-server/logout
serverName
http://10.1.215.40:80/business/
LogOutServlet
/logout
business
/
9.1 Servlet介绍:
Servlet通常称为服务器端小程序,是运行在服务器端的程序,用于处理及响应客户的请求。Servlet是个特殊的java类,继承于HttpServlet。客户端通常只有GET和POST两种请求方式,Servlet为了响应这两种请求,必须重写doGet()和doPost()方法。大部分时候,Servlet对于所有的请求响应都是完全一样的,此时只需要重写service()方法即可响应客户端的所有请求。另外,HttpServlet有两个方法:
通常无需重写init()和destroy()两个方法,除非需要在初始化Servlet时,完成某些资源初始化的方法,才考虑重写init()方法,如果重写了init()方法,应在重写该方法的第一行调用super.init(config),该方法将调用HttpServlet的init()方法。如果需要在销毁Servlet之前,先完成某些资源的回收,比如关闭数据库连接,才需要重写destory方法()。
Servlet的生命周期,创建Servlet实例有两个时机:
每个Servlet的运行都遵循如下生命周期:
9.2 Servlet配置:
为了让Servlet能响应用户请求,还必须将Servlet配置在web应用中,配置Servlet需要修改web.xml文件。从Servlet3.0开始,配置Servlet有两种方式:
我们用web.xml文件来配置Servlet,需要配置
9.2.1
9.2.2
9.2.3
如果load-on-startup元素存在,而且也指定了jsp-file元素,则JSP文件会被重新编译成Servlet,同时产生的Servlet也被载入内存。
举个例子:如果有素两个Servlet元素都含有
9.2.4
9.2.5 加载Servlet的过程
容器的Context对象对请求路径(URL)做出处理,去掉请求URL的上下文路径后,按路径映射规则和Servlet映射路径(
9.3 DispatcherServlet在web.xml中的配置:
business
org.springframework.web.servlet.DispatcherServlet
publishContext
false
1
配置Spring MVC,指定处理请求的Servlet,有两种方式:
我们在平台项目两个工程中分别使用了不同的配置方式,介绍如下:
spring
org.springframework.web.servlet.DispatcherServlet
publishContext
false
contextConfigLocation
classpath:config/spring-servlet.xml
1
工程目录结构如下:
其中,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*来加载。
9.4 ContextLoaderListener和DispatcherServlet初始化上下文关系和区别:
从上图可以看出,ContextLoaderListener初始化的上下文加载的Bean是对于整个应用程序共享的,一般如:DAO层、Service层Bean;DispatcherServlet初始化的上下文加载的Bean是只对Spring MVC有效的Bean,如:Controller、HandlerMapping、HandlerAdapter等,该初始化上下文只加载Web相关组件。
注意:用户可以配置多个DispatcherServlet来分别处理不同的url请求,每个DispatcherServlet上下文都对应一个自己的子Spring容器,他们都拥有相同的父Spring容器(业务层,持久(dao)bean所在的容器)。
http://wiki.metawerx.net/wiki/Web.xml
http://www.cnblogs.com/konbluesky/articles/1925295.html
http://blog.csdn.net/sapphire_aling/article/details/6069764
http://blog.csdn.net/zndxlxm/article/details/8711626
http://blog.csdn.net/zhangliao613/article/details/6289114
http://www.cnblogs.com/bukudekong/archive/2011/12/26/2302081.html
http://blog.sina.com.cn/s/blog_92b93d6f0100ypp9.html
http://blog.csdn.net/heidan2006/article/details/3075730
http://zhidao.baidu.com/link?url=vBOBj5f2D1Zx3wSUJo-XphWrG6f7QPmfzk0UtS9Xk7p1SG_OdeCkiH6dT6eyHO-Pa6p4hLTEfvY7O9d_OM0Gua
http://www.blogjava.net/dashi99/archive/2008/12/30/249207.html
http://uule.iteye.com/blog/2051817
http://blog.csdn.net/javaer617/article/details/6432654
http://blog.csdn.net/seng3018/article/details/6758860
http://groups.tianya.cn/tribe/showArticle.jsp?groupId=185385&articleId=2704257273118260804105385
http://blog.csdn.net/qfs_v/article/details/2557128
http://www.blogjava.net/fancydeepin/archive/2013/03/30/java-ee_web-xml.html
http://wenku.baidu.com/link?url=P30DokIynD5zzRU2dtdkQhEwsHi-REKuBiHa_dK60bA6pQwggvX2mo9y9Mbb1tkYcsiRCaHBf-c
4ZgIG5POmbbcRO_OxDJUaW15n300xJrq
http://fyq891014.blog.163.com/blog/static/200740191201233052531278/
http://blog.163.com/sir_876/blog/static/11705223201111544523333/
http://www.guoweiwei.com/archives/797
http://www.open-open.com/lib/view/open1402751642806.html
http://sishuok.com/forum/blogPost/list/5188.html;jsessionid=EBC2151611BEB99BDF390C5CADBA693A
http://www.micmiu.com/j2ee/spring/spring-classpath-start/
http://elf8848.iteye.com/blog/2008595
http://blog.csdn.net/arvin_qx/article/details/6829873
轻量级javaEE企业应用实战(第3版) ---李刚
参考资料:https://blog.csdn.net/believejava/article/details/43229361#