Tomcat环境的建立 TomcatApacheServletJSP应用服务器

Tomcat是在SUN的JSWDK的基础上发展起来的另一个优秀的JSP服务器，它不但支持Servlet，而且还提供了Web服务器的功能。作为一个开放源码的软件，Tomcat有着自己独特的优势，可以和目前大部分的主流服务器一起工作，而且有着相当高的运行效率。

　　通过本章，读者将会看到：

　　· Tomcat的基本概念
　　· 如何让Tomcat和IIS一起工作
　　· 如何让Tomcat和Apache一起工作
　　· 如何设定JSP的虚拟目录
　　· 如何将Tomcat设为Windows服务运行

　　Jakarta-Tomcat概貌

　　综述：Tomcat是一个带有JSP环境的servlet容器。servlet容器是一个根据用户的行为可以管理和激活servlet的运行时的shell。

　　我们可以粗略地将servlet容器分为如下几类：

　　独立的servlet容器

　　内置有web服务器的一部分。指使用基于Java的web服务器的情形，例如servlet容器是JavaWebServer的一个部分。独立的servlet容器是Tomcat的默认模式。

　　然而，大多数的web服务器并非基于Java。因此，我们可以得出如下两种容器的模式：

　　进程内的servlet容器

　　servlet容器作为web服务器的插件和Java容器的实现。Web服务器插件在内部地址空间打开一个JVM（Java virtual machine）使Java容器得以在内部运行。如有某个需要调用servlet的请求，插件将取得对此请求的控制并将它传递（使用JNI）给Java容器。进程内容器对于多线程、单进程的服务器非常合适并且提供很好的运行速度，但伸缩性有所不足。

　　进程外的servlet容器

　　servlet容器运行于web服务器之外的地址空间且作为web服务器的插件和Java容器的实现的结合。web服务器插件和Java容器 JVM使用IPC机制（通常是TCP/IP）进行通讯。当一个调用servlet的请求到达时，插件将取得对此请求的控制并将其传递（使用IPC等）给Java容器，进程外容器的反应时间或进程外容器引擎不如进程内容器，但进程外容器引擎在许多其他可比的范围内更好（伸缩性、稳定性等）。

　　Tomcat既可作为独立的容器（主要是用于开发与调试），又可作为对现有服务器的附加（当前支持Apache、IIS和Netscape服务器）。所以在配置Tomcat时，必须决定如何应用它，如果选择第二或第三种模式，还需要安装一个web服务器接口。

　　Tomcat与Jserv有何区别？Tomcat是Jserv吗？

　　这是个常见的误解。Jserv是Servlet API2.0兼容并与Apache一起使用的容器。Tomcat是一个完全重写的并与Servlet API2.2和JSP1.1兼容的容器。
　　另外，Tomcat使用了一些为Jserv而写的代码，特别是Jserv的Apache接口，但这是唯一的相同之处。

　　怎样安装Tomcat的二进制版本？

　　非常简单，只需：下载 zip/tar.gz 任何压缩文件，从http://jakarta.apche.org/download/binindex.html处解压缩此文件到某目录(如：foo)，将会生成一子目录，名为"tomcat"，转换到"tomcat"目录设置一新的环境变量(TOMCAT_HOME)指向你安装的tomcat的目录：
　　WIN32平台，键入： set TOMCAT_HOME=foo/tomcat
Unix平台：

　　如是bash/sh环境，键入：TOMCAT_HOME=foo/tomcat;export TOMCAT_HOME"
　　如是tcsh环境，键入：setenv TOMCAT_HOME foo/tomcat
　　设置环境变量JAVA_HOME指向你JDK的目录，然后添加JAVA解释器到你的PATH环境变量。
　　好了！现在可以运行TOMCAT并作为一个独立的Servlet容器(模式一)

　　启动与关闭Tomcat

　　使用"bin"目录中的脚本启动与关闭Tomcat。

　　启动：

　　uinx:bin/startup.sh
　　win32:binstartup 

