本文档描述了如何在Windows下安装、配置和运行Apache Jakarta Tomcat服务器。在Linux下要做的工作和下面类似。Apache Jakarta Tomcat的项目主页是：http://jakarta.apache.org/tomcat

Tomcat Installation

从http://jakarta.apache.org/tomcat下载Apache Jakarta Tomcat 5.0.18的zip压缩包
解压缩到某个目录中，比如D:\app\jakarta-tomcat-5.0.18
设置环境变量%CATALINA_HOME%为：D:\app\jakarta-tomcat-5.0.18
进入命令行模式并用以下命令启动Tomcat：
%CATALINA_HOME%\bin\startup.bat
如果在控制台看见信息：Server startup in xxxxx ms，则说明Tomcat已经被启动，它将在端口8080（默认端口）侦听客户请求。
测试：打开浏览器并访问http://localhost:8080/，如果可以看见Tomcat的首页，那么一切正常。
进入命令行模式并用以下命令关闭Tomcat：
%CATALINA_HOME%\bin\shutdown.bat

Tomcat Directory Layout
Tomcat的目录结构如下： Directory Explanation
bin 存放启动和关闭Tomcat的可执行脚本
conf Tomcat的配置文件，如server.xml（Tomcat服务器配置文件）和web.xml（被所有webapps共享的配置文件）
work 存放jsp编译后产生的class文件
webapps 存放web applications，用户自己需要部署的应用程序也要放到此目录
logs 存放日志文件
common 被Tomcat Server本身和所有的web applications共享的库文件（*.jar），如servlet的API就存放在common/lib/servlet-api.jar中
shared 被所有的web applications（但不被Tomcat Server本身）共享的库文件（*.jar）


Tomcat Components

Server : Tomcat Server是整个Catalina JSP/Servlet容器，它是一个单件（Sinleton）。
Service : Service是这样一个集合：它由一个或者多个Connector组成，并拥有一个负责处理所有Connector所获得的客户请求的Engine。
Connector : 一个Connector将在某个指定端口上侦听客户请求，并将获得的请求交给Engine来处理，从Engine处获得回应并返回客户。Tomcat有两个典型的Connector，一个直接侦听来自web浏览器的HTTP请求，一个侦听来自其它WebServer的请求：
Coyote Http/1.1 Connector 在端口8080处侦听来自客户browser的http请求。
Coyote JK2 Connector 在端口8009处侦听来自其它WebServer(Apache)的servlet/jsp代理请求。
Engine : Engine是某个service中的请求处理机，它负责接收和处理来自Connector的请求。Engine下可以配置多个虚拟主机（Virtual Host），每个虚拟主机都有一个域名。当Engine获得一个请求时，它将根据请求中的信息把该请求匹配到某个Host上，然后在该Host配置的环境下处理该请求。Engine有一个默认虚拟主机，当请求无法匹配到任何一个Host上的时候，将交给该默认虚拟主机来处理。
Host : 一个Host代表一个虚拟主机（Virtual Host），每个虚拟主机和某个域名（Domain Name）相匹配。每个虚拟主机下都可以部署（deploy）一个或者多个web applications，每个web application对应于一个Context，并拥有一个Context path。当Host获得一个针对某个特定的Host的请求时，将在该Host的环境下把请求匹配到某个Context上，然后把请求交给该Context来处理。Context的匹配方法是“最长匹配”，所以一个 path="" 的Context将成为该Host的默认Context，所有无法和其它Context的路径名匹配的请求都将最终和该默认Context匹配。
Context : 一个Context对应于一个web application，一个web application由一个或者多个Servlet组成。每个Context在创建的时候都将根据配置文件conf/web.xml和webapps/${webapp.home}/WEB-INF/web.xml载入Servlet类和创建映射表（mapping table）。当Context获得请求时，将在自己的映射表中寻找相匹配的Servlet类。如果找到，则执行该类，获得结果并返回。

Tomcat Server的结构图如下。注意下图只是根据conf/server.xml配置文件画出的结构图，并不保证该图与Tomcat的实现相吻合。


