Tomcat全攻略（TOMCAT详细教程）

Tomcat全攻略

随着java的流行，其在web上的应用也越来越广，tomcat作为一个开源的servlet容器，应用前景越来越广，本文将向你讲述tomcat的一些知识。 
一：简介 
tomcat是jakarta项目中的一个重要的子项目，其被JavaWorld杂志的编辑选为2001年度最具创新的java产品(Most Innovative Java Product)，同时它又是sun公司官方推荐的servlet和jsp容器(具体可以见http://java.sun.com/products/jsp/tomcat/)，因此其越来越多的受到软件公司和开发人员的喜爱。servlet和jsp的最新规范都可以在tomcat的新版本中得到实现。

二：安装及配置 
tomcat使用servlet容器Catalina，完整的实现了servlet2.3和jsp1.2规范。注意安装之前你的系统必须安装了jdk1.2以上版本。

(一)：安装 
1：windows平台 
从tomcat网站下载jakarta-tomcat-4.0.1.exe，按照一般的windows程序安装步骤即可安装好tomcat,安装时它会自动寻找你的jdk和jre的位置。

2：linux平台 
下载jakarta-tomcat-4.0.1.tar.gz，将其解压到一个目录。

(二)：配置 
运行tomcat需要设置JAVA_HOME变量 
set JAVA_HOME=c:/jdk (win98，在msdos方式下使用，或者放入autoexec.bat中) 
export JAVA_HOME=/usr/local/jdk (linux下使用，放到/etc/bashrc或者/etc/profile中)

(三)：运行 
设置完毕后就可以运行tomcat服务器了，进入tomcat的bin目录，win98下用startup启动tomcat，linux下用startup.sh，相应的关闭tomcat的命令为shutdown和shutdown.sh。

启动后可以在浏览器中输入http://localhost:8080/测试，由于tomcat本身具有web服务器的功能，因此我们不必安装apache，当然其也可以与apache集成到一起，下面会介绍。

下面你可以测试其自带的jsp和servlet示例。

三：应用

(一):目录结构 
tomcat的目录结构如下： 目录名 简介 
bin 存放启动和关闭tomcat脚本 
conf 包含不同的配置文件,server.xml(Tomcat的主要配置文件)和web.xml 
work 存放jsp编译后产生的class文件 
webapp 存放应用程序示例，以后你要部署的应用程序也要放到此目录 
logs 存放日志文件 
lib/japser/common 这三个目录主要存放tomcat所需的jar文件

(二)：server.xml配置简介 
下面我们将讲述这个文件中的基本配置信息，更具体的配置信息见tomcat的文档 元素名 属性 解释 
server port 指定一个端口，这个端口负责监听关闭tomcat的请求 
shutdown 指定向端口发送的命令字符串 
service name 指定service的名字 
Connector 
(表示客户端和service之间的连接) port 指定服务器端要创建的端口号，并在这个断口监听来自客户端的请求 
minProcessors 服务器启动时创建的处理请求的线程数 
maxProcessors 最大可以创建的处理请求的线程数 
enableLookups 如果为true，则可以通过调用request.getRemoteHost()进行DNS查询来得到远程客户端的实际主机名，若为false则不进行DNS查询，而是返回其ip地址 
redirectPort 指定服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号 
acceptCount 指定当所有可以使用的处理请求的线程数都被使用时，可以放到处理队列中的请求数，超过这个数的请求将不予处理 
connectionTimeout 指定超时的时间数(以毫秒为单位) 
Engine 
(表示指定service中的请求处理机，接收和处理来自Connector的请求) defaultHost 指定缺省的处理请求的主机名，它至少与其中的一个host元素的name属性值是一样的 
Context 
(表示一个web应用程序，通常为WAR文件，关于WAR的具体信息见servlet规范) docBase 应用程序的路径或者是WAR文件存放的路径 
path 表示此web应用程序的url的前缀，这样请求的url为http://localhost:8080/path/**** 
reloadable 这个属性非常重要，如果为true，则tomcat会自动检测应用程序的/WEB-INF/lib 和/WEB-INF/classes目录的变化，自动装载新的应用程序，我们可以在不重起tomcat的情况下改变应用程序 
host 
(表示一个虚拟主机) 
name 指定主机名 
appBase 应用程序基本目录，即存放应用程序的目录 
unpackWARs 如果为true，则tomcat会自动将WAR文件解压，否则不解压，直接从WAR文件中运行应用程序 
Logger 
(表示日志，调试和错误信息) 
className 指定logger使用的类名，此类必须实现org.apache.catalina.Logger 接口 
prefix 指定log文件的前缀 
suffix 指定log文件的后缀 
timestamp 如果为true，则log文件名中要加入时间，如下例:localhost_log.2001-10-04.txt 
Realm 
(表示存放用户名，密码及role的数据库) 
className 指定Realm使用的类名，此类必须实现org.apache.catalina.Realm接口 
Valve 
(功能与Logger差不多，其prefix和suffix属性解释和Logger 中的一样) 
className 指定Valve使用的类名，如用org.apache.catalina.valves.AccessLogValve类可以记录应用程序的访问信息

directory 指定log文件存放的位置 
pattern 有两个值，common方式记录远程主机名或ip地址，用户名，日期，第一行请求的字符串，HTTP响应代码，发送的字节数。combined方式比common方式记录的值更多

注意：1：经过我测试，我设置Context 的path="",reloadable=true，然后放一个WAR文件到webapps目录，结果tomcat不能检测出此文件(重起tomcat可以)，而把此文件解压，则tomcat会自动检测出这个新的应用程序。如果不能自动检测WAR文件，我们可以利用下面管理中讲的方法来部署应用程序。

2：默认的server.xml中，Realm元素只设置了一个className属性，但此文件中也包含几个通过JDBC连接到数据库进行验证的示例(被注释掉了)，通过Realm元素我们可以实现容器安全管理(Container Managed Security)。

3：还有一些元素我们没有介绍，如Parameter，loader，你可以通过tomcat的文档获取这些元素的信息。

(三)：管理

1：配置 
在进行具体的管理之前，我们先给tomcat添加一个用户，使这个用户有权限来进行管理。

打开conf目录下的tomcat-users.xml文件，在相应的位置添加下面一行： 
<user name="zf" password="zf" roles="standard,manager"/>

注意：这一行的最后部分一定是/>,tomcat的文档掉了/符号，如果没有/符号的话，tomcat重起时将无法访问应用程序。通过logs/catalina.out文件你可以看到这个错误的详细信息。

然后重起tomcat，在浏览器中输入http://localhost:8080/manager/，会弹出对话框，输入上面的用户名和密码即可。

2：应用程序列表 
在浏览器中输入http://localhost:8080/manager/list，浏览器将会显示如下的信息： 
OK - Listed applications for virtual host localhost 
/ex:running:1 
/examples:running:1 
/webdav:running:0 
/tomcat-docs:running:0 
/manager:running:0 
/:running:0

面的信息分别为应用程序的路径，当前状态(running 或者stopped)，与这个程序相连的session数。

3：重新装载应用程序 
在浏览器中输入 http://localhost:8080/manager/reload?path=/examples ，浏览器显示如下： 
OK - Reloaded application at context path /examples

表示example应用程序装载成功，如果我们将server.xml的Context元素的reloadable属性设为true(见上面表格)，则没必要利用这种方式重新装载应用程序，因为tomcat会自动装载。

4：显示session信息 
在浏览器中输入http://localhost:8080/manager/sessions?path=/examples，浏览器显示如下： OK - Session information for application at context path /examples Default maximum session inactive interval 30 minutes

5：启动和关闭应用程序 
在浏览器中输入http://localhost:8080/manager/start?path=/examples和http://localhost:8080/manager/stop?path=/examples分别启动和关闭examples应用程序。

6：部署及撤销部署 
WAR有两种组织方式，一种是按一定的目录结构组织文件，一种是一个后缀为WAR的压缩包，因此它的部署方式也有两种： 
(1)：在浏览器中输入：http://localhost:8080/manager/install?path=/examples&war=file:/c:examples 
就会将按目录结构组织的WAR部署

(2)：如果输入 :http://localhost:8080/manager/install?path=/examples&war=jar:file:/c: examples.war!/ 
就会将按压缩包组织的WAR部署，注意此url后半部分一定要有!/号。

部署后就可以用 http://localhost:8080/examples 访问了。

在浏览器中输入：http://localhost:8080/manager/remove?path=/examples 
就会撤销刚才部署的应用程序。

(四)：与apache集成 
虽然tomcat也可以作web服务器,但其处理静态html的速度比不上apache,且其作为web服务器的功能远不如apache,因此我们想把apache和tomcat集成起来。

我们以linux系统为例介绍.

从apache网站下载apache1.3.22源代码版本，然后使用如下命令配置安装apache： 
mkdir /usr/local/apache 
tar zxvf apache.1.32.tar.gz 
cd apache.1.32 
./configure --prefix=/usr/local/apache --enable-module=so 
make 
make install

注意configure命令指定目标安装目录，并且加入DSO(Dynamic Shared Object)支持，注意一定不要忘了这一个选项。

然后下载webapp模块，将解压后mod_webapp.so文件放入apache的libexec目录，编辑apache的conf目录下的httpd.conf，在这个文件的最后加入下面三行： 
LoadModule webapp_module libexec/mod_webapp.so 
WebAppConnection warpConnection warp localhost:8008 
WebAppDeploy examples warpConnection /examples/

第一行是加入webapp模块，如果编译apache时不增加DSO支持，则无法使用LoadModule指令，第二行指定tomcat与apache的连接，第三行指定部署那个应用，这两个指令使用格式如下： 
WebAppConnection [connection name] [provider] [host:port] 
WebAppDeploy [application name] [connection name] [url path]

其中connection name指定连接名，provider只能是warp，port端口与你的tomcat的配置文件server.xml最后几行指定的要保持一致。文件如下： 
<Service name="Tomcat-Apache"> 
<Connector className="org.apache.catalina.connector.warp.WarpConnector" 
port="8008" minProcessors="5" maxProcessors="75" 
enableLookups="true" 
acceptCount="10" debug="0"/> 
****** 
</Service>

application name与你在tomcat中部署的应用名一致，url path指定访问这个应用的url。例如上面的例子可以通过http://localhost/examples/来访问tomcat中的examples应用。

(五)：中文问题 
一般jsp的乱码问题可以通过在jsp中加入<%@ page contentType="text/html;charset=GB2312" %>来解决，至于servlet的乱码在可以使用servlet2.3中提供的HttpServeletRequest.setCharacterEncoding函数。更详细的中文问题请见JSP/Servlet 中的汉字编码问题。

四：综述 
tomcat作为一个servlet(jsp也被编译为servlet执行)容器，其应用前景是非常好的，如果与jboss结合起来，则可以实现sun的j2ee规范(用jboss作ejb服务器)。jboss的官方网站也提供集成了tomcat3.2*的jboss以供下载。另外一个开源的应用服务器(enhydra) 也是基于tomcat的，其提供了更友好的管理界面，部署应用程序也更简单，功能也更强大。

JSP中tomcat的SQL Server2000数据库连接池的配置

环境： 
1. 数据库：Microsoft SQL Server 2000 
2. 数据库驱动程序：net.sourceforge.jtds.jdbc.Driver

JNDI（Java Naming and Directory Interface）概述： 
Tomcat4（5）提供了一个与Java Enterprise Edition应用服务相兼容的JNDI--InitialContext实现实例。它的初始数据设置在$CATALINA_HOME/conf/server.xml文件里，并可能在网页应用环境描述（/WEB-INF/web.xml）里被下列元素引用： 
1) <env-entry>--环境入口，设置应用程序如何操作。 
2) <resource-ref>--资源参数，一般是数据库驱动程序、JavaMail Session、自定义类工厂等。 
3) <resource-env-ref>--在Servlet 2.4里用来简化设置不需认证信息的资源资源如环境参数、resource-ref变量。

