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最新版本为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的，其提供了更友好的管理界面，部署应用程序也更简单，功能也更强大。


－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－


JDK安装在/opt/j2sdk/j2sdk
Tomcat安装在/opt/tomcat

附: 版本信息
java version "1.4.1_06"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.1_06-b01)
Java HotSpot(TM) Client VM (build 1.4.1_06-b01, mixed mode)
Apache Tomcat/4.1.29


[添加环境变量]
(放入/etc/bashrc或者/etc/profile中)

JAVA_HOME=/opt/j2sdk/j2sdk;
CATALINA_HOME=/opt/tomcat;
PATH=$JAVA_HOME/bin:$JAVA_HOME/jre/bin:$CATALINA_HOME/bin:$PATH;
CLASSPATH=.:$JAVA_HOME/lib:$CATALINA_HOME/common/lib/servlet.jar;

export PATH JAVA_HOME CATALINA_HOME CLASSPATH

对于Tomcat 5，应该把上面的
$CATALINA_HOME/common/lib/servlet.jar
改为
$CATALINA_HOME/common/lib/servlet-api.jar:$CATALINA_HOME/common/lib/jsp-api.jar

[启动/关闭Tomcat]
startup.sh / shutdown.sh

[Tomcat目录说明]
bin存放启动和关闭tomcat的脚本
conf包含不同的配置文件，server.xml和web.xml
work存放jsp编译后产生的class文件
webapps存放部署的应用程序
webapps/ROOT缺省ROOT目录
webapps/examplesTomcat程序范例
logs存放日志文件
common/lib存放Tomcat所需的jar文件

[Tomcat管理用户设置]
编辑$CATALINA_HOME/conf/tomcat-user.xml，例如添加用户windix，密码123:
<tomcat-users>
...
<user username="windix" password="123" roles="standard,manager"/>
</tomcat-users>
然后重新启动Tomcat，在浏览器网址栏输入输入"http://server:8080/manager/html"，即可进入管理界面

[Tomcat应用程序列表]
在浏览器网址栏输入"http://server:8080/manager/list"，显示示例如下:
OK - Listed applications for virtual host localhost
/admin:running:1:../server/webapps/admin
/myapp:running:0:/opt/jakarta-tomcat-4.1.29/webapps/myapp
/webdav:running:0:/opt/jakarta-tomcat-4.1.29/webapps/webdav
/examples:running:0:examples
/tomcat-docs:running:0:/opt/jakarta-tomcat-4.1.29/webapps/tomcat-docs
/:running:1:/opt/jakarta-tomcat-4.1.29/webapps/ROOT
/manager:running:0:../server/webapps/manager

显示的信息依次为 应用程序路径，当前状态(running/stopped)，与这个程序相连的session数，物理路径

[让Tomcat显示session信息]
在浏览器网址栏输入"http://server:8080/manager/sessions?path=<路径>"，显示示例如下:
OK - Session information for application at context path /examples
Default maximum session inactive interval 30 minutes

[启动和关闭应用程序]
在浏览器网址栏分别输入
http://server:8080/manager/start?path=<路径>
http://server:8080/manager/stop?path=<路径>

[让Tomcat重新载入servlet]
方法1. 修改$CATALINA_HOME/conf/server.xml，加入<context>标签，方法如下:
搜索"Tomcat Root Context"，然后在上面加入一行<DefaultContext reloadable="true"/>，修改完后结果如下：
...
<DefaultContext reloadable="true"/>

<!-- Tomcat Root Context -->
<!--
<Context path="" docBase="ROOT" debug="0"/>
-->
...
方法2. 重新启动Tomcat服务器

方法3. 修改(touch)部署的web.xml，只要web.xml文件被修改过，Tomcat会自动侦测并重新载入该档案所包含的servlets

方法4. 在浏览器网址栏输入"http://server:8080/manager/reload?path=<路径>"，如本例为:
http://server:8080/manager/reload?path=/myapp
然后会提示你输入管理员用户帐号的密码（只需要第一次输入），若执行成功，则提示:
OK - Reloaded appliation at context path ***

[部署自己的servlet]
1. 独立的.class文件
假如要放在myapp目录下:
建立$CATALINA_HOME/webapps/myapp/WEB-INF/classes/，并将编译后的.class文件copy到此
编辑$CATALINA_HOME/webapps/myapp/WEB-INF/web.xml

2. WAR文件
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集成]
.....

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－

第一步：下载j2sdk和tomcat：到sun官方站点

最新的jdk为1.5，tomcat为5.5，建议jdk1.4以上，tomcat4.0以上

第二步：安装和配置你的j2sdk和tomcat：执行j2sdk和tomcat的安装程序，然后设置按照路径进行安装即可。