Server Configuration
用户可以通过修改conf/server.xml文件定置Tomcat Server的行为。该文件的描述如下： element attribute explanation
Server port 指定一个端口，这个端口负责监听关闭Tomcat的请求
shutdown 向以上端口发送的关闭服务器的命令字符串
Service name service的名称
Connector port 服务器连接器的端口号，该连接器将在指定端口侦听来自客户端的请求
minProcessors 服务器启动时创建的处理请求的线程数，每个请求由一个线程负责
maxProcessors 最多可以创建的处理请求的线程数
enableLookups 如果为true，则可以通过调用request.getRemoteHost()进行DNS查询来得到远程客户端的实际主机名；若为false则不进行DNS查询，而是返回其ip地址
redirectPort 服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号
acceptCount 当所有可以使用的处理请求的线程都被用光时，可以放到处理队列中的请求数，超过这个数的请求将不予处理，而返回Connection refused错误
connectionTimeout 等待超时的时间数（以毫秒为单位）
Engine defaultHost 缺省的处理请求的虚拟主机名，它至少与其中的一个Host元素的name属性值是一样的
Host name 虚拟主机名
appBase web applications的基本目录
unpackWARs 如果为true，则tomcat会自动将WAR文件解压；否则不解压，直接从WAR文件中运行应用程序
Context docBase web application的文件存放路径或者是WAR文件存放路径
path 表示此web application的URL的前缀，用来匹配一个Context。请求的URL形式为http://localhost:8080/path/*
reloadable 如果为true，则Tomcat将支持热部署，会自动检测web application的/WEB-INF/lib 和/WEB-INF/classes目录的变化，自动装载新的JSP和Servlet，我们可以在不重起Tomcat的情况下改变web application
注：还有一些元素没有介绍，如Logger，Realm，Valve等，是因为暂时我还没有用到这些元素。你可以通过Tomcat的文档获取这些元素的信息。

Web Application Configuration
每个web application对应于某个虚拟主机（Host）下的某个Context。一个web application是若干个HTML，JSP和Servlet文件的集合。当一个web application被初始化的时候，它将用自己的ClassLoader载入“部署配置文件” web.xml 中定义的每个Servlet类和映射表。它首先载入在conf/web.xml中定义的Servlet类和映射表，然后载入位于 webapps/${docBase}/WEB-INF/web.xml 下的自己的部署配置文件中定义的servlet类和映射表。

web.xml文件有两部分：Servlet类定义和映射表定义。每个被载入的Servlet类都有一个名字（不是类名），该名字被填入Context的映射表（mapping table）中，并和某种形式的URL pattern相联系。当某个URL被请求时，将先寻找对应的Host，然后匹配最长的Context，然后查询该Context下的mapping table，找到被请求的Servlet类，并执行之。

分析一下web.xml文件的结构： element sub-element explanation
servlet servlet-name Servlet名字（不是类名，只是一个标识符）
servlet-class Servlet的类名（全称，包括包名，该名用来定位一个Servlet类）
init-param Servlet的初始化参数，每个参数用一个名值对表示：param-name = param-value
servlet-mapping servlet-name Servlet名字，和servlet中的servlet-name相对应
url-pattern URL匹配模式，当请求该模式的URL时，指定Servlet将被调用


