Tomcat 全攻略 收藏
宗 锋, 西北大学计算机系硕士
简介： 随着 java 的流行，其在 web 上的应用也越来越广，tomcat 作为一个开源的 servlet 容器，应用前景越来越广，本文将向你讲述 tomcat 的一些知识。
转载自：http://www.ibm.com/developerworks/cn/java/l-tomcat/index.html#1
简介
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 ( 表示客户端和 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 的，其提供了更友好的管理界面，部署应用程序也更简单，功能也更强大。
宗 锋, 西北大学计算机系硕士
简介： 随着 java 的流行，其在 web 上的应用也越来越广，tomcat 作为一个开源的 servlet 容器，应用前景越来越广，本文将向你讲述 tomcat 的一些知识。
转载自：http://www.ibm.com/developerworks/cn/java/l-tomcat/index.html#1
简介
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 ( 表示客户端和 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 的，其提供了更友好的管理界面，部署应用程序也更简单，功能也更强大。
扫一扫
4428
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
