tomcat部署与Context(转)
首先说说tomcat的几种部署方法:
1.将应用文件夹或war文件塞到tomcat安装目录下的webapps子目录下,这样tomcat启动的时候会将webapps目录下的文件夹或war内容当成应用部署。这种方式最简单且无须书写任何配置文件。
2.在tomcat安装目录下的conf子目录下的server.xml配置文件中的Host节点下添加Context字节点:<Context path="/name" docBase="..." />,其中path属性是url后面的访问目录名,这个例子中项目在本机的访问url为http://localhost:8080/name,docBase为应用的所在路径可以为系统的任意位置。
3.$CATALINA_HOME/conf/[enginename]/[hostname]/ 目录下新建一个xml文件,文件的根节点为Context节点,属性配置与第二种方式一样,只是无须配置path属性,path属性为xml文件的名称
4.登录http://localhost:8080/manager页面,利用tomcat的manager管理功能管理与动态部署应用。
tomcat的Context节点配置与web.xml类似,但是应用于两个不同的方面。Context元素代表一个web应用,运行在某个特定的虚拟主机上。每个web应用基于一个Web Application Archive(WAR)文件,或者是一个目录,包含WAR文件解压后的内容Context是站在tomcat的角度来描述一个应用的部署,Context节点是从tomcat容器的角度来描述一个部署在容器内的web应用。而web.xml文件是描述应用的内容,是对应用本身而言的。通过将请求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路径的请求。
【几个Note】
1,Tomcat配置文件server.xml区分大小写,例如docbase不会当初docBase,写错了容器会默认docBase与path的值相同,而不是docbase的值。
2,在server.xml中定义Context节点,可以覆盖webapps中的与path相同的文件夹。
3,尝试定义相同的Context的pathName会导致Tomcat无法启动
4,几个Context可以指向同一个docBase
【Context】
功能:
WebApplicationArchive描述符
存在位置:
$CATALINA_HOME/conf/context.xml:这是所有应用的Context节点公共配置文件,对所以的应用都起作用
$CATALINA_HOME/conf/[enginename]/[hostname]/context.xml.default
$CATALINA_HOME/conf/[enginename]/[hostname]/*.xml:*为应用名称
$CATALINA_HOME/webbase/appDirName/META-INF/context.xml
Server.xml中的Host节点内
属性:
backgroundProcessorDelay
className 实现org.apache.catalina.Context接口
cookies 是否允许cookie
crossContext 是否允许应用程序交互调用ServletContext.getContext()
docBase Context根目录。
override 是否覆盖host的默认context配置
path 应用程序的url路径。每个host的所有app的path必须不同。注意,这个只有在server.xml中定义context时才使用,一般通过文件名或目录名自动推断。
privileged 是否允许使用container servlets, 就像manager servlet
reloadable 是否监测和加载/WEB-INF/classes/和/WEB-INF/lib中的类文件的更新。
wrapperClass 实现org.apache.catalina.Wrapper接口的类。
allowLinking,antiJARLocking,antiResourceLocking,cacheMaxSize,cacheTTL,cachingAllowed,caseSensitive,processTlds,swallowOutput,tldNamespaceAware,tldValidation,unloadDelay,unpackWAR,useNaming,workDir
子节点:
Loader 类加载器。最多一个,配置该web应用用来加载servlet和javabean的类加载器。正常情况下,使用缺省的类加载器就足够了
Logger - 配置用来接收和处理所有日志消息的logger,包括调用ServletContext.log()函数记录的所有消息
Manager http会话的创建、销毁和保持的管理类。最多一个,正常情况下,使用缺省的session manager配置就足够了
Realm 授权管理。最多一个,配置Realm,该Realm的用户数据库以及相关的角色仅用于这个特定的web应用中。如果没有指定,该web应用使用所属的Host或Engine的Realm
Resources 资源管理类。最多一个,配置用于访问与这个web应用相关联的静态资源。正常情况下,使用缺省的resource manager就足够了
WatchedResource 监控资源,字符串。自动加载器会随时更新这个资源。
【Loader】
说明:
放在Context节点内
属性:
className 实现接口org.apache.catalina.Loader的类加载器,默认org.apache.catalina.loader.WebappClassLoader
delegate true表示加载前先问上级loader,同java一般模式;false,先从本loader开始尝试加载
reloadable 是否监控类文件变化,实时更新加载。
【Manager】
说明:
放在Context内,管理每个webapp的http会话的创建和维持。
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中元素中嵌套<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来定制这个值。
<Parameter>元素的有效属性值如下:
属性 描述
description 关于该context初始化参数的文字描述(可选)
name
要创建的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</param-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, or java.lang.String.
value 通过JNDI context请求时,返回给应用的参数值。这个值必须转换成type属性定义的Java类型
生命期Listeners
如 果一个Java对象需要知道Context什么时候启动,什么时候停止,可以在这个对象中嵌套一个Listener元素。该Listener元素必须实现 了org.apache.catalina.LifecycleListener接口,在发生对应的生命期事件的时候,通知该Listener。可以按照 如下的格式配置这样的Listener:
<Context path="/examples" ...>
...
<Listener className="com.mycompany.mypackage.MyListener" ... >
...
</Context>
注意,一个listener可以具有任意多的附加属性。属性名与JavaBean的属性名相对应,使用标准的属性命名方法。
请求过滤器(Request Filters)
对 每个发送到Engine,Host或者Context的请求,可以要求Catalina检查IP地址或主机名称。Catalina使用一系列配置好的“接 受”或者“拒绝”过滤器对客户端的地址或者主机名进行检查,过滤器是按照正则表达式语法定义的,由Jakarta Regexp正则表达式库支持。不被接受的请求会返回一个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>
资源定义(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来定制这个值。
<Resource>元素的有效属性如下:
属性 描述
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>条目。
<Resourceparams>元素的有效属性如下:
属性 描述
name 配置的资源名称,相对于java:comp/env context。这个名称必须与$CATALINA_HOME/conf/server.xml中某个<Resource>元素定义的资源名 称匹配,或者在/WEB-INF/web.xml中通过<resource-ref>或者<resource-env-ref> 元素应用。
资源连接(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类名的全称
--------------------------------------------------------------
部分内容来自:
http://blog.csdn.net/yuanhl2007/archive/2009/08/02/4400458.aspx