Java 版 (精华区)
发信人: DreamWeaver (猪头小队长·笑脸), 信区: Java
标 题: Tomcat全攻略
发信站: 哈工大紫丁香 (2002年10月28日12:52:29 星期一), 站内信件
出处：http://www-900.ibm.com/developerWorks/cn/java/l-tomcat/index.shtml
随着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最新版本为4.0.1，这个版本用了一个新的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 |port |指定服务器端要创建的端口号，并在这个断 |
|(表示客户端和 | |口监听来自客户端的请求 |
|service之间的连接) +-----------------+---------------------------------------+
| |minProcessors |服务器启动时创建的处理请求的线程数 |
| +-----------------+---------------------------------------+
| |maxProcessors |最大可以创建的处理请求的线程数 |
| +-----------------+---------------------------------------+
| |enableLookups |如果为true，则可以通过调用 |
| | |request.getRemoteHost()进行DNS查询来得 |
| | |到远程客户端的实际主机名，若为 false则 |
| | |不进行DNS查询，而是返回其ip地址 |
| +-----------------+---------------------------------------+
| |redirectPort |指定服务器正在处理http请求时收到了一个 |
| | |SSL传输请求后重定向的端口号 |
| +-----------------+---------------------------------------+
| |acceptCount |指定当所有可以使用的处理请求的线程数都 |
| | |被使用时，可以放到处理队列中的请求数， |
| | |超过这个数的请求将不予处理 |
| +-----------------+---------------------------------------+
| |connectionTimeout|指定超时的时间数(以毫秒为单位) |
+-------------------+-----------------+---------------------------------------+
|Engine |defaultHost |指定缺省的处理请求的主机名，它至少与其 |
|(表示指定service中 | |中的一个host元素的name属性值是一样的 |
|的请求处理机，接收 | | |
|和处理来自Connector| | |
|的请求) | | |
+-------------------+-----------------+---------------------------------------+
|Context |docBase |应用程序的路径或者是WAR文件存放的路径 |
|(表示一个web应用程 +-----------------+---------------------------------------+
|序，通常为WAR文件，|path |表示此web应用程序的url的前缀，这样请求 |
|关于WAR的具体信息见| |的url为http://localhost:8080/path/**** |
|servlet规范) +-----------------+---------------------------------------+
| |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 |className |指定Realm使用的类名，此类必须实现 |
|(表示存放用户名，密| |org.apache.catalina.Realm接口 |
|码及role的数据库) | | |
+-------------------+-----------------+---------------------------------------+
|Valve |className |指定Valve使用的类名， |
|(功能与Logger差不多| |如用org.apache.catalina.valves |
|其prefix和suffix属 | |.AccessLogValve类可以记录应用程序的 |
|性解释和Logger 中的| |访问信息 |
|一样) +-----------------+---------------------------------------+
| |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的，其提供了更友好的管理界面，部署应用程序
也更简单，功能也更强大。
参考资料：
tomcat文档
www.jguru.com的tomcat faq
apache的文档
关于作者
宗锋：西北大学计算机系硕士，对于基于 web 的各种新技术都感兴趣。
--
╭-╮╭╮╭-╮ ╭╮ . . . . .∴∷.‥˙.˙..‥¨¨
│0││││0│ ││ ╱. .¨. . . ∴ ∵¨
╯▂ ╰╯╯ ╰-╯╯ 妮妮啊~ ∕ ╱ / .∵∵. .
◢█◣ ▃▅◣ ▁▃ ∕ ╱ / .∵
◢████◣◢████◣ ▆▃ ·· ¨ ..
◢███████◣ ◣ ▄ 好想和你一起去看流星雨 Q_Q
※ 来源:·哈工大紫丁香 bbs.hit.edu.cn·[FROM: dw.hit.edu.cn]
※ 修改:·DreamWeaver 於 10月28日16:42:38 修改本文·[FROM: dw.hit.edu.cn]
Powered by KBS BBS 2.0 (http://dev.kcn.cn)
页面执行时间：207.364毫秒