| Context元素表明一个web应用，运行在某个特定的虚拟主机上。如Servlet Specification 2.2或之后版本中描述的那样，每一个web应用基于一个Web Application Archive(WAR)文件，或者是一个目录，包含WAR文件解压后的内容。有关Web Application Archive的更多信息，能够参考Servlet Specification和Tomcat 应用程序开发者指南。
经过将请求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路径的请求。
除了在Host元素中嵌套Context元素之外，你也能够将它们存储在单个文件中（以.xml为后缀），放在$CATALINA_HOME/conf/[enginename]/[hostname]/目录下面。有关这方面的更多信息，参考应用的自动发布。这种方法容许动态从新配置web应用，由于若是修改了conf/server.xml，就必须从新启动 Tomcat。
除了明确指定Context元素之外，还有其余几种技术能够自动生成Context元素。参考Automatic Application Deployment 和 User Web Applications
如下的描述使用变量$CATALINA_HOME来指Tomcat 5安装的目录。大多数的相对路径都是以该目录为基准。可是，经过设置CATALINA_BASE目录，能够运行多个Tomcat 5实例，这时你应该使用$CATALINA_BASE来做为目录基准，而不是使用$CATALINA_HOME。
属性
通用属性
全部Context的实现支持以下属性：
backgroundProcessorDelay 这个值表明在context及其子容器（包括全部的wrappers【把应用封装成适合该环境运行的程序】）上调用backgroundProcess方法的延时，以秒为单位。若是延时值非负，子容器不会被调用，也就是说子容器使用本身的处理线程。若是该值为正，会建立一个新的线程。在等待指定的时间之后，该线程在主机及其子容器上调用backgroundProcess方法。context利用后台处理session过时，监测类的变化用于从新载入。若是没有指定，该属性的缺省值是－1，说明context依赖其所属的Host的后台处理。
className 实现的Java类名。该类必须实现org.apache.catalina.Context接口。若是没有指定，使用标准实现（在下面定义）。
cookies 若是想利用cookies来传递session identifier（须要客户端支持cookies），设为ture。不然为false，这种状况下只能依靠URL Rewriting传递session identifier。
crossContext 若是想在应用内调用ServletContext.getContext()来返回在该虚拟主机上运行的其余web application的request dispatcher,设为true。在安全性很重要的环境中，设为false，使得getContext()老是返回null。缺省值为false。
docBase 该web应用的文档基准目录（Document Base，也称为Context Root【默认的根目录】），或者是WAR文件的路径。可使用绝对路径，也可使用相对于context所属的Host的appBase路径。
override 若是想利用该Context元素中的设置覆盖DefaultContext中相应的设置，设为true。缺省状况下使用DefaultContext中的设置。
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的请求。
reloadable 若是但愿Catalina监视/WEB-INF/classes/和/WEB-INF/lib下面的类是否发生变化，在发生变化的时候自动重载web application，设为true。这个特征在开发阶段颇有用，但也大大增长了服务器的开销。所以，在发布之后，不推荐使用。可是，你可使用 Manager应用在必要的时候触发应用的重载。
wrapperClass org.apache.catalina.Wrapper实现类的名称，用于该Context管理的servlets。若是没有指定，使用标准的缺省值。
标准实现
Context的标准实现是org.apache.catalina.core.StandardContext.它还支持以下的附加属性：
属性 描述
debug 与这个Engine关联的Logger记录的调试信息的详细程度。数字越大，输出越详细。若是没有指定，缺省为0。
swallowOutput 若是该值为true，System.out和System.err的输出被重定向到web应用的logger。若是没有指定，缺省值为false
useNaming 若是但愿Catalina为该web应用使能一个JNDI InitialContext对象，设为true。该InitialialContext符合J2EE平台的约定，缺省值为true。
workDir Context提供的临时目录的路径，用于servlet的临时读/写。利用javax.servlet.context.tempdir属性，servlet能够访问该目录。若是没有指定，使用$CATALINA_HOME/work下一个合适的目录。
嵌套组件
下列元素能够嵌套在Context元素中，但每一个元素至多只能嵌套一次。
Loader－配置该web应用用来加载servlet和javabean的类加载器。正常状况下，使用缺省的类加载器就足够了；
Logger - 配置用来接收和处理全部日志消息的logger，包括调用ServletContext.log()函数记录的全部消息；
Manager -配置用于建立，销毁，维持HTTP session的session manager.正常状况下，使用缺省的session manager配置就足够了；
Realm - 配置Realm，该Realm的用户数据库以及相关的角色仅用于这个特定的web应用中。若是没有指定，该web应用使用所属的Host或Engine的Realm。
Resources - 配置用于访问与这个web应用相关联的静态资源。正常状况下，使用缺省的resource manager就足够了。
专有特征
访问日志
正常状况下，运行web服务器会生成访问日志。访问日志以标准格式为每一个请求输出一行信息。Catalina包含一个可选的Valve实现，能够用标准格式生成日志,还可使用任意定制的格式。
经过在Engine，Host或者Context中嵌套一个Valve元素，Catalina会为该容器处理的全部请求建立访问日志，以下所示：
...
prefix="localhost_access_log." suffix=".txt"
pattern="common"/>
...
参考Access Log Valve，以得到更多配置属性的信息；
Context的自动配置
若是使用标准的Context实现，当Catalina启动，或者重载web应用的时候，以下的配置步骤会自动发生，不须要特殊的配置来使能这个特征。
若是没有定义本身的Loader元素，将会配置一个标准的web应用class loader；
若是没有定义本身的Manager元素，会配置一个标准的session manager；
若是没有定义本身的Resources元素，使用标准的resource manager。
在conf/web.xml中列出的web应用的属性会当作该web应用的缺省的属性。这被用于创建缺省的映射（好比将.jsp映射成对应的JSP servlet），以及其余的标准属性。
列举在/WEB-INF/web.xml资源中的属性被处理（若是资源存在）；
若是web应用指定了安全限制，而且可能须要对用户进行认证，Catalina会配置选定的Authenticator，该Authenticator实现了login方法。
Context参数
能够在Context中元素中嵌套元素，配置带有名称的值，这些值做为servletcontext初始化参数，对整个web应用可见。好比，你能够像这样建立初始化参数:
...
override="false"/>
...
这与在/WEB-INF/web.xml中包含以下元素相等：
companyName
My Company, Incorporated
区别是，前者不须要修改deployment descriptor来定制这个值。
元素的有效属性值以下：
属性 描述
description 关于该context初始化参数的文字描述（可选）
name
要建立的context初始化参数的名称
override 若是不但愿/WEB-INF/web.xml中具备相同参数名称的覆盖这里指定的值，设为false。缺省值为true。
value 调用ServletContext.getInitParameter()时，返回给应用的参数值。
环境条目
能够在Context中嵌套元素，配置命名的值，这些值做为环境条目资源(Environment Entry Resource），对整个web应用可见。好比，能够按照以下方法建立一个环境条目：
...
type="java.lang.Integer" override="false"/>
...
这与在/WEB-INF/web.xml中包含以下元素是等价的：
maxExemptions
10
java.lang.Integer
区别是，前者不须要修改deployment descriptor来定制这个值。
元素的有效属性所以下：
属性 描述
description 环境条目的文字描述（可选）
name 环境条目的名称，相对于java:comp/env context。
override 若是不但愿/WEB-INF/web.xml中具备相同名称的覆盖这里指定的值，设为false。缺省值为true。
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
若是一个Java对象须要知道Context何时启动，何时中止，能够在这个对象中嵌套一个Listener元素。该Listener元素必须实现了org.apache.catalina.LifecycleListener接口，在发生对应的生命期事件的时候，通知该Listener。能够按照以下的格式配置这样的Listener：
...
...
注意，一个listener能够具备任意多的附加属性。属性名与JavaBean的属性名相对应，使用标准的属性命名方法。
请求过滤器（Request Filters）
对每一个发送到Engine，Host或者Context的请求，能够要求Catalina检查IP地址或主机名称。Catalina使用一系列配置好的“接受”或者“拒绝”过滤器对客户端的地址或者主机名进行检查，过滤器是按照正则表达式语法定义的，由Jakarta Regexp正则表达式库支持。不被接受的请求会返回一个HTTP“Forbidden”错误。下面是过滤器的定义。
...
allow="*.mycompany.com," target="_blank">" target="_blank">www.yourcompany.com"/>
deny="192.168.1.*"/>
...
资源定义（Resource Definitions）
能够在/WEB-INF/web.xml中定义资源的特性。使用JNDI查找和元素时，这些特性被返回。对同一资源名称，还必须定义资源参数（见下面“资源参数”小节），这些参数用来配置对象工厂（object factory）以及对象工厂的属性。
好比，你能够按照以下方式建立资源定义：
...
type="javax.sql.DataSource"
description="Employees Database for HR Applications"/>
...
这等价于在/WEB-INF/web.xml中包含以下元素：
Employees Database for HR Applications
jdbc/EmployeeDB
javax.sql.DataSource
Container
区别是，前者不须要修改deployment descriptor来定制这个值。
元素的有效属性以下：
属性 描述
auth 指定时web应用代码自己sign on到对应的resource mananger，仍是由container表明web应用sign on到resource manager。该属性的值必须是Application或者Container。若是在web application deployment descriptor中使用，这个属性是必需的，若是使用，这个属性是可选的。
description 资源的文字描述（可选）
name 资源的名称，相对于java:comp/env context
scope 指定经过这个resource manager获得的链接是否共享。该属性的值必须是Shareable或者Unshareable。缺省状况下，假定链接是共享的。
type 当web应用查找该资源的时候，返回的Java类名的全称。
资源参数
资源参数用来配置资源管理器（resource manager，或对象工厂,object factory）。在作JNDI查找时，资源管理器返回查找的对象。在资源能够被访问以前，对或元素的每一个元素，或者/WEB-INF/web.xml中定义的每一个或元素，都必须定义资源参数。
资源参数是用名称定义的，使用的资源管理器（或者object factory）不一样，参数名称的集合也不同。这些参数名和工厂类的JavaBeans属性相对应。JNDI实现经过调用对应的JavaBeans属性设置函数来配置特定的工厂类，而后经过lookup()调用使得该实例可见。
一个JDBC数据源的资源参数能够按照以下方式定义：
...
driverClassName
org.hsql.jdbcDriver
url
jdbc:HypersonicSQL:database
user
dbusername
password
dbpassword
...
若是你须要为某个特定的资源类型指定工厂内的Java类名，在元素中嵌套一个叫作factory的条目。
元素的有效属性以下：
属性 描述
name 配置的资源名称，相对于java:comp/env context。这个名称必须与$CATALINA_HOME/conf/server.xml中某个元素定义的资源名称匹配，或者在/WEB-INF/web.xml中经过或者元素应用。
资源链接（Resource Links）
资源链接用于建立到全局JNDI资源的链接。在链接名称上进行JNDI查询会返回被链接的global 资源。
好比，你能够按照以下方法建立一个资源链接：
...
global="simpleValue"
type="java.lang.Integer"
...
元素的有效属性以下：
属性 描述
global 被链接的链接全局资源的名称
name 建立的资源链接的名称，相对于java:comp/env context
type 当web应用在该资源链接上进行查找时，返回的Java类名的全称
java |