1、通用属性
所有Context的实现支持如下属性:
1)、backgroundProcessorDelay : 这个值代表在context及其子容器(包括所有的wrappers)上调用backgroundProcess方法的延时,以秒为单位。如果延时值为负,子容器不会被调用,也就是说子容器使用自己的处理线程。如果该值为正,会创建一个新的线程。在等待指定的时间以后,该线程在主机及其 子容器上调用backgroundProcess方法。context利用后台处理session期间,监测类的变化用于重新载入。如果没有指定,该属性的缺省值是-1,说明context所依赖其所属的Host的后台处理。
2)、className : 实现的Java类名。该类必须实现org.apache.catalina.Context接口。如果没有指定,使用标准实现(在下面定义)。
3)、cookies : 如果想利用cookies来传递session identifier(需要客户端支持cookies),设为ture。否则为false,这种情况下只能依靠URL Rewriting传递session identifier。
4)、crossContext : 如果想在应用内调用ServletContext.getContext()来返回在该虚拟主机上运行的其他web application的request dispatcher,此值设为true。在安全性很重要的环境中,设为false,使得getContext()总是返回null。缺省值为false。
5)、docBase : 该web应用的文档基准目录(Document Base,也称为Context Root),或者是WAR文件的路径。可以使用绝对路径,也可以使用相对于context所属的Host的appBase路径。
6)、override :如果想利用该Context元素中的设置覆盖DefaultContext中相应的设置,设为true。缺省情况下使用DefaultContext中的设置。
7)、privileged :设为true,允许context使用container servlets,比如manager servlet。
8)、path :web应用的context路径。catalina将每个URL的起始和context path进行比较,选择合适的web应用处理该请求。特定Host下的context path必须是惟一的。如果context path为空字符串(""),这个context是所属Host的缺省web应用,用来处理不能匹配任何context path的请求。
9)、reloadable :如果希望Catalina监视/WEB-INF/classes/和/WEB-INF/lib下面的类是否发生变化,在发生变化的时候自动重载web application,设为true。这个特征在开发阶段很有用,但也大大增加了服务器的开销。因此,在发布以后,不推荐使用。但是,你可以使用Manager应用在必要的时候触发应用的重载。
10)、wrapperClass :org.apache.catalina.Wrapper实现类的名称,用于该Context管理的servlets。如果没有指定,使用标准的缺省值。
2、标准实现
Context的标准实现是org.apache.catalina.core.StandardContext.它还支持如下的附加属性:
2)、swallowOutput : 如果该值为true,System.out和System.err的输出被重定向到web应用的logger。如果没有指定,缺省值为false。
3)、useNaming : 如果希望Catalina为该web应用使能一个JNDI InitialContext对象,设为true。该InitialialContext符合J2EE平台的约定,缺省值为true。
$CATALINA_HOME/work下一个合适的目录。
3、嵌套组件
下列元素可以嵌套在Context元素中,但每个元素至多只能嵌套一次。
1)、Loader :配置该web应用用来加载servlet和javabean的类加载器。正常情况下,使用缺省的类加载器就足够。
2)、Logger :配置用来接收和处理所有日志消息的logger,包括调用ServletContext.log()函数记录的所有消息。
3)、Manager -配置用于创建,销毁,维持HTTP session的session manager.正常情况下,使用缺省的session manager配置就足够。
4)、Realm :配置Realm,该Realm的用户数据库以及相关的角色仅用于这个特定的web应用中。如果没有指定,该web应用使用所属的Host或Engine的Realm。
5)、Resources :配置用于访问与这个web应用相关联的静态资源。正常情况下,使用缺省的resource manager就足够。
4、专有特征
正常情况下,运行web服务器会生成访问日志。访问日志以标准格式为每个请求输出一行信息。Catalina包含一个可选的Valve实现,可以用标准格式生成日志,还可以使用任意定制的格式。
通过在Engine,Host或者Context中嵌套一个Valve元素,Catalina会为该容器处理的所有请求创建访问日志,如下所示:
<Context path="/examples" ...>
...
<Valve className="org.apache.catalina.valves.AccessLogValve"
prefix="localhost_access_log" suffix=".txt"
pattern="common"/>
...
</Context>
如果使用标准的Context实现,当Catalina启动,或者重载web应用的时候,如下的配置步骤会自动发生,不需要特殊的配置来使用这些特征。
如果没有定义自己的Manager元素,会配置一个标准的session manager;
如果没有定义自己的Resources元素,使用标准的resource manager。
在conf/web.xml中列出的web应用的属性会当做该web应用的缺省的属性。这被用于建立缺省的映射(比如将.jsp映射成对应的JSP servlet),以及其他的标准属性。
3)、在/WEB-INF/web.xml资源中的属性被处理(如果资源存在)
如果web应用指定了安全限制,并且可能需要对用户进行认证,Catalina会配置选定的Authenticator,该Authenticator实现了login方法。
Context参数
可以在Context中元素中嵌套<Parameter>元素,配置带有名称的值,这些值作为servletcontext初始化参数,对整个web应用可见。比如,你可以像这样创建初始化参数<Context ...>
...
<Parameter name="companyName" value="My Company, Incorporated"
override="false"/>
...
</Context>
与在/WEB-INF/web.xml中包含如下元素相等:
<context-param>
<param-name>companyName</param-name>
<param-value>My Company, Incorporated</param-value>
</context-param>
区别是,前者不需要修改deployment descriptor来定制这个值。
description : 关于该context初始化参数的文字描述(可选)要创建的context初始化参数的名称。
override :如果不希望/WEB-INF/web.xml中具有相同参数名称的<context-param>覆盖这里指定的值,设为false。缺省值为true。
value :调用ServletContext.getInitParameter()时,返回给应用的参数值。
可以在Context中嵌套<Environment>元素,这些值作为环境条目资源(Environment Entry Resource),对整个web应用可见。比如,可以按照如下方法创建一个环境条目:
<Context ...>
...
<Environment name="maxExemptions" value="10"
type="java.lang.Integer" override="false"/>
...
</Context>
与在/WEB-INF/web.xml中包含如下元素是等价的:
<env-entry>
<env-entry-name>maxExemptions</env-entry-name>
<env-entry-value>10</env-entry-value>
<env-entry-type>java.lang.Integer</env-entry-type>
</env-entry>
区别是,前者不需要修改deployment descriptor来定制这个值。
<Environment>元素的有效属性所如下:
description :环境条目的文字描述(可选)name :环境条目的名称,相对于java:comp/env context。
override :如果不希望/WEB-INF/web.xml中具有相同名称的<env-entry>覆盖这里指定的值,设为false。缺省值为true。
type :环境条目的Java类名的全称.在/WEB-INF/web.xml中,<env-entry-type>必须是如下的值:java.lang.Boolean, java.lang.Byte, java.lang.Character, java.lang.Double,
java.lang.Float, java.lang.Integer, java.lang.Long, java.lang.Short, java.lang.String。
value :通过JNDI context请求时,返回给应用的参数值。这个值必须转换成type属性定义的Java类型。
4)、生命期Listeners
如果一个Java对象需要知道Context什么时候启动,什么时候停止,可以在这个对象中嵌套一个Listener元素。该Listener元素必须实现org.apache.catalina.LifecycleListener接口,在发生对应的生命期事件的时候,通知该Listener。
按照如下的格式配置Listener:
<Context path="/examples" ...>...
<Listener className="com.mycompany.mypackage.MyListener" ... >
...
</Context>
注意,一个listener可以具有任意多的附加属性。属性名与JavaBean的属性名相对应,使用标准的属性命名方法。
对每个发送到Engine,Host或者Context的请求,可以要求Catalina检查IP地址或主机名称。Catalina使用一系列配置好的“接受”或者“拒绝”过滤器对客户端的地址或者主机名
进行检查,过滤器是按照正则表达式语法定义的,不被接受的请求会返回一个HTTP“Forbidden”错误。
下面是过滤器的定义:
<Context path="/examples" ...>...
<Valve className="org.apache.catalina.valves.RemoteHostValve"
allow="*.mycompany.com,www.yourcompany.com"/>
<Valve className="org.apache.catalina.valves.RemoteAddrValve"
deny="192.168.1.*"/>
...
</Context>
6)、资源定义(Resource Definitions)
在/WEB-INF/web.xml中定义资源的特性。使用JNDI查找<resource-ref>和<resource-env-ref>元素时,这些特性被返回。对同一资源名称,还必须定义资源参数(见下面“资
源参数”小节),这些参数用来配置对象工厂(object factory)以及对象工厂的属性。
可以按照如下方式创建资源定义:
<Context ...>
...
<Resource name="jdbc/EmployeeDB" auth="Container"
type="javax.sql.DataSource"
description="Employees Database for HR Applications"/>
...
</Context>
等价于在/WEB-INF/web.xml中包含如下元素:
<resource-ref>
<description>Employees Database for HR Applications</description>
<res-ref-name>jdbc/EmployeeDB</res-ref-name>
<res-ref-type>javax.sql.DataSource</res-ref-type>
<res-auth>Container</res-auth>
</resource-ref>
区别是,前者不需要修改deployment descriptor来定制这个值。
auth :指定时web应用代码本身sign on到对应的resource mananger,还是由container代表web应用sign on到resource manager。该属性的值必须是Application或Container。如果在web application deployment descriptor中使用<resource-ref>,这个属性是必需的,如果使用<resource-env-ref>,这个属性是可选的。
description :资源的文字描述(可选)。
name :资源的名称,相对于java:comp/env context。
scope :指定通过这个resource manager得到的连接是否共享。该属性的值必须是Shareable或者Unshareable。缺省情况下,假定连接是共享的。
type :当web应用在该资源连接上进行查找时,返回的Java类名的全称。
资源参数用来配置资源管理器(resource manager)或对象工厂(object factory)。在做JNDI查找时,资源管理器返回查找的对象。在资源可以被访问之前,对<Context>或
<DefaultContext>元素的每个<Resource>元素,或者/WEB-INF/web.xml中定义的每个<resource-ref>或<resource-env-ref>元素,都必须定义资源参数。
资源参数是用名称定义的,使用的资源管理器(或者object factory)不同,参数名称的集合也不一样。这些参数名和工厂类的JavaBeans属性相对应。JNDI实现通过调用对应的JavaBeans属性设置函数来配置特定的工厂类,然后通过lookup()调用使得该实例可见。
JDBC数据源的资源参数可以按照如下方式定义:
<Context ...>
...
<ResourceParams name="jdbc/EmployeeDB">
<parameter>
<name>driverClassName</name>
<value>org.hsql.jdbcDriver</value>
</parameter>
<parameter>
<name>url</name>
<value>jdbc:HypersonicSQL:database</value>
</parameter>
<parameter>
<name>user</name>
<value>dbusername</value>
</parameter>
<parameter>
<name>password</name>
<value>dbpassword</value>
</parameter>
</ResourceParams>
...
</Context>
如果你需要为某个特定的资源类型指定工厂内的Java类名,在<ResourceParams>元素中嵌套一个叫做factory的<parameter>条目。
name :配置的资源名称,相对于java:comp/env context。这个名称必须与$CATALINA_HOME/conf/server.xml中某个<Resource>元素定义的资源名称匹配,或者在/WEB-INF/web.xml中通过<resource-ref>或者<resource-env-ref>元素应用。
8)、资源连接(Resource Links)
资源连接用于创建到全局JNDI资源的连接。在连接名称上进行JNDI查询会返回被连接的global 资源。
可以按照如下方法创建一个资源连接:
<Context ...>
...
<ResourceLink name="linkToGlobalResource"
global="simpleValue"
type="java.lang.Integer"
...
</Context>
<ResourceLink>元素的有效属性如下:
global :被连接的全局资源的名称。
name :创建的资源连接的名称,相对于java:comp/env context。
type :当web应用在该资源连接上进行查找时,返回的Java类名的全称。