　　关闭：

　　unix:bin/shutdown.sh
　　win32:binshutdown
　　Tomcat目录结构 

　　假设读者已将Tomcat解压，这时将得到下列目录结构：

目录名 描述
bin 包含启动/关闭脚本。
conf 包含不同的配置文件，包括 server.xml（Tomcat的主要配置文件）和为不同的Tomcat配置的web应用设置缺省值的文件web.xml。
doc 包含各种Tomcat文档。
lib 包含Tomcat使用的jar文件。unix平台此目录下的任何文件都被加到Tomcat的classpath中。
logs  Tomcat摆放日志文件的地方。
src ServletAPI源文件。先别高兴，这里只有些必须在Servlet容器内实现的空接口和抽象类。
webapps 包含web项目示例。
work Tomcat自动生成，放置Tomcat运行时的临时文件（如编译后的JSP文件），如果在Tomcat运行时删除此目录.JSP页面将不能运行。
classes 你可以创建此目录来添加一些附加的类到类路径中，任何你加到此目录中的类都可在Tomcat的类路径中找到自身。

　　Tomcat的脚本

　　Tomcat是一个Java程序，因此在设置好几个环境变量后即可用命令行的方式运行。然而设置Tomcat使用的每个环境变量和如下的命令行参数乏味且容易出错。因此，Tomcat开发组提供了一些脚本使启动和关闭Tomcat变得非常轻松。
　　注意：这些脚本仅仅是个便利的方法去启动和关闭Tomcat。你可修改他们来定制CLASSPATH，环境变量如PATH、LD_LIBRARY_PATH等等，只要是生成一个正确的命令行即可。
　　这些脚本是什么呢？下面列出对一般用户最重要的脚本。
　　Tomcat：主脚本。设置合适的环境变量，包括CLASSPATH、TOMCAT_HOME以及JAVA_HOME和用适合的命令行参数启动Tomcat 。
　　startup ：在后台启动Tomcat。它是"tomcat start"命令的替换方式。
　　shutdown ：关闭Tomcat。它是"tomcat stop"命令的替换方式。

　　对用户最重要的脚本是tomcat(tomcat.bat/tomcat.sh)。其他Tomcat相关的脚本作为一个简单的面向单任务的指向Tomcat脚本(设置不同的命令行参数等)的入口。

　　仔细考察tomcat.bat/tomcat.sh，它按以下步骤运行：

　　在Unix下的步骤：

　　如未指定，推测 TOMCAT_HOME
　　如未指定，推测 JAVA_HOME
　　设置CLASS_PATH包含：

　　1．${TOMCAT_HOME}/classes目录(如果存在)
　　2．${TOMCAT_HOME}/lib的一切内容
　　3．${JAVA_HOME}/lib/tools.jar（此jar文件包含工具Javac，我们需要Javac处理jsp文件）

　　运行带有设定Java环境变量的命令行参数的Java命令，调入tomcat.home和org.apache.tomcat.startup.Tomcat 作为启始类。同时也传递命令行参数到org.apache.tomcat.startup.Tomcat ，例如：执行start/stop/run 等的操作。另外，此Tomcat进程使用指向server.xml的路径，例如server.xml放置于etc/server_1.xml并且用户意图在后台启动apache，键入如下命令行：

　　bin/tomcat.sh start -f /etc/server_1.xml
win32版的tomcat.bat与Unix版的几乎一致。尤其在它不推测TOMCAT_HOME和JAVA_HOME的值，并且不将所有的jar文件放入类路径中。

　　Tomcat的配置文件

　　这一部分将讲述如何使用配置文件server.xml和web.xml。我们不会包含web.xml的内部机制，这些内部机制深入到了Servlet API的细节，因此，我们将讨论涵盖这两个配置文件在Tomcat关系环境中的用法。
Tomcat的配置基于两个配置文件：