InitialContext在网页应用程序初始化时被设置，用来支持网页应用程序组件。所有的入口和资源都放在JNDI命名空间里的java:comp/env段里。点击下列网址以获取更多信息： 
1) Java命名和目录接口（Java Naming and Directory Interface） 
2) J2EE平台说明（J2EE Platform Specification）

设置JNDI资源 
设置JNDI资源要在$CATALINA_HOME/conf/server.xml文件里使用下列标志符： 
1) <Environment>--设置域个可变的JNDI InitialContext入口的名字和值（同上面说的<env-entry>等价）。 
2) <Resource>--设置应用程序可用的资源的名字和类型（同上面说的<resource-ref>等价）。 
3) <ResourceParams>--设置Java资源类工厂的名称或将用的JavaBean属性。 
4) <ResourceLink>--给全局JNDI环境（JNDI Context）添加一个链接。 
上述这些标志符必须放在<Context>和</Context>之间（针对专门的网页应用程序）或<DefaultContext>和</DefaultContext>之间。 
此外，设在网页应用环境描述（Web Application Descriptor）（/WEB-INF/web.xml）里的名字和值也在初始环境（Initial Context）里被设置，当被<Environemt>元素值允许时将被重设初始值。 
全局变量能在<Server>子元素的<GlobalNamingResources>里设置。

