2023年11月28日发(作者:)
配置⽂件超详细说明!!!
⼀、是什么?
⾸先 是java web 项⽬的⼀个重要的配置⽂件,但是⽂件并不是Java web⼯程必须的。
⽂件是⽤来配置:欢迎页、servlet、filter等的。当你的web⼯程没⽤到这些时,你可以不⽤⽂件来配置你的web⼯程。
所在位置 项⽬名/web/WEB-INFO/,如下图所⽰
能做的事情:
其实,的模式(Schema)⽂件中定义了多少种标签元素,中就可以出现它的模式⽂件所定义的标签元素,它就能拥有定义出来的那些功能。
的模式⽂件是由Sun公司定义的,每个⽂件的根元素
配置⽂件 具体的内容
⼆、详解:
加载过程(步骤)
⾸先简单讲⼀下,的加载过程。当启动⼀个WEB项⽬时,容器包括(JBoss、Tomcat等)⾸先会读取项⽬配置⽂件⾥的配置,当这⼀步骤没有出错并且完成之
后,项⽬才能正常地被启动起来。
1. 启动WEB项⽬的时候,容器⾸先会去它的配置⽂件读取两个节点:
2. 紧接着,容器创建⼀个ServletContext(application),这个WEB项⽬所有部分都将共享这个上下⽂。
3. 容器以
4. 容器创建
Web应⽤时,系统调⽤Listener的该⽅法,在这个⽅法中获得:
[html]
1. ServletContextapplication=vletContext();
context-param的值就是tParameter("context-param的键");得到这个context-param的值之后,你就可
以做⼀些操作了。
5. 举例:你可能想在项⽬启动之前就打开数据库,那么这⾥就可以在
接。这个监听是⾃⼰写的⼀个类,除了初始化⽅法,它还有销毁⽅法,⽤于关闭应⽤前释放资源。⽐如:说数据库连接的关闭,此时,调⽤contextDestroyed(ServletContextEvent
args),关闭Web应⽤时,系统调⽤Listener的该⽅法。
6. 接着,容器会读取
7. 以上都是在WEB项⽬还没有完全启动起来的时候就已经完成了的⼯作。如果系统中有Servlet,则Servlet是在第⼀次发起请求的时候被实例化的,⽽且⼀般不会被容器销毁,
它可以服务于多个⽤户的请求。所以,Servlet的初始化都要⽐上⾯提到的那⼏个要迟。
8. 总的来说,的加载顺序是:
9. 对于某类元素⽽⾔,与它们出现的顺序是有关的。以
动初始化每个
doFilter()⽅法的。
标签详解
1. XML⽂档有效性检查
[html]
1.
这段代码指定⽂件类型定义(DTD),可以通过它检查XML⽂档的有效性。下⾯显⽰的元素有⼏个特性,
这些特性告诉我们关于DTD的信息:
1. web-app定义该⽂档(部署描述符,不是DTD⽂件)的根元素
2. PUBLIC意味着DTD⽂件可以被公开使⽤
3. -//Sun Microsystems, Inc.//DTD Web Application 2.3//EN”意味着DTD由Sun Microsystems, Inc.维护。该信息也表⽰它描述的⽂档类型是DTD Web Application 2.3,⽽且
DTD是⽤英⽂书写的。
4. URL""表⽰D⽂件的位置。
2.
部署描述符的根元素是
[html]
1. 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个⼦元素,⽽且⼦元素都是可选的。问号(?)表⽰⼦元素是可选的,⽽且只能出现⼀次。星号(*)表⽰⼦元素可在部署描述符中出现零次或多 次。有些⼦元素还可以有它们⾃⼰的⼦元素。⽂件中 注意:在Servlet 2.3中,⼦元素必须按照DTD⽂件语法描述中指定的顺序出现。⽐如:如果部署描述符中的 3. 4. 5. 使⽤上下⽂初始化参数 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 5.1 都存在,任意的Servlet和jsp都可以随时随地访问它。 述参数。 5.2 什么情况下使⽤,为什么使⽤ ⽐如:定义⼀个管理员email地址⽤来从程序发送错误,或者与你整个应⽤程序有关的其他设置。使⽤⾃⼰定义的设置⽂件需要额外的代码和管理;直接在你的程序中使⽤硬编码 (Hard-coding)参数值会给你之后修改程序带来⿇烦,更困难的是,要根据不同的部署使⽤不同的设置;通过这种办法,可以让其他开发⼈员更容易找到相关的参数,因为它是 ⼀个⽤于设置这种参数的标准位置。 5.3 Spring配置⽂件: 配置Spring,必须需要 ⽬录下创建的xml⽂件的名称必须是。如果是要⾃定义⽂件名可以在⾥加⼊contextConfigLocation这个context参数:在 ⾥指定相应的xml⽂件名,如果有多个xml⽂件,可以写在⼀起并以“,”号分隔,⽐如在business-client⼯程中,我们采⽤了⾃定义配置⽅式, 如下: 1. 2. 3. 4. 5. 6. 7. 8. 对应⼯程⽬录结构如下所⽰: 部署在同⼀容器中的多个Web项⽬,要配置不同的webAppRootKey,⽂件中最好定义webAppRootKey参数,如果不定义,将会缺省为“”,如下: 1. 2. 3. 4. 5. 当然也不能重复,否则报类似下⾯的错误: Web app root system property already set to different value: '' = [/home/user/tomcat/webapps/project1/] instead of [/home/user/tomcat/webapps/project2/] - Choose unique values for the 'webAppRootKey' context-param in your files! 意思是“”这个key已经指向了项⽬1,不可以再指向项⽬2。多个项⽬要对webAppRootKey进⾏配置,我们⼯程主要是让log4j能将⽇志写到对应项⽬根⽬录下,⽐ 如:我们的项⽬的webAppRootKey为 1. 应⽤路径 --> 2. 3. 4. 5. 6. 应⽤路径 --> 7. 8. 9. 10. 这样就不会出现冲突了。就可以在运⾏时动态地找到项⽬路径,在ties配置⽂件中可以按下⾯的⽅式使⽤${}: =${}/WEB-INF/logs/ 就可以在运⾏时动态地找出项⽬的路径。 5.4 多个配置⽂件交叉引⽤处理: 如果中有contextConfigLocation参数指定的Spring配置⽂件,则会去加载相应的配置⽂件,⽽不会去加载/WEB-INF/下的。但是如果没有指定的 话,默认会去/WEB-INF/下加载。 在⼀个团队使⽤Spring的实际项⽬中,应该需要多个Spring的配置⽂件,如何使⽤和交叉引⽤的问题: 多个配置⽂件可以在⾥⽤空格分隔写⼊,如: 1. 2. 3. 4. 多个配置⽂件⾥的交叉引⽤可以⽤ref的external或bean解决,例如: 1. 2. 3. 4. 5. dbBean在中。 5.5 在不同环境下如何获取:范例: 1. 2. 3. 4. 此所设定的参数,在JSP⽹页中可以使⽤下列⽅法来取得: ${_name} 若在Servlet可以使⽤下列⽅法来获得: String param_name=getServletContext().getInitParamter("param_name"); Servlet的ServletConfig对象拥有该Servlet的ServletContext的⼀个引⽤,所以可这样取得上下⽂初始化参数:getServletConfig().getServletContext().getInitParameter()也可以在 Servlet中直接调⽤getServletContext().getInitParameter(),两者是等价的。 6. 1. 2. 3. 4. timeout>⽤来指定默认的会话超时时间间隔,以分钟为单位。该元素值必须为整数。如果 session-timeout元素的值为零或负数,则表⽰会话将永远不会超时。 7. 1. 2. 3. 4. 8. 9. 10. 11. 12. 7.1 Listener介绍: ⽤的Web事件接⼝有如下⼏个: (1). ServletContextListener:⽤于监听Web应⽤的启动和关闭; (2). ServletContextAttributeListener:⽤于监听ServletContext范围(application)内属性的改变; (3). ServletRequestListener:⽤于监听⽤户的请求; (4). ServletRequestAttributeListener:⽤于监听ServletRequest范围(request)内属性的改变; (5). HttpSessionListener:⽤于监听⽤户session的开始和结束; (6). HttpSessionAttributeListener:⽤于监听HttpSession范围(session)内属性的改变。 destroyed)。应⽤启动事件发⽣在应⽤第⼀次被Servlet容器装载和启动的时候;停⽌事件发⽣在Web应⽤停⽌的时候。Session创建事件发⽣在每次⼀个新的session创建的时 候,类似地Session失效事件发⽣在每次⼀个Session失效的时候。为了使⽤这些Web应⽤事件做些有⽤的事情,我们必须创建和使⽤⼀些特殊的“监听类”。它们是实现了以下两 个接⼝中任何⼀个接⼝的简单java类:tContextListener或ssionListener,如果想让你的类监听应⽤的启动和停⽌事件,你就得实现 ServletContextListener接⼝;想让你的类去监听Session的创建和失效事件,那你就得实现HttpSessionListener接⼝。 7.2 Listener配置: 配置Listener只要向Web应⽤注册Listener实现类即可,⽆序配置参数之类的东西,因为Listener获取的是Web应⽤ServletContext(application)的配置参数。为Web应⽤配置 Listener的两种⽅式: (1). 使⽤@WebListener修饰Listener实现类即可。 (2). 在⽂档中使⽤ 我们选择这种配置⽅式,只有⼀个元素 1. 2. 3. 这⾥的 是:先加载 spring的加载改成Listener的⽅式。 (1). 利⽤ServletContextListener实现: 1. 2. 3. 4. 5. (2).采⽤load-on-startup Servlet 实现: 1. 2. 3. 我们选择了第⼆种⽅式,在J2EE⼯程中web服务器启动的时候最先调⽤,上⾯这段配置的意思是加载spring的监听器,其中ContextLoaderListener的作⽤就是启动Web 容器时,⾃动装配的配置信息,执⾏它所实现的⽅法。 8. 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 59. 60. 61. 105. 106. 107. 108. 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的⼀些常见应⽤场合, (1)认证Filter (2)⽇志和审核Filter (3)图⽚转换Filter (4)数据压缩Filter (5)密码Filter (6)令牌Filter (7)触发资源访问事件的Filter (8)XSLT Filter (9)媒体类型链Filter Filter可负责拦截多个请求或响应;⼀个请求或响应也可被多个Filter拦截。创建⼀个Filter只需两步: (1) 创建Filter处理类 (2) ⽂件中配置Filter Filter必须实现接⼝,在该接⼝中定义了三个⽅法: (1) void init(FilterConfig config):⽤于完成Filter的初始化。FilteConfig⽤于访问Filter的配置信息。 (2) void destroy():⽤于Filter销毁前,完成某些资源的回收。 (3) void doFilter(ServletRequest request,ServletResponse response,FilterChain chain):实现过滤功能的核⼼⽅法,该⽅法就是对每个请求及响应增加额外的处理。该⽅法实现 对⽤户请求request进⾏预处理,也可以实现对服务器响应response进⾏后处理---它们的分界线为是否调⽤了er(request,response),执⾏该⽅法之前,即对⽤户请求 request进⾏预处理,执⾏该⽅法之后,即对服务器响应response进⾏后处理。 8.2 Filter配置: Filter可认为是Servlet的“增强版”,因此Filter配置与Servlet的配置⾮常相似,需要配置两部分:配置Filter名称和Filter拦截器URL模式。区别在于Servlet通常只配置⼀个URL,⽽ Filter可以同时配置多个请求的URL。配置Filter有两种⽅式: (1). 在Filter类中通过Annotation进⾏配置。 (2). 在⽂件中通过配置⽂件进⾏配置。 我们使⽤的是这种配置⽅式,下⾯重点介绍 (1). (2). (3). (4). name>,指定该Filter所拦截的URL。过滤是按照部署描述符的 8.21 字符集过滤器 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. CharacterEncodingFilter类可以通过简单配置来帮我们实现字符集转换的功能,参数encoding⽤于指定编码类型,参数forceEncoding设为true时,强制执⾏ racterEncoding(ng)和racterEncoding(ng)中的⽅法。 8.22 缓存控制 1. 2. 3. 4. 5. 6. 7. 表⽰对URL全部过滤--> 8. 9. 8.23 登录认证 1. 2. 3. 4. 5. 6. 7. 8. 封装request, ⽀持getUserPrincipal等⽅法。 8.26 存放Assertion到ThreadLocal中 1. 2. 3. 4. 5. 6. 21. 22. 23. 24. 25. 26. 27. 28. 29. 28. 29. 30. 31. 32. 33. 9.1 Servlet介绍: Servlet通常称为服务器端⼩程序,是运⾏在服务器端的程序,⽤于处理及响应客户的请求。Servlet是个特殊的java类,继承于HttpServlet。客户端通常只有GET和POST两种请 求⽅式,Servlet为了响应则两种请求,必须重写doGet()和doPost()⽅法。⼤部分时候,Servlet对于所有的请求响应都是完全⼀样的,此时只需要重写service()⽅法即可响应客户 端的所有请求。 另外,HttpServlet有两个⽅法: (1). init(ServletConfig config):创建Servlet实例时,调⽤该⽅法的初始化Servlet资源。 (2). destroy():销毁Servlet实例时,⾃动调⽤该⽅法的回收资源。 通常⽆需重写init()和destroy()两个⽅法,除⾮需要在初始化Servlet时,完成某些资源初始化的⽅法,才考虑重写init()⽅法,如果重写了init()⽅法,应在重写该⽅法的第⼀⾏调⽤ (config),该⽅法将调⽤HttpServlet的init()⽅法。如果需要在销毁Servlet之前,先完成某些资源的回收,⽐如关闭数据库连接,才需要重写destory⽅法()。 Servlet的⽣命周期: 创建Servlet实例有两个时机: (1). 客户端第⼀次请求某个Servlet时,系统创建该Servlet的实例,⼤部分Servlet都是这种Servlet。 (2). 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实例。 9.2 Servlet配置: 为了让Servlet能响应⽤户请求,还必须将Servlet配置在web应⽤中,配置Servlet需要修改⽂件。从Servlet3.0开始,配置Servlet有两种⽅式: (1). 在Servlet类中使⽤@WebServlet Annotation进⾏配置。 (2). 在⽂件中进⾏配置。 我们⽤⽂件来配置Servlet,需要配置 法相同。 ServletConfig对象来完成,ServletConfig提供如下⽅法: tParameter( name):⽤于获取初始化参数 ServletConfig获取配置参数的⽅法和ServletContext获取配置参数的⽅法完全⼀样,只是ServletConfig是取得当前Servlet的配置参数,⽽ServletContext是获取整个Web应⽤的配 置参数。 (1). 1). 2). 3). (2). 1). 2). 3). (3). 如果load-on-startup元素存在,⽽且也指定了jsp-file元素,则JSP⽂件会被重新编译成Servlet,同时产⽣的Servlet也被载⼊内存。 个整数。这个值表⽰由Web容器载⼊内存的顺序。 举个例⼦:如果有两个Servlet元素都含有 Web容器决定什么时候加载Servlet。如果两个Servlet的 动容器时,初始化Servlet。 (4). 1). 2). (5). 加载Servlet的过程 容器的Context对象对请求路径(URL)做出处理,去掉请求URL的上下⽂路径后,按路径映射规则和Servlet映射路径( 处理请求。 9.3DispatcherServlet在中的配置: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 配置Spring MVC,指定处理请求的Servlet,有两种⽅式: (1). 默认查找MVC配置⽂件的地址是:/WEB-INF/${servletName}- (2). 可以通过配置修改MVC配置⽂件的位置,需要在配置DispatcherServlet时指定MVC配置⽂件的位置。 我们在平台项⽬两个⼯程中分别使⽤了不同的配置⽅式,介绍如下: (1). 在business-client⼯程中按照默认⽅式查找MVC的配置⽂件,配置⽂件⽬录为: /WEB-INF/。⼯程⽬录结构如下所⽰: (2).在public-base-server⼯程中,通过第2种⽅式进⾏配置,把放到src/main/resources/config/,则需要在配置DispatcherServlet时指定 param>标签。具体代码如下: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. ⼯程⽬录结构如下: 其中,classpath是web项⽬的类路径,可以理解为classes下⾯。因为⽆论这些配置⽂件放在哪,编译之后如果没有特殊情况的话都直接在classes下⾯。jar包的话虽然放在lib⽂ 件夹⾥,但实际上那些类可以直接引⽤,⽐如:,仿佛也在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所在的容器)。 10. 1. 2. 3. 4. 11. 参考⽂献: /ahou2468/article/details/79015251


发布评论