　　1．server.xml - Tomcat的全局配置文件，完成两个目标：
　　（1）提供Tomcat组件的初始配置
　　（2）说明Tomcat的结构、含义，使得Tomcat通过实例化组件完成启动及构建自身。
结构、含义的说明是通过元素来实现的，下面将描述这些元素。

　　Server：server.xml文件中最重要的元素。Server定义了一个Tomcat服务器。一般读者不用对它担心太多。Server元素能包含Logger和ContextManager元素类型。

　　Logger：此元素定义一个Logger对象，每个Logger都有一个名字去标识，也有一个纪录Logger的输出和冗余级别(描述此日志级别)和包含日志文件的路径，通常有servlet的Logger(ServletContext.log()处)，JSP和Tomcat运行时的Logger。

　　ContextManager：它说明了一套ContextInterceptor、RequestInterceptor、Context和它们的Connectors的配置及结构。ContextManager有几个随同提供的特性：

　　a．用来纪录调试信息的调试级别
　　b．webapps/、conf/、logs/和所有已定义的环境的基本位置。用来使Tomcat可以在TOMCAT_HOME外的其他目录启动。
　　c．工作目录的名字

　　ContextInterceptor&RequestInterceptor：这些侦听器(interceptors)侦听具体发生在ContextManager中的事件，例如，ContextInterceptor侦听Tomcat的启动及终止事件，RequestInterceptor监视在它服务过程中用户请求需要通过的不同阶段。Tomcat的管理员不必知道太多关于侦听器的知识；另外，开发者应该知道这是如何在Tomcat中实现一个"全局"型的操作(例如安全性及每个请求日志) 。

　　Connector：表示一个到用户的联接，不管是通过web服务器或直接到用户浏览器（在一个独立配置中）。Connector负责管理Tomcat的工作线程和读/写连接到不同用户的端口的请求/响应。Connector的配置包含如下信息：

　　a．句柄类
　　b．句柄监听的TCP/IP端口
　　c．句柄服务器端口的TCP/IP的backlog

　　Context：每个Context提供一个指向你放置你Web项目的Tomcat的下属目录。每个Context包含如下配置：

　　a．Context放置的路径，可以是与ContextManager主目录相关的路径
　　b．纪录调试信息的调试级别
　　c．可重载的标志。开发Servlet时,重载更改后的Servlet,这是一个非常便利的特性

　　2．web.xml--在Tomcat中配置不同的关系环境
　　有一个和Tomcat有关的小"特性"与web.xml有关。Tomcat可以让用户通过将缺省的web.xml放入conf目录中来定义所有关系环境的web.xml的缺省值。建立一个新的关系环境时，Tomcat使用缺省的web.xml文件作为基本设置和应用项目特定的web.xml（放在应用项目的WEB-INF/web.xml文件）来覆盖这些缺省值。
如何将Tomcat装入IIS

　　IIS，即Internet Information Server，是微软公司提供的一种功能强大的Web服务器，它对ASP有着很好的支持，这一点相信很多读者都已经知道。现在，JSP已经流行起来，如何才能让IIS支持该技术呢？读者将会从本节得到答案。

　　一、安装环境Windows 2000、IIS 5.0

　　Tomcat 3.1下载地址
　　http://jakarta.apache.org/builds/tomcat/release/v3.1/bin/
　　isapi_redirect.dll下载地址
　　http://jakarta.apache.org/builds/tomcat/release/v3.1/bin/win32/i386/
　　放到{TOMCATHOME}\bin\iis\i386\isapi_redirect.dll

　　二、先要保证Tomcat可以正确执行

　　三、将下面的begin和end之间的Jakarta.reg文件装入机器，我的Tomcat装在c:\\jakarta-tomcat，你可根据自己的环境修改Jakarta.reg文件

