Tomcat6的服务器配置文件放在 ${tomcat6}/conf 目录底下。我们可以在这里找到 server.xml 和 context.xml。当然,还有其他一些资源文件。但是在在本文中我们只用得上这两个,其他的就不介绍了。
如果仅限某个web项目范围内可用,可在web项目的META-INF下添加context.xml。例如webapps\call\META-INF下添加
1. 首先,需要为数据源配置一个JNDI资源。
我们的数据源JNDI资源应该定义在context元素中。
在tomcat6版本中,context元素已经从server.xml文件中独立出来了,放在一个context.xml文件中。因为server.xml是不可动态重加载的资源,服务器一旦启动了以后,要修改这个文件,就得重启服务器才能重新加载。而context.xml文件则不然,tomcat服务器会定时去扫描这个文件。一旦发现文件被修改(时间戳改变了),就会自动重新加载这个文件,而不需要重启服务器。
我们当然推荐把应用需要的JNDI资源配置在context.xml文件中,而不是server.xml文件中。
1.1. Context元素的范围
由于context元素的可用范围是可以控制的,我们可以根据需要为Context元素定义不同级别的可用范围。
1.1.1. 全局可用
全局可用的范围意味着tomcat服务器下面的所有应用都可以使用这个context元素定义的资源。
全局可用范围的context元素在文件 ${tomcat6}/conf/context.xml 文件中描述。这个文件在tomcat刚刚被安装的时候,是没有定义任何资源的。我们可以看到,这个文件的内容:
<Context> <WatchedResource>WEB-INF/web.xml</WatchedResource>
</Context>
其中的 <watchedresource></watchedresource>WEB-INF/web.xml表示服务器会监视应用的WEB-INF/web.xml 文件来知道那个应用会引用在此处定义的资源。
1.1.2. 指定的虚拟主机可用
顾名思义,指定的虚拟主机内可用就是说,在tomcat服务器配置的虚拟主机中,只有指定的那个虚拟主机上跑的应用才能使用。什么是虚拟主机和如何配置虚拟主机在这里就不描述了,有兴趣的同学自己去查tomcat的官方资料。
要配置一个虚拟主机可用的context资源,可以在${tomcat6}/conf/目录下的文件${enginename}/${hostname}/context.xml.default 中表述。
比如,一般一个tomcat服务器安装好了以后,都有一个默认的叫做Catalina 的引擎,在这个引擎下有一个叫做localhost 的虚拟主机。我们的应用一般都放在这个虚拟主机下。关于这个虚拟主机的配置,不再本文表述,有兴趣的同学可以自己去查tomcat的官方文档。
那么,如果我们想要配置一个在 Catalina/localhost 虚拟主机下都可以使用的资源,我们需要在目录 ${tomcat6}/conf 下建立路径 Catalina/localhost,在这个路径下创建文件 context.xml.default。全路径是 ${tomcat6}/conf/Catalina/localhost/context.xml.default。
1.1.3. 指定的应用可用
顾名思义,一个指定的应用可用的context元素,意味着这是一个只有指定的引擎,指定的虚拟主机,指定的应用才可以使用的context元素。
如果我们用appname来代表这个指定的这个指定的应用的名字,那么元素的定义应该被放置在 ${tomcat}/conf/${enginename}/${hostname}/${appname}.xml文件中。
例如,假设在localhost下我们有一个web应用叫做FiberScheduler,那么我们应该创建文件 ${tomcat6}/conf/Catalina/localhost/FiberScheduler.xml。
1.2. Context元素的配置
好了,啰唆了这么多,终于到了介绍到底这个context元素该怎么配置了。
1.2.1. Context元素的属性
首先,假定我们这个元素是为一个名叫 FiberScheduler的web应用创建的,那么这个web应用的放置路径应该是目录 ${tomcat6}/webapps/FiberScheduler(当然,如果你使用的是war包的话,那么就应该是${tomcat6}/webapps/FiberScheduler.war 文件了)。所以,我们的context元素应该指定属性 path=”FiberScheduler” docBase=”FiberScheduler”。
然后,这是一个可以动态重新加载的资源,所以我们应该指定属性 reloadable=”true”。
现在,我们的context元素的开始tag看起来是这个样子:
<Context path="FiberScheduler" docBase="FiberScheduler" debug="5" reloadable="true" crossContext="true">
1.2.2. 这个context元素监视的引用元素定义文件
我们还是要指定一个被监视的资源,在这个资源里面,会定义context中定义的那个资源被引用了。
对我们的web应用而已,这个被监视的资源当然是 web.xml 文件,同时,也意味着我们应该在 web.xml 中定义JNDI资源引用元素。
现在,我们的context元素有了一个子元素:
-
-
- <WatchedResource>WEB-INF/web.xmlWatchedResource>
-
1.2.3.
我们的数据源是作为context中定义的一个资源存在的。当然,也还可以在context中定义其他的JNDI资源。
我们先假定一些数据库的资源信息:我们需要配置一个oracle的数据源名叫FiberSchedulerDS,连接数据库的用户名是 user1,密码是 password1,数据库驱动程序是oracle.jdbc.OracleDriver,数据流连接url是jdbc:oracle:thin:@localhost:1521:fred。那么,我们的资源定义元素看起来是这个样子:
xml 代码
-
-
-
<Resource name="FiberSchedulerDS" auth="Container" type="javax.sql.DataSource" maxActive="4" maxIdle="30" maxWait="5000" username="netgeo" password="netgeo" driverClassName="oracle.jdbc.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:fred"/>
-
-
我们可以在一个context元素中定义多个资源,格式类似。我在例子里面再定义一个叫做FiberSchedulerJbpmDS的数据库连接池资源。
1.2.4. 完整的context元素
好了,现在我们来看一看完整的context元素的样子:
xml 代码<o:p>
-
-
-
<Context path="FiberScheduler" docBase="FiberScheduler" debug="5" reloadable="true" crossContext="true"> <WatchedResource>WEB-INF/web.xmlWatchedResource> <Resource name="FiberSchedulerDS" auth="Container" type="javax.sql.DataSource" maxActive="4" maxIdle="30" maxWait="5000" username="netgeo" password="netgeo" driverClassName="oracle.jdbc.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:fred"/> <Resource name="FiberSchedulerJbpmDS" auth="Container" type="javax.sql.DataSource" maxActive="4" maxIdle="30" maxWait="5000" username="FiberSchedulerJBPM" password="FiberSchedulerJBPM" driverClassName="oracle.jdbc.OracleDriver" url="jdbc:oracle:thin:@localhost:1521:fred"/> Context>
-
-
2. 然后,配置web应用引用资源
前面我们定义context元素的时候,指定了一个监视资源。现在我们就需要在这个监视资源里面声明我们需要引用的JNDI资源。