Context元素代表一个web应用,运行在某个特定的虚拟主机上。如Servlet Specification 2.2或以后版本中描述的那样,每个web应用基于一个Web Application Archive(WAR)文件
元素的有效属性所如下:
属性 描述
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类名的全称
上一页 [1] [2]