　　Jakarta.reg：
　　---begin---
　　Windows Registry Editor Version 5.00
　　[HKEY_LOCAL_MACHINE\SOFTWARE\Apache Software Foundation\Jakarta Isapi Redirector\1.0]
　　"extension_uri"="/jakarta/isapi_redirect.dll"
　　"log_file"="c:\\jakarta-tomcat\\logs\\isapi.log"
　　"log_level"="debug"
　　"worker_file"="c:\\jakarta-tomcat\\conf\\workers.properties"
　　"worker_mount_file"="c:\\jakarta-tomcat\\conf\\uriworkermap.properties"
　　---end--- 

　　四、按照上文配置IIS，以作者的经验安装好isapi_redirect.dll后，需要重新启动机器（重启IIS不好使），实在不行的话再装一次。

　　五、启动tomcat，然后在IE中键入http://baryon/examples/，看一下效果如何，没有用8080端口也可以用jsp和servlet了。注意不启动tomcat，光有IIS是不行的。再注意http://baryon/examples/最后的"/"一定要有，否则会找不到的。

　　如何在windows 9x环境下配置Apache ＋ Tomcat?

　　如果读者使用的是windows 9x操作系统，那么读了下文后，建立自己的JSP运行环境，将变得十分简单。

　　系统配置如下：

　　windows 98（NT主要是环境变量的设法不同，和下面程序的设置无关）

　　jdk1_2_2.exe
　　apache_1_3_9_win32.exe
　　ApacheModuleJServ.dll
　　tomcat.zip(3.1) 

　　一、安装

　　1．安装JDK1.2.2，并将jdk1.2.2的目录加入到环境变量PATH中（Autoexec.bat）；
　　2．安装apache_1_3_9_win32.exe；
　　3．将ApacheModuleJServ.dll拷到Apache所在目录的modules子目录中；
　　4．安装Tomcat 3.1(解压并拷到某个目录中)；
　　此时所需部件都已经安装完毕，以下是配置过程。

　　二、配置

　　1．首先编辑Apache的conf子目录下的http.conf文件使其能正常运行并配合自己的机器配置

　　2．设置以下环境变量（可以放在autoexec.bat中）：
　　SET TOMCAT_HOME=C:\PROGRA~1\Tomcat

　　（注：此时如果有Windows风格目录，一定要写成DOS下目录格式，不然容易出问题）
　　SET JAVA_HOME=C:\PROGRA~1\jdk1.2.2

　　3．打开TOMCAT的conf子目录下的tomcat.conf文件，将以下行前的注释去掉：
　　LoadModule jserv_module modules/ApacheModuleJServ.dll
　　再将对应LINUX的类似一行用注释屏蔽掉。 ／

　　4、打开apache的httpd文件，在最后加入一行：
　　include c:/progra~1/tomcat/conf/tomcat.conf

　　三、启动与测试：

　　1．首先启动apache，此时如果正确，应当显示为：

　　Apache/1.3.9 (Win32) tomcat/1.0 running...

　　2．进入到tomcat的执行目录(bin)。

　　注一：此目录如果为windows风格目录，一定要用windows目录表示法进入，如：progra~1 一定要写为program files

　　注二：通常要求执行命令的运行环境变量大小为4096

　　3．用tomcat.bat start或tomcat.bat run启动tomcat，此时应当可以看到正确输出的classpath，说明Tomcat启动成功！
　　4．在浏览器中输入http://localhost/examples/，此时应当可以看到server返回的三个目录列表。点击其中JSP的就可以看到示例了。

　　只要用官方站下载的程序，照上述几步应当能正确启动JSP环境，接下来的问题就是如何加入context以便映射到自己的工作目录，请读者参考1.2.5节。

　　如何在Windows NT 4.0下安装Apache ＋ Servlet ＋ JSP

　　环境配置一向是比较烦的一件工作！本节的目的就是要轻松为读者搞定NT下安装和配置SERVLET和JSP的执行环境。

　　首先，到Java.apache.org去下载一个tomcat3.1或tomcat3.2。下载的是一个ZIP文件。将它解压到一个目录下面。比如c:\下面。在c盘下面就会出现一个jakatar-tomcat的目录。读者可以将这个目录改个名字，假设改为tomcat。现在打开c:\tomcat\conf目录下的server.xml文件。找到ContextManager标签，将可以看到：