数据库连接池概述： 
数据库连接是一种关键的有限的昂贵的资源，这一点在多用户的网页应用程序中体现得尤为突出。对数据库连接的管理能显著影响到整个应用程序的伸缩性和健壮性，影响到程序的性能指标。数据库连接池正是针对这个问题提出来的。 
数据库连接池负责分配、管理和释放数据库连接，它允许应用程序重复使用一个现有的数据库连接，而再不是重新建立一个；释放空闲时间超过最大空闲时间的数据库连接来避免因为没有释放数据库连接而引起的数据库连接遗漏。这项技术能明显提高对数据库操作的性能。 
数据库连接池在初始化时将创建一定数量的数据库连接放到连接池中，这些数据库连接的数量是由最小数据库连接数来设定的。无论这些数据库连接是否被使用，连接池都将一直保证至少拥有这么多的连接数量。连接池的最大数据库连接数量限定了这个连接池能占有的最大连接数，当应用程序向连接池请求的连接数超过最大连接数量时，这些请求将被加入到等待队列中。数据库连接池的最小连接数和最大连接数的设置要考虑到下列几个因素： 
1) 最小连接数是连接池一直保持的数据库连接，所以如果应用程序对数据库连接的使用量不大，将会有大量的数据库连接资源被浪费； 
2) 最大连接数是连接池能申请的最大连接数，如果数据库连接请求超过此数，后面的数据库连接请求将被加入到等待队列中，这会影响之后的数据库操作。 
3) 如果最小连接数与最大连接数相差太大，那么最先的连接请求将会获利，之后超过最小连接数量的连接请求等价于建立一个新的数据库连接。不过，这些大于最小连接数的数据库连接在使用完不会马上被释放，它将被放到连接池中等待重复使用或是空闲超时后被释放。