1.安装j2sdk以后，需要配置一下环境变量，在我的电脑->属性->高级->环境变量->系统变量中添加以下环境变量(假定你的j2sdk安装在c:j2sdk1.4.2）：

JAVA_HOME=c:
j2sdk1.4.2 
classpath=.;
%JAVA_HOME%libdt.jar;
%JAVA_HOME%libtools.jar;

path=%JAVA_HOME%bin

接着可以写一个简单的java程序来测试J2SDK是否已安装成功：

public class Test
{ 
public static void main
(String args[])
{ 
System.out.println
("This is a test program."); 
} 
}

将上面的这段程序保存为文件名为Test.java的文件。

然后打开命令提示符窗口，cd到你的Test.java所在目录，然后键入下面的命令：

javac Test.java 
java Test

此时如果看到打印出来This is a test program.的话说明安装成功了，如果没有打印出这句话，你需要仔细检查一下你的配置情况。

2、安装Tomcat后，在我的电脑->属性->高级->环境变量->系统变量中添加以下环境变量(假定你的tomcat安装在c:tomcat）：

CATALINA_HOME：c:tomcat
CATALINA_BASE：c:tomcat
TOMCAT_HOME: C:Tomcat

然后修改环境变量中的classpath，把tomat安装目录下的commonlib下的servlet.jar追加到classpath中去，修改后的classpath如下：

classpath=.;
%JAVA_HOME%libdt.jar;
%JAVA_HOME%libtools.jar;
%CATALINA_HOME%commonlibservlet.jar;

接着可以启动tomcat，在IE中访问http://localhost:8080，如果看到tomcat的欢迎页面的话说明安装成功了。

第三步：建立自己的jsp app目录

1.到Tomcat的安装目录的webapps目录，可以看到ROOT，examples, tomcat-docs之类Tomcat自带的的目录；

2.在webapps目录下新建一个目录，起名叫myapp；

3.myapp下新建一个目录WEB-INF，注意，目录名称是区分大小写的；

4.WEB-INF下新建一个文件web.xml，内容如下：

<?xml version="1.0"
encoding="ISO-8859-1"?> 

<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, 
Inc.//DTD Web Application 2.3//EN" 
"http://java.sun.com/dtd/web-app_2_3.dtd"> 

<web-app> 
<display-name>My Web Application
</display-name> 
<description> 
A application for test. 
</description> 
</web-app>

5、在myapp下新建一个测试的jsp页面，文件名为index.jsp，文件内容如下：

<html><body><center> 
Now time is: 
<%=new java.util.Date()%> 
</center></body></html>

6、重启Tomcat

7、打开浏览器，输入http://localhost:8080/myapp/index.jsp 看到当前时间的话说明就成功了。

第四步：建立自己的Servlet：

写入你的第一个Servlet：

import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;
public class HelloWorld 
extends HttpServlet
{
public void doGet
(HttpServletRequest request,
HttpServletResponse response)th
rows ServletException,IOException
{
response.setContentType("text/html"); 
PrintWriter out = response.getWriter();
out.println("<html><head><title>");
out.println("This is my first Servlet");
out.println("</title></head><body>");
out.println("<h1>Hello,World!</h1>");
out.println("</body></html>");

}
}

然后照样用javac HelloWorld.java来编译这个文件，如果出现无法import javax.servl

et.*

那么就是应该把C:Tomcatcommonlib里面的servlet.jar文件拷贝到C:JDKjrelibe

xt中，再次编译，就没有问题了。

然后在Tomcat目录里面的C:TomcatwebappsROOT里面按如下的文件结构：

ROOTindex.html
ROOTwelcom.jsp
ROOTWEB-INFlibMyServlet.jar
（如果你的servlet的.class打成了.jar文件，
则放在lib下面)
ROOTWEB-INFclassesHelloWorld.class
(把上面生成的HelloWorld.class文件放在这个里面)

然后在浏览器中输入http://localhost:8080/servlet/HelloWorld,于是Server众望所归的报错了:Error 404--Not Found

怎么回事呢？

Servlet必须使用C:TomcatwebappsROOTWEB-INF这个目录下面的web.xml文件进行注册，

用EP打开这个web.xml文件，

把下面这段程序

<servlet>
<servlet-name>HelloWorld</servlet-name>
<servlet-class>HelloWorld</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>HelloWorld</servlet-name>
<url-pattern>/servlet/HelloWorld</url-pattern>
</servlet-mapping>

替换成

<servlet>
<servlet-name>HelloWorld</servlet-name>
<servlet-class>HelloWorld</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>HelloWorld</servlet-name>
<url-pattern>/servlet/HelloWorld</url-pattern>
</servlet-mapping>

为什么呢？

因为 这样的结构

<servlet>
<servlet-name>HelloWorld</servlet-name>
<servlet-class>HelloWorld</servlet-class>
</servlet>

表示指定包含的servlet类.

而以下的结构

<servlet-mapping>
<servlet-name>HelloWorld</servlet-name>
<url-pattern>/servlet/HelloWorld</url-pattern>
</servlet-mapping>

表示指定HelloServlet应当映射到哪一种URL模式。

在修改web.xml完毕过后，重新启动Server，然后再输入http://localhost:8080/servlet/HelloWorld，那么偌大一个Hello,World!等着你呢。