　　＜Connector className="org.apache.tomcat.service.SimpleTcpConnector"＞
　　＜Parameter name="handler" value="org.apache.tomcat.service.http. HttpConnectionHandler"/＞
　　＜Parameter name="port" value="80"/＞
　　＜/Connector＞ 

　　因为tomcat可以作为一个独立的服务器使用，所以有它自己的端口号。在这里可以修改它缺省的端口号，而该号在本机未被占用。假设改成9000。

　　现在到c:\tomcat\bin目录下面，读者可以看到一个startup.bat的批处理文件。在执行这个文件前，如果你用的是JDK1.2.1或JDK1.2.2的话，请将JDK_HOME\LIB\tools.jar这个文件放到classpath中去。 （注：设置classpath的方法：右键单击"我的电脑"－＞选择属性-＞ 环境，如果还没有classpath这个环境变量，就添加一个，如果有了就在它的基础上修改，加上JDK_HOME\LIB\tools.jar）。

　　现在可以执行startup.bat这个文件了。（如果在执行时出现out of environment space的提示，就将DOS窗口的缓冲区大小开得大些。具体作法：在DOS 窗口的菜单中的属性－＞ 内存 －＞ 总共和初始环境改大点）

　　在执行完后，startup.bat会在另一个窗口打开start tomcat。打开浏览器，在地址栏中输入：http://localhost:9000/

　　然后回车。这时应该看到了一只jakatar-tomcat。现在在地址栏键入： http://localhost:9000/examples/servlet/，回车，应该看到一个servlet的index的页面，点击其中的例子servlet看看吧。现在在地址栏键入http://localhost:9000/examples/jsp/，回车，读者也会看到一个类似刚才servlet index页面的一个页面，点击jsp的例子看看吧。如果在点击了一个JSP的例子后出现500的错误，如果没有别的错误信息，在IE5的工具菜单－＞Internet选项－＞高级，把显示友好的HTTP错误的选项去掉，然后IE就会报出具体的出错信息。原因是你没有将tools.jar放到classpath中去。

　　现在要将tomcat连接到apache上去了。首先到www.apache.org上去下载一个Apache Web Server。再到Java.apache.org上去下载一个Jserv。先安装Apache Web Server（比如安装在c:\apache目录下面）。安装完后需要修改c:\apache\conf\httpd.conf文件，找到Servername，修改为自己喜欢的名字，找到port，修改为未被占用的端口。再安装Jserv（比如安装在c:\Jserv目录下面）。安装Jserv需要指定JVM所在的目录，你可以指定JDK_HOME\BIN目录。需要指定JSDK所在目录。（实际上它要找的是servlet.jar这个文件，你可以指定tomcat\lib\servlet.jar试一试）

　　这时候实际上Apache已经支持Servlet了，但还不支持JSP。所以还需修改c:\apache\conf\httpd.conf文件。用文本编辑器打开httpd.conf，在文件最后加上：Include "Tomcat_Home\conf\tomcat-apache.conf"。（请注意，tomcat-apache.conf这个文件是在tomcat运行后由tomcat自动产生的。所以要先开tomcat，再打开Apache）

　　现在先启动tomcat（c:\tomcat\bin\startup.bat），当出现了另一个窗口后，启动Apache（c:\apache\bin\apache.exe或者通过开始菜单－＞程序－＞Apache Web Server－＞Start Apache启动）。如果此时通过后者启动Apache，有一个DOS窗口一闪后就消失了，说明对Apache+JServ+tomcat的配置还有问题，应该通过第一种方法启动Apache，此时能在屏幕上看到具体的出错信息。