配置Tomcat数据库连接池的前提： 
1. 必须装有Java运行环境； 
2. 必须有SQL Server2000数据库服务器（可以不在本地）； 
3. 必须有jtds.jar，并将它放在$CATALINA_HOME/common/lib目录下（只能是这里）。使用它是因为Microsoft公司的Java SQL Server驱动程序不支持二次查询，可到网上搜到。目前使用的是jtds-0.6.jar。

在$CATALINA_HOME/conf/server.xml里设置数据库连接池： 
下面是配置的代码，必须放在<Host>和</Host>之间。

<Context path="/quality" docBase="quality" debug="0" reloadable="true" crossContext="true"><Logger className="org.apache.catalina.logger.FileLogger" prefix="localhost_quality_log." suffix=".txt" timestamp="true"/><Resource name="jdbc/connectDB" auth="Container" type="javax.sql.DataSource"/><ResourceParams name="jdbc/connectDB"> <parameter> <name>maxActive</name> <!-- Maximum number of DB connections in pool.Set to 0 for no limit. --> <value>100</value> </parameter> <parameter> <name>maxIdle</name> <!-- Maximum number of idle DB connections to retain in pool.Set to 0 for no limit. --> <value>30</value> </parameter> <parameter> <name>maxWait</name> <!-- Maximum time to wait for a DB connection to become available in ms.An exception is thrown if this timeout is exceeded.Set to -1 to wait indefinitely. --> <value>10000</value> </parameter> <parameter> <name>removeAbandoned</name> <!-- Abandoned DB connections are removed and recycled --> <value>true</value> </parameter> <parameter> <name>removeAbandonedTimeout</name> <!-- Use the removeAbandonedTimeout parameter to set the number of seconds a DB connection has been idle before it is considered abandoned. --> <value>60</value> </parameter> <parameter> <name>logAbandoned</name> <!-- Log a stack trace of the code which abandoned --> <value>false</value> </parameter> <parameter> <name>factory</name> <!-DBCP Basic Datasource Factory --> <value>org.apache.commons.dbcp.BasicDataSourceFactory</value> </parameter> <parameter> <name>username</name> <!-- Database User Name --> <value>Iorishinier</value> </parameter> <parameter> <name>password</name> <!-- User Password --> <value>mypasswd</value> </parameter> <parameter> <name>driverClassName</name> <!-- Database Driver Class Name --> <value>net.sourceforge.jtds.jdbc.Driver</value> </parameter> <parameter> <name>url</name> <!-- Database Address --> <value>jdbc:jtds:sqlserver://127.127.127.127:1433/Northwind</value> </parameter></ResourceParams></Context>

