转自（http://heavyz.sourceforge.net/homepage/homepage_zh/comp/notes/tomcat-5.0.html），本人仅为学习，如果侵犯作者的利益，请通知我立马删除。

Tomcat 5.0 安装和配置记录

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

Tomcat Installation

 

1. 从http://jakarta.apache.org/tomcat下载Apache Jakarta Tomcat 5.0.18的zip压缩包
2. 解压缩到某个目录中，比如D:/app/jakarta-tomcat-5.0.18
3. 设置环境变量%CATALINA_HOME%为：D:/app/jakarta-tomcat-5.0.18
4. 进入命令行模式并用以下命令启动Tomcat：

   %CATALINA_HOME%/bin/startup.bat
   
             

   如果在控制台看见信息：Server startup in xxxxx ms，则说明Tomcat已经被启动，它将在端口8080（默认端口）侦听客户请求。
5. 测试：打开浏览器并访问http://localhost:8080，如果可以看见Tomcat的首页，那么一切正常。
6. 进入命令行模式并用以下命令关闭Tomcat：

   %CATALINA_HOME%/bin/shutdown.bat
   
             

Tomcat Directory Layout

Tomcat的目录结构如下：

Directory Explanation bin存放启动和关闭Tomcat的可执行脚本confTomcat的配置文件，如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下可以配置多个虚拟主机（VirtualHost），每个虚拟主机都有一个域名。当Engine获得一个请求时，它将根据请求中的信息把该请求匹配到某个Host上，然后在该Host配置的环境下处理该请求。Engine有一个默认虚拟主机，当请求无法匹配到任何一个Host上的时候，将交给该默认虚拟主机来处理。
• Host : 一个Host代表一个虚拟主机（Virtual Host），每个虚拟主机和某个域名（DomainName）相匹配。每个虚拟主机下都可以部署（deploy）一个或者多个web applications，每个webapplication对应于一个Context，并拥有一个Contextpath。当Host获得一个针对某个特定的Host的请求时，将在该Host的环境下把请求匹配到某个Context上，然后把请求交给该Context来处理。Context的匹配方法是“最长匹配”，所以一个 path=""的Context将成为该Host的默认Context，所有无法和其它Context的路径名匹配的请求都将最终和该默认Context匹配。
• Context : 一个Context对应于一个web application，一个webapplication由一个或者多个Servlet组成。每个Context在创建的时候都将根据配置文件conf/web.xml和webapps/${webapp.home}/WEB-INF/web.xml载入Servlet类和创建映射表（mappingtable）。当Context获得请求时，将在自己的映射表中寻找相匹配的Servlet类。如果找到，则执行该类，获得结果并返回。

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

Server Configuration

用户可以通过修改conf/server.xml文件定置Tomcat Server的行为。该文件的描述如下：

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

Web Application Configuration

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

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

分析一下web.xml文件的结构：

element sub-element explanation servletservlet-nameServlet名字（不是类名，只是一个标识符）servlet-classServlet的类名（全称，包括包名，该名用来定位一个Servlet类）init-paramServlet的初始化参数，每个参数用一个名值对表示：param-name = param-valueservlet-mappingservlet-nameServlet名字，和servlet中的servlet-name相对应url-patternURL匹配模式，当请求该模式的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

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

Tomcat Web Application Manager

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

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

   <user name="heavyz" password="heavyz" roles="standard,manager"/>
   
             

2. 打开Tomcat首页：http://localhost:8080，进入Administration / Tomcat Manager

Tomcat使用的应该是基于角色（role）的安全管理，在这方面我涉猎不深，有待进一步研究。

 

Fixme (heavyz)

To be learnt and added...

References

 

• Apache Jakarta Tomcat : http://jakarta.apache.org/tomcat
• Tomcat全攻略，宗锋，西北大学计算机系硕士，2001-12
• heavyz的Tomcat学习笔记，heavyz，2003-05-21