-
2008-05-09
Tomcat中Context容器配置详解 - [学习笔记]
版权声明:转载时请以超链接形式标明文章原始出处和作者信息及本声明
http://hrbyzq.blogbus.com/logs/20551077.html
Context元素代表一个web应用,运行在某个特定的虚拟主机上。如Servlet Specification 2.2或以后版本中描述的那样,每个web应用基于一个Web Application Archive(WAR)文件,或者是一个目录,包含WAR文件解压后的内容。有关Web Application Archive的更多信息,可以参考Servlet Specification和Tomcat 应用程序开发者指南。 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛*{+p'O#m4t!m%K,I#b;h
通过将请求URI的最长可能前缀与每个Context的context路径进行匹配,Catalina选择相应的web 应用处理HTTP请求。一旦选定,根据web application deployment descriptor 文件中定义的servlet映射,Context会选择一个正确的servlet来处理进来的请求。servlet映射必须定义在该web应用目录层次结构中的/WEB-INF/web.xml中。
你可以在一个Host元素中嵌套任意多的Context元素。每个Context的路径必须是惟一的,由path属性定义。另外,你必须定义一个context路径长度为0的Context,这个Context称为该虚拟主机的缺省web应用,用来处理那些不能匹配任何Context的Context路径的请求。 6^$z'J;l3R.{8h,B7N
除了在Host元素中嵌套Context元素以外,你也可以将它们存储在单个文件中(以.xml为后缀),放在$CATALINA_HOME/conf/[enginename]/[hostname]/目录下面。有关这方面的更多信息,参考应用的自动发布。这种方法允许动态重新配置web应用,因为如果修改了conf/server.xml,就必须重新启动Tomcat。
除了明确指定Context元素以外,还有其他几种技术可以自动生成Context元素。参考Automatic Application Deployment 和 User Web Applications 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛;g9X8I+n9k$U
程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛1D0j5t*B5T9~)s2z(p6n
以下的描述使用变量$CATALINA_HOME来指Tomcat 5安装的目录。大多数的相对路径都是以该目录为基准。但是,通过设置CATALINA_BASE目录,可以运行多个Tomcat 5实例,这时你应该使用$CATALINA_BASE来作为目录基准,而不是使用$CATALINA_HOME。 4o1h5r#q!Z&{(J7D
属性 TechWeb-技术社区"d7H*o0T$f'G#i4~6B!K
通用属性 tech.techweb.com.cn4o$J%p+z3z,U
所有Context的实现支持如下属性: #X"{0~)A#Q:w.L
backgroundProcessorDelay 这个值代表在context及其子容器(包括所有的wrappers)上调用backgroundProcess方法的延时,以秒为单位。如果延时值非负,子容器不会被调用,也就是说子容器使用自己的处理线程。如果该值为正,会创建一个新的线程。在等待指定的时间以后,该线程在主机及其 子容器上调用backgroundProcess方法。context利用后台处理session过期,监测类的变化用于重新载入。如果没有指定,该属性的缺省值是-1,说明context依赖其所属的Host的后台处理。 3_8@%w1_!`#D8J"N(X1H
className 实现的Java类名。该类必须实现org.apache.catalina.Context接口。如果没有指定,使用标准实现(在下面定义)。
cookies 如果想利用cookies来传递session identifier(需要客户端支持cookies),设为ture。否则为false,这种情况下只能依靠URL Rewriting传递session identifier。 *c,h)c!l2B1o:a
5p5C2r$H,N#P
crossContext 如果想在应用内调用ServletContext.getContext()来返回在该虚拟主机上运行的其他web application的request dispatcher,设为true。在安全性很重要的环境中,设为false,使得getContext()总是返回null。缺省值为false。 tech.techweb.com.cn'X+O-T2`:D0H
1D'P.N2|*q3~+h*V)Y+C
docBase 该web应用的文档基准目录(Document Base,也称为Context Root),或者是WAR文件的路径。可以使用绝对路径,也可以使用相对于context所属的Host的appBase路径。 0g)s6^!C.P&j
#z!E6i1c%g6h&p'R)E
override 如果想利用该Context元素中的设置覆盖DefaultContext中相应的设置,设为true。缺省情况下使用DefaultContext中的设置。 %d1i8@/p+A2s4t
privileged 设为true,允许context使用container servlets,比如manager servlet。path web应用的context路径。catalina将每个URL的起始和context path进行比较,选择合适的web应用处理该请求。特定Host下的context path必须是惟一的。如果context path为空字符串(""),这个context是所属Host的缺省web应用,用来处理不能匹配任何context path的请求。
:S-h'x-z)c4j/K$W
reloadable 如果希望Catalina监视/WEB-INF/classes/和/WEB-INF/lib下面的类是否发生变化,在发生变化的时候自动重载web application,设为true。这个特征在开发阶段很有用,但也大大增加了服务器的开销。因此,在发布以后,不推荐使用。但是,你可以使用Manager应用在必要的时候触发应用的重载。
wrapperClass org.apache.catalina.Wrapper实现类的名称,用于该Context管理的servlets。如果没有指定,使用标准的缺省值。
TechWeb-技术社区/m/V7A0z'?3b4F)s
标准实现
Context的标准实现是org.apache.catalina.core.StandardContext.它还支持如下的附加属性:
tech.techweb.com.cn'W4]'{9p.v+M9z6h+G
属性 描述 tech.techweb.com.cn9|/o3f2`%@8`6F
debug 与这个Engine关联的Logger记录的调试信息的详细程度。数字越大,输出越详细。如果没有指定,缺省为0。 1h1J%x7q-x'},U
4z![$t2k2h%n1N5H1B
swallowOutput 如果该值为true,System.out和System.err的输出被重定向到web应用的logger。如果没有指定,缺省值为false ;H2p*G5Q6x/C&?'z
useNaming 如果希望Catalina为该web应用使能一个JNDI InitialContext对象,设为true。该InitialialContext符合J2EE平台的约定,缺省值为true。 .}0l:`2S8w
workDir Context提供的临时目录的路径,用于servlet的临时读/写。利用javax.servlet.context.tempdir属性,servlet可以访问该目录。如果没有指定,使用$CATALINA_HOME/work下一个合适的目录。 8]!z;\"n#\%y3Y:r
+k6x%U7w6Y6X7u:|-B0{._
/S.o;t.N']"q
TechWeb-技术社区2e4~'Y"A+I+D
嵌套组件 ,g6f$V,G&K,S
下列元素可以嵌套在Context元素中,但每个元素至多只能嵌套一次。
Loader-配置该web应用用来加载servlet和javabean的类加载器。正常情况下,使用缺省的类加载器就足够了;
Logger - 配置用来接收和处理所有日志消息的logger,包括调用ServletContext.log()函数记录的所有消息; 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛.e9~"U/a3L-t6J4s8B)n
Manager -配置用于创建,销毁,维持HTTP session的session manager.正常情况下,使用缺省的session manager配置就足够了; !z:t,s9b7i7t9c4B
Realm - 配置Realm,该Realm的用户数据库以及相关的角色仅用于这个特定的web应用中。如果没有指定,该web应用使用所属的Host或Engine的Realm。 TechWeb-技术社区#a&|&`)['W5a%e/Y1E
Resources - 配置用于访问与这个web应用相关联的静态资源。正常情况下,使用缺省的resource manager就足够了。 TechWeb-技术社区:A!V8D)c1R'W
程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛7x5w3[+M-w2p.[9T
专有特征
访问日志
正常情况下,运行web服务器会生成访问日志。访问日志以标准格式为每个请求输出一行信息。Catalina包含一个可选的Valve实现,可以用标准格式生成日志,还可以使用任意定制的格式。
(x7Y1u:f%j5e8N
通过在Engine,Host或者Context中嵌套一个Valve元素,Catalina会为该容器处理的所有请求创建访问日志,如下所示:
&B.I:\3p:\'U+]7`"E%}
... 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛3Z4Q(y.@&n2t,v3_0B
prefix="localhost_access_log." suffix=".txt"
pattern="common"/>
... (Q(J5b.r+a-]:l5N2y;j0_(v,m4c
:F.@+_*s6o i,N y
参考Access Log Valve,以获得更多配置属性的信息;Context的自动配置
如果使用标准的Context实现,当Catalina启动,或者重载web应用的时候,如下的配置步骤会自动发生,不需要特殊的配置来使能这个特征。
如果没有定义自己的Loader元素,将会配置一个标准的web应用class loader; tech.techweb.com.cn0h'C8P3|9i x F
如果没有定义自己的Manager元素,会配置一个标准的session manager; tech.techweb.com.cn9^#B&{0@-I#h7]
如果没有定义自己的Resources元素,使用标准的resource manager。
在conf/web.xml中列出的web应用的属性会当做该web应用的缺省的属性。这被用于建立缺省的映射(比如将.jsp映射成对应的JSP servlet),以及其他的标准属性。 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛%w*M.]&y%Z3p
列举在/WEB-INF/web.xml资源中的属性被处理(如果资源存在); 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛,^([5c2h5h/X
如果web应用指定了安全限制,并且可能需要对用户进行认证,Catalina会配置选定的Authenticator,该Authenticator实现了login方法。
Context参数 r3C3L.?0K-{
可以在Context中元素中嵌套元素,配置带有名称的值,这些值作为servletcontext初始化参数,对整个web应用可见。比如,你可以像这样创建初始化参数:
... TechWeb-技术社区/y O(m,{,k4d
override="false"/>
... TechWeb-技术社区'u,U*e$D4k7U*_:j'U
&D3m#N1i-z'`0j7I1B.U-h9g
这与在/WEB-INF/web.xml中包含如下元素相等:
companyName tech.techweb.com.cn.g7@4y9`)L(X2B Z(H(A)T
My Company, Incorporated
区别是,前者不需要修改deployment descriptor来定制这个值。 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛+S)A*t0o%Y2C
TechWeb-技术社区4R*s5M"S:X5v$D/A&Y'~
元素的有效属性值如下:
属性 描述
description 关于该context初始化参数的文字描述(可选) 8}&r'g5R"B+G0x"r.['q
&P4l U9q"t/_1s1Q
name
tech.techweb.com.cn'b1}"~,b$p*b
要创建的context初始化参数的名称
tech.techweb.com.cn(O/p*P,d4W.q;Z&j"l
override 如果不希望/WEB-INF/web.xml中具有相同参数名称的覆盖这里指定的值,设为false。缺省值为true。
tech.techweb.com.cn3]3^7m*X4a$a2z;W
value 调用ServletContext.getInitParameter()时,返回给应用的参数值。
环境条目
可以在Context中嵌套元素,配置命名的值,这些值作为环境条目资源(Environment Entry Resource),对整个web应用可见。比如,可以按照如下方法创建一个环境条目:
)K,H5}2H2V N5E6c
...
type="java.lang.Integer" override="false"/>
...
程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛7b9q9E:x0w0x"i
这与在/WEB-INF/web.xml中包含如下元素是等价的: ;N6n9|*|.s7F
程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛'?+t4{4O4H0t i.P;]#y
maxExemptions
10 6r/y!e$m+~;z,G.[
java.lang.Integer TechWeb-技术社区&];{(D3n9W6F+j!K5`7]
tech.techweb.com.cn*Z4|;n6q/P
区别是,前者不需要修改deployment descriptor来定制这个值。
元素的有效属性所如下:
属性 描述
description 环境条目的文字描述(可选)
TechWeb-技术社区;u.y,S7i#X'n3K!h;Q(K
name 环境条目的名称,相对于java:comp/env context。 $L7{/z,p%E0S0j#Y&K
TechWeb-技术社区!Y9H"N,V6U7i
override 如果不希望/WEB-INF/web.xml中具有相同名称的覆盖这里指定的值,设为false。缺省值为true。
tech.techweb.com.cn'J!X3z3@7k5Z
type 环境条目的Java类名的全称.在/WEB-INF/web.xml中,必须是如下的值:java.lang.Boolean, java.lang.Byte, java.lang.Character, java.lang.Double, java.lang.Float, java.lang.Integer, java.lang.Long, java.lang.Short, or java.lang.String.
value 通过JNDI context请求时,返回给应用的参数值。这个值必须转换成type属性定义的Java类型生命期Listeners +H.m)p3e2?!W2E#S:z6W
如果一个Java对象需要知道Context什么时候启动,什么时候停止,可以在这个对象中嵌套一个Listener元素。该Listener元素必须实现了org.apache.catalina.LifecycleListener接口,在发生对应的生命期事件的时候,通知该Listener。可以按照如下的格式配置这样的Listener: tech.techweb.com.cn-U0i$x*^9\0i
注意,一个listener可以具有任意多的附加属性。属性名与JavaBean的属性名相对应,使用标准的属性命名方法。 1P1X/F(@0x9S"g
(Q!k;w1q7V(\,L)Z f
请求过滤器(Request Filters)
对每个发送到Engine,Host或者Context的请求,可以要求Catalina检查IP地址或主机名称。Catalina使用一系列配置好的“接受”或者“拒绝”过滤器对客户端的地址或者主机名进行检查,过滤器是按照正则表达式语法定义的,由Jakarta Regexp正则表达式库支持。不被接受的请求会返回一个HTTP“Forbidden”错误。下面是过滤器的定义。
TechWeb-技术社区3e$W9L"D'w/o)k*h0i9b&x/l
... tech.techweb.com.cn't2k/[)f!N
allow="*.mycompany.com," target="_blank">" target="_blank">www.yourcompany.com"/> 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛3l$e+x+a-@
deny="192.168.1.*"/>
... 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛%D*k,]4r$p(S%E+a3_
TechWeb-技术社区$D-H*d7}%M6p-T0D"U
资源定义(Resource Definitions) tech.techweb.com.cn F;^+M5o.v
可以在/WEB-INF/web.xml中定义资源的特性。使用JNDI查找和元素时,这些特性被返回。对同一资源名称,还必须定义资源参数(见下面“资源参数”小节),这些参数用来配置对象工厂(object factory)以及对象工厂的属性。 TechWeb-技术社区'^)i5|-e0B*b-I%P
比如,你可以按照如下方式创建资源定义: tech.techweb.com.cn*t!\8z+A%y4c5x+N
;N;s-y,h&w1N ?+Q;e*o"Y
...
type="javax.sql.DataSource" !L)}+U4T)H#?;q:A
description="Employees Database for HR Applications"/> 7w2W,G4Q9d$~:C!j
...
程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛"S9p;R#g9V-t
)P%R/?$B0m0K
tech.techweb.com.cn3^;x"Q*q:y6i7u
这等价于在/WEB-INF/web.xml中包含如下元素: "O!p,w4m)}&r+~9c/S
tech.techweb.com.cn)v!s(n2?#B/Z#k3U*Z:r
:M6g*|*l6C1@*f
.Q#w9t1X&?.}-z7A2F4j*c3S
Employees Database for HR Applications
jdbc/EmployeeDB
javax.sql.DataSource
Container
程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛3S(V!G#G:P2p:p
7z#V:l'L$s/D2X
区别是,前者不需要修改deployment descriptor来定制这个值。
元素的有效属性如下: Z;w3k*}"t
属性 描述 +L!m6Q+o'u#g7V
auth 指定时web应用代码本身sign on到对应的resource mananger,还是由container代表web应用sign on到resource manager。该属性的值必须是Application或者Container。如果在web application deployment descriptor中使用,这个属性是必需的,如果使用,这个属性是可选的。
description 资源的文字描述(可选) tech.techweb.com.cn2q/g i$z*w!f5v
name 资源的名称,相对于java:comp/env context
scope 指定通过这个resource manager得到的连接是否共享。该属性的值必须是Shareable或者Unshareable。缺省情况下,假定连接是共享的。
type 当web应用查找该资源的时候,返回的Java类名的全称。
7D7_4@0s"D0v:|8U
资源参数
资源参数用来配置资源管理器(resource manager,或对象工厂,object factory)。在做JNDI查找时,资源管理器返回查找的对象。在资源可以被访问之前,对或元素的每个元素,或者/WEB-INF/web.xml中定义的每个或元素,都必须定义资源参数。
资源参数是用名称定义的,使用的资源管理器(或者object factory)不同,参数名称的集合也不一样。这些参数名和工厂类的JavaBeans属性相对应。JNDI实现通过调用对应的JavaBeans属性设置函数来配置特定的工厂类,然后通过lookup()调用使得该实例可见。一个JDBC数据源的资源参数可以按照如下方式定义: $r0X"]"e;a'C0K%d
*i9E+G9_#I4V$y.J
8y.t%z&l"}*p8z
'R!l5C"\7F/`;J"s
...
!z:k-O2t-L'a
driverClassName
org.hsql.jdbcDriver
url TechWeb-技术社区(]1`*T(D8C;v
jdbc:HypersonicSQL:database TechWeb-技术社区(I8e&?9T5T4Q o5Q6s
tech.techweb.com.cn'~5V'}#_$}!@2b#H C%m
user ,X*F0D0{.Y$U"x4R
dbusername 5I)m4l;\;E"e8_&S4q.o
8E!a9W0E;s4h+m7|
password 0[;S$F6I-A0c3T%w3?
dbpassword
tech.techweb.com.cn;H.G5z$B3K(L
%~,^*h9t3s&Z3t
...
如果你需要为某个特定的资源类型指定工厂内的Java类名,在元素中嵌套一个叫做factory的条目。 tech.techweb.com.cn1I'f"I/m"d/~4r2w#]$Z
&V/s,v&[-L
元素的有效属性如下: /k4R)Z-Q$`5P6O
属性 描述
name 配置的资源名称,相对于java:comp/env context。这个名称必须与$CATALINA_HOME/conf/server.xml中某个元素定义的资源名称匹配,或者在/WEB-INF/web.xml中通过或者元素应用。
资源连接(Resource Links) 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛4r7F/x"Z/W8e
资源连接用于创建到全局JNDI资源的连接。在连接名称上进行JNDI查询会返回被连接的global 资源。
比如,你可以按照如下方法创建一个资源连接:
tech.techweb.com.cn&{*_7E9\%V)J,A2V
;V&m._2n5P#P
... tech.techweb.com.cn n6^ x5}9D6V(V;e7A
global="simpleValue" 程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛.?(w$q!~*z;N U;?&z7U
type="java.lang.Integer"
...
9A(J0_8_&N)?)p#l1j)c!N
元素的有效属性如下: "S,@"J'm#[4o!I+O;G.V9C
程序开发,操作系统,服务器,源码下载,Linux,Unix,BSD,PHP,Apach,asp,下载,源码,黑客,安全,技术社区,技术论坛,]8p5A*y3c"T0J9f
属性 描述
*A-[:R Q;q/?,q
global 被连接的连接全局资源的名称 4l#m-b:Z3U:M0}#`:k5w.o/m;q
name 创建的资源连接的名称,相对于java:comp/env context
"j0{+P;q:h;m7|
type 当web应用在该资源连接上进行查找时,返回的Java类名的全称随机文章:
Orangevolt Eclipse XSLT 2008-05-23常用 java File 操作类 2008-05-08在JAVA文件中获取该项目的相对路径 2008-05-08MySQL存储程序入门指南(转) 2008-05-06myEclipse下web.xml不支持标记的解决方法 2008-05-06
收藏到:Del.icio.us