分析一下conf/web.xml文件，该文件被所有的web applications共享，其中定义的Servlet类和映射表将被所有的web application载入。 servlet-name url-pattern function
default / 由于对URL进行最长匹配，所以url-pattern为/的该Servlet将在用户的HTTP请求无法匹配任何一个Servlet的时候被调用。该Servlet将返回用户一条错误信息。
invoker /servlet/* 形式为/servlet/FullClassName的URL会和invoker匹配，invoker将根据FullClassName调用${webapp.home}/WEB-INF/classes/FullClassName类，即使该类没有在${webapp.home}/WEB-INF/web.xml中被声明。注意FullClassName必须包含用点分隔的包的全称。
jsp *.jsp, *.jspx 当请求的是一个JSP页面的时候（*.jsp），该Servlet被调用。它实质上是一个JSP编译器，将请求的JSP页面映射成相应的Servlet在执行。当该JSP页面还没有编译的时候，jsp还将完成编译工作。


How Tomcat is Dealing with an HTTP Request
假设来自客户的HTTP请求为：http://localhost:8080/yourContext/yourJSPPage.jsp

请求被发送到本机端口8080，被在那里侦听的Coyote HTTP/1.1 Connector获得
Connector把该请求交给它所在的Service的Engine来处理，并等待来自Engine的回应
Engine获得请求localhost/yourContext/yourJSPPage.jsp，匹配它所拥有的所有虚拟主机Host
Engine匹配到名为localhost的Host（即使匹配不到也把请求交给该Host处理，因为该Host被定义为该Engine的默认主机）
localhost Host获得请求/yourContext/yourJSPPage.jsp，匹配它所拥有的所有Context（最长匹配）
Host匹配到路径为/yourContext的Context（如果匹配不到就把该请求交给路径名为""的Context去处理）
path="/yourContext"的Context获得请求/yourJSPPage.jsp，在它的mapping table中寻找对应的Servlet
Context匹配到URL pattern为*.jsp的Servlet，对应于JspServlet类
构造HttpServletRequest对象和HttpServletResponse对象，作为参数调用JspServlet的doGet或doPost方法（调用什么方法取决于来自客户的HTTP请求是GET请求还是POST请求）
Context把执行完了之后的HttpServletResponse对象返回给Host
Host把HttpServletResponse对象返回给Engine
Engine把HttpServletResponse对象返回给Connector
Connector把HttpServletResponse对象返回给客户的web浏览器

Tomcat Web Application Manager
通过以下方法可以为自己设置一个manager的权限，用来管理web applications，而不用手工修改配置文件。

修改conf/tomcat-user.xml文件，在相应位置加入以下行：

打开Tomcat首页：http://localhost:8080/，进入Administration / Tomcat Manager
Tomcat使用的应该是基于角色（role）的安全管理，在这方面我涉猎不深，有待进一步研究。
Tomcat Installation

从http://jakarta.apache.org/tomcat下载Apache Jakarta Tomcat 5.0.18的zip压缩包
解压缩到某个目录中，比如D:\app\jakarta-tomcat-5.0.18
设置环境变量%CATALINA_HOME%为：D:\app\jakarta-tomcat-5.0.18
进入命令行模式并用以下命令启动Tomcat：
%CATALINA_HOME%\bin\startup.bat
如果在控制台看见信息：Server startup in xxxxx ms，则说明Tomcat已经被启动，它将在端口8080（默认端口）侦听客户请求。
测试：打开浏览器并访问http://localhost:8080/，如果可以看见Tomcat的首页，那么一切正常。
进入命令行模式并用以下命令关闭Tomcat：
%CATALINA_HOME%\bin\shutdown.bat

Tomcat Directory Layout
Tomcat的目录结构如下： Directory Explanation
bin 存放启动和关闭Tomcat的可执行脚本
conf Tomcat的配置文件，如server.xml（Tomcat服务器配置文件）和web.xml（被所有webapps共享的配置文件）
work 存放jsp编译后产生的class文件
webapps 存放web applications，用户自己需要部署的应用程序也要放到此目录
logs 存放日志文件
common 被Tomcat Server本身和所有的web applications共享的库文件（*.jar），如servlet的API就存放在common/lib/servlet-api.jar中
shared 被所有的web applications（但不被Tomcat Server本身）共享的库文件（*.jar）


Tomcat Components

Server : Tomcat Server是整个Catalina JSP/Servlet容器，它是一个单件（Sinleton）。
Service : Service是这样一个集合：它由一个或者多个Connector组成，并拥有一个负责处理所有Connector所获得的客户请求的Engine。
Connector : 一个Connector将在某个指定端口上侦听客户请求，并将获得的请求交给Engine来处理，从Engine处获得回应并返回客户。Tomcat有两个典型的Connector，一个直接侦听来自web浏览器的HTTP请求，一个侦听来自其它WebServer的请求：
Coyote Http/1.1 Connector 在端口8080处侦听来自客户browser的http请求。
Coyote JK2 Connector 在端口8009处侦听来自其它WebServer(Apache)的servlet/jsp代理请求。
Engine : Engine是某个service中的请求处理机，它负责接收和处理来自Connector的请求。Engine下可以配置多个虚拟主机（Virtual Host），每个虚拟主机都有一个域名。当Engine获得一个请求时，它将根据请求中的信息把该请求匹配到某个Host上，然后在该Host配置的环境下处理该请求。Engine有一个默认虚拟主机，当请求无法匹配到任何一个Host上的时候，将交给该默认虚拟主机来处理。
Host : 一个Host代表一个虚拟主机（Virtual Host），每个虚拟主机和某个域名（Domain Name）相匹配。每个虚拟主机下都可以部署（deploy）一个或者多个web applications，每个web application对应于一个Context，并拥有一个Context path。当Host获得一个针对某个特定的Host的请求时，将在该Host的环境下把请求匹配到某个Context上，然后把请求交给该Context来处理。Context的匹配方法是“最长匹配”，所以一个 path="" 的Context将成为该Host的默认Context，所有无法和其它Context的路径名匹配的请求都将最终和该默认Context匹配。
Context : 一个Context对应于一个web application，一个web application由一个或者多个Servlet组成。每个Context在创建的时候都将根据配置文件conf/web.xml和webapps/${webapp.home}/WEB-INF/web.xml载入Servlet类和创建映射表（mapping table）。当Context获得请求时，将在自己的映射表中寻找相匹配的Servlet类。如果找到，则执行该类，获得结果并返回。

Tomcat Server的结构图如下。注意下图只是根据conf/server.xml配置文件画出的结构图，并不保证该图与Tomcat的实现相吻合。


Server Configuration
用户可以通过修改conf/server.xml文件定置Tomcat Server的行为。该文件的描述如下： element attribute explanation
Server port 指定一个端口，这个端口负责监听关闭Tomcat的请求
shutdown 向以上端口发送的关闭服务器的命令字符串
Service name service的名称
Connector port 服务器连接器的端口号，该连接器将在指定端口侦听来自客户端的请求
minProcessors 服务器启动时创建的处理请求的线程数，每个请求由一个线程负责
maxProcessors 最多可以创建的处理请求的线程数
enableLookups 如果为true，则可以通过调用request.getRemoteHost()进行DNS查询来得到远程客户端的实际主机名；若为false则不进行DNS查询，而是返回其ip地址
redirectPort 服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号
acceptCount 当所有可以使用的处理请求的线程都被用光时，可以放到处理队列中的请求数，超过这个数的请求将不予处理，而返回Connection refused错误
connectionTimeout 等待超时的时间数（以毫秒为单位）
Engine defaultHost 缺省的处理请求的虚拟主机名，它至少与其中的一个Host元素的name属性值是一样的
Host name 虚拟主机名
appBase web applications的基本目录
unpackWARs 如果为true，则tomcat会自动将WAR文件解压；否则不解压，直接从WAR文件中运行应用程序
Context docBase web application的文件存放路径或者是WAR文件存放路径
path 表示此web application的URL的前缀，用来匹配一个Context。请求的URL形式为http://localhost:8080/path/*
reloadable 如果为true，则Tomcat将支持热部署，会自动检测web application的/WEB-INF/lib 和/WEB-INF/classes目录的变化，自动装载新的JSP和Servlet，我们可以在不重起Tomcat的情况下改变web application
注：还有一些元素没有介绍，如Logger，Realm，Valve等，是因为暂时我还没有用到这些元素。你可以通过Tomcat的文档获取这些元素的信息。

Web Application Configuration
每个web application对应于某个虚拟主机（Host）下的某个Context。一个web application是若干个HTML，JSP和Servlet文件的集合。当一个web application被初始化的时候，它将用自己的ClassLoader载入“部署配置文件” web.xml 中定义的每个Servlet类和映射表。它首先载入在conf/web.xml中定义的Servlet类和映射表，然后载入位于 webapps/${docBase}/WEB-INF/web.xml 下的自己的部署配置文件中定义的servlet类和映射表。

web.xml文件有两部分：Servlet类定义和映射表定义。每个被载入的Servlet类都有一个名字（不是类名），该名字被填入Context的映射表（mapping table）中，并和某种形式的URL pattern相联系。当某个URL被请求时，将先寻找对应的Host，然后匹配最长的Context，然后查询该Context下的mapping table，找到被请求的Servlet类，并执行之。

分析一下web.xml文件的结构： element sub-element explanation
servlet servlet-name Servlet名字（不是类名，只是一个标识符）
servlet-class Servlet的类名（全称，包括包名，该名用来定位一个Servlet类）
init-param Servlet的初始化参数，每个参数用一个名值对表示：param-name = param-value
servlet-mapping servlet-name Servlet名字，和servlet中的servlet-name相对应
url-pattern URL匹配模式，当请求该模式的URL时，指定Servlet将被调用


分析一下conf/web.xml文件，该文件被所有的web applications共享，其中定义的Servlet类和映射表将被所有的web application载入。 servlet-name url-pattern function
default / 由于对URL进行最长匹配，所以url-pattern为/的该Servlet将在用户的HTTP请求无法匹配任何一个Servlet的时候被调用。该Servlet将返回用户一条错误信息。
invoker /servlet/* 形式为/servlet/FullClassName的URL会和invoker匹配，invoker将根据FullClassName调用${webapp.home}/WEB-INF/classes/FullClassName类，即使该类没有在${webapp.home}/WEB-INF/web.xml中被声明。注意FullClassName必须包含用点分隔的包的全称。
jsp *.jsp, *.jspx 当请求的是一个JSP页面的时候（*.jsp），该Servlet被调用。它实质上是一个JSP编译器，将请求的JSP页面映射成相应的Servlet在执行。当该JSP页面还没有编译的时候，jsp还将完成编译工作。


How Tomcat is Dealing with an HTTP Request
假设来自客户的HTTP请求为：http://localhost:8080/yourContext/yourJSPPage.jsp

请求被发送到本机端口8080，被在那里侦听的Coyote HTTP/1.1 Connector获得
Connector把该请求交给它所在的Service的Engine来处理，并等待来自Engine的回应
Engine获得请求localhost/yourContext/yourJSPPage.jsp，匹配它所拥有的所有虚拟主机Host
Engine匹配到名为localhost的Host（即使匹配不到也把请求交给该Host处理，因为该Host被定义为该Engine的默认主机）
localhost Host获得请求/yourContext/yourJSPPage.jsp，匹配它所拥有的所有Context（最长匹配）
Host匹配到路径为/yourContext的Context（如果匹配不到就把该请求交给路径名为""的Context去处理）
path="/yourContext"的Context获得请求/yourJSPPage.jsp，在它的mapping table中寻找对应的Servlet
Context匹配到URL pattern为*.jsp的Servlet，对应于JspServlet类
构造HttpServletRequest对象和HttpServletResponse对象，作为参数调用JspServlet的doGet或doPost方法（调用什么方法取决于来自客户的HTTP请求是GET请求还是POST请求）
Context把执行完了之后的HttpServletResponse对象返回给Host
Host把HttpServletResponse对象返回给Engine
Engine把HttpServletResponse对象返回给Connector
Connector把HttpServletResponse对象返回给客户的web浏览器

Tomcat Web Application Manager
通过以下方法可以为自己设置一个manager的权限，用来管理web applications，而不用手工修改配置文件。

修改conf/tomcat-user.xml文件，在相应位置加入以下行：

打开Tomcat首页：http://localhost:8080/，进入Administration / Tomcat Manager
Tomcat使用的应该是基于角色（role）的安全管理，在这方面我涉猎不深，有待进一步研究。]]>

posted on 2005-09-20 23:35 Sung 阅读(1049) 评论(0)  编辑  收藏 所属分类: Ｔｏｍｃａｔ