下面是一些参数的说明： 
<Context path="/quality" docBase="quality" debug="0" reloadable="true" crossContext="true"> 
其中： 
1) path 指定路径，这里设定的是$CATALINA_HOME/webapps下的quality目录； 
2) docBase 文件根目录。 
3) reloader 当网页被更新时是否重新编译。 
4) maxActive 连接池的最大数据库连接数。设为0表示无限制。 
5) maxIdle 数据库连接的最大空闲时间。超过此空闲时间，数据库连接将被标记为不可用，然后被释放。设为0表示无限制。 
6) maxWait 最大建立连接等待时间。如果超过此时间将接到异常。设为－1表示无限制。 
7) removeAbandoned 回收被遗弃的（一般是忘了释放的）数据库连接到连接池中。 
removeAbandonedTimeout 数据库连接过多长时间不用将被视为被遗弃而收回连接池中。 
9) logAbandoned 将被遗弃的数据库连接的回收记入日志。 
10) driverClassName JDBC驱动程序。 
11) url 数据库连接字符串

在$CATALINA_HOME/webapps/quality/WEB-INF/web.xml里设置被引用的资源： 
下面是配置代码，必须放在<web-app>和</web-app>里。

<!-- Database Config start --><resource-ref><description>connectDB test</description><res-ref-name>jdbc/connectDB</res-ref-name><res-type>javax.sql.DataSource</res-type><res-auth>Container</res-auth></resource-ref><!-- Database Config end -->

下面是一下参数的必要说明： 
1) description 对被引用的资源的描述。 
2) res-ref-name 资源名称。见上面的<ResourceParams name="jdbc/connectDB"> 
3) res-type 资源类型。见上面的<Resource name="jdbc/connectDB" auth="Container" type="javax.sql.DataSource"/>

在JSP中使用资源： 
这是在$CATALINA_HOME/webapps/quality下的某级子目录里的jsp网页文件部分代码：

<%@ page contentType="text/html;charset=GBK"%><%@ page errorPage="error.jsp"%><%@ page import="javax.naming.*"%><%@ page import="javax.sql.*"%><%@ page import="java.sql.*"%><html> <head> </head> <body> <% ……………… ……………… // 数据库操作 Context ctx=null; Connection cnn=null; Statement stmt=null; ResultSet rs=null; try { ctx=new InitialContext(); if(ctx==null) throw new Exception("没有匹配的环境"); DataSource ds=(DataSource)ctx.lookup("java:comp/env/jdbc/connectDB"); if(ds==null) throw new Exception("没有匹配数据库"); cnn=ds.getConnection(); stmt=cnn.createStatement(ResultSet.TYPE_SCROLL_SENSITIVE,ResultSet.CONCUR_READ_ONLY); rs=stmt.executeQuery("select * from table1"); ……………… ……………… } finally { if(rs!=null) rs.close(); if(stmt!=null) stmt.close(); if(cnn!=null) cnn.close(); if(ctx!=null) ctx.close(); } %> </body></html>

代码说明： 
DataSource ds=(DataSource)ctx.lookup("java:comp/env/jdbc/connectDB"); 
上面这句应用了刚才设的资源。 
资源使用完要释放，尤其是Context资源，见try-catch-finally部分的finally代码段，这是一种好的习惯。资源释放时如果释放了上级资源，下级资源将先被释放。如：释放了ctx，那么资源释放顺序将是rs，stmt，cnn，ctx。换句话说，如果释放了ctx，那么rs，stmt和cnn都将不可用了。 
这里的释放资源只是将数据库连接返回连接池中，并不是把资源真正释放掉，见数据库连接池概述