　　如果出错信息是：apj* : can't be specified more than once per host。（*号代表一些字符串，比如ApJServLogLevel等等），就要修改c:\Jserv\conf\jserv.conf文件，将apj*的相关行注释掉就可以，可能需要注释5-6行。如果Apache也正常启动的话，现在你可以在地址栏键入http://localhost:apache_port/examples/servlet/ 来通过Apache+tomcat调试Servlet，这里apache_port是Apache的端口号，可以通过修改c:\apache\conf\httpd.conf这个文件修改端口号；在地址栏键入http://localhost:apache_port/examples/jsp/ 来调试JSP。

　　怎样设置JSP的虚拟目录？

　　如果读者细心的话，会发现前面测试用的都是examples\jsp目录。现在就讲一下怎么创建自己的工作目录。

　　首先在d:\tomcat\webapps（假定安装目录为d:\tomcat）目录下面创建myweb目录，接着在myweb目录下面创建jsp目录和classes目录。然后用文本编辑器打开d:\tomcat\conf目录下面的server.xml，查找到＜ContextManager＞标签，并在该标签的结束标签＜/ContextManager＞前面加上：

　　＜Context path="/myweb" docBase="webapps/myweb" debug="0" reloadable="true" ＞
　　＜/Context＞

　　其中path的值是虚拟目录，docbase的值是你的硬盘的的目录的绝对路径。
然后将d:\tomcat\webapps\myweb\classes目录放到classpath这个环境变量中去。用文本编辑器编辑下面这个文件。

　　＜html＞
　　＜body＞
　　＜%
　　for(int i=1;i＜3;i++){
　　out.println("＜h" + i + "＞Hello World＜/h" + i + "＞");
　　}
　　%＞
　　＜/body＞
　　＜/html＞ 

　　存为c:\tomcat\webapps\myweb\jsp\helloworld.jsp。

　　在地址栏键入：http://localhost:apache_port/testdir/jsp/helloworld.jsp 看看结果吧。

　　再测试一下Servlet。用文本编辑器编辑下面这个文件。

　　import Java.io.*;
　　import Java.text.*;
　　import Java.util.*;
　　import Javax.servlet.*;
　　import Javax.servlet.http.*;
　　public class HelloWorld extends HttpServlet {
　　public void service(HttpServletRequest request, HttpServletResponse response)
　　throws IOException, ServletException
　　{
　　response.setContentType("text/html");
　　ServletOutputStream out = response.getOutputStream();
　　out.println("＜html＞");
　　out.println("＜head＞");
　　String title = "Hello World";
　　out.println("＜title＞" + title + "＜/title＞");
　　out.println("＜/head＞");
　　out.println("＜body bgcolor=\"white\"＞");
　　out.println("＜body＞");
　　out.println("＜h1＞" + title + "＜/h1＞");
　　out.println("＜/body＞");
　　out.println("＜/html＞");
　　}
　　}


　　存为c:\tomcat\webapps\myweb\classes\HelloWorld.Java，用Javac编译后，在地址栏键入http://localhost:apache_port/testdir/servlet/HelloWorld 看看结果吧。

　　如何设定Tomcat作为Windows的服务而启动？

　　上面我们已经谈到，要使用Tomcat作为Web服务时，必须先手工启动Tomcat，这显然不是一个适合Tomcat作为Web服务的方法，在Linux下可以通过修改启动脚本自动启动Tomcat，在Windows下则可以设定Tomcat作为Windows的服务而启动。

　　我们可以借助工具，使Tomcat作为Windows NT/2000的一个服务：

　　一、 下载工具，这里作为例子的是gservany--将NT下的一般应用程序作为服务运行的工具。下载网址为http://www.advok.com/gservany.html。将zip文件解压缩，将gservany.exe放入winnt\system32下

　　二、在NT/2000的command下输入：gservany -i tomcat "C:\Jakarta-tomcat\bin" "startup.bat" "C:\Jakarta-tomcat\bin" "shutdown.bat"。其中C:\Jakarta-tomcat为Tomcat的安装目录。

　　三、启动service管理器，会看到tomcat service被装上。