ITEEDU

tomcat配制详解-server.xml详解

概述

项级元素

1. Server：它代表整个容器,是Tomcat实例的顶层元素。子元素Service、GlobalNamingResources。
2. Service：关联一个或多个Connector组件，它们共享同一个处理外来请求的Engine。

连接器

Connector：表示客户端和service之间的连接，代表与客户程序实际交互的组件,它负责接收客户请求,以及向客户返回响应结果。只有两种类型HTTP和AJP。

容器元素

1. Engine：表示指定service中的请求处理机，接收和处理来自Connector的请求。可以包含多个<Host>元素。
2. Context：表示一个web应用程序。
3. Host：表示一个虚拟主机。它包含了一个或多个Web应用。

内嵌组件

1. Listener：定义一个在特定事件发生时执行的组件，一般在Tomcat开启和停止时使用。可以嵌套在Server, Engine, Host或Context元素里。
2. GlobalNamingResources ：为Server定义全局的JNDI数据源。
3. Realm：表示存放用户名，密码及role的数据库。可以嵌套在Engine, Host或Context元素里。
4. Resources：代表web应用的静态数据源。可以嵌套在Context元素里。
5. Logger：表示日志，调试和错误信息。可以嵌套在Engine, Host或Context元素里。
6. Valve：功能与Logger差不多，其prefix和suffix属性解释和Logger 中的一样。可以嵌套在Engine, Host或Context元素里。

总结

一个Server中可以有多个Service，Service定义了请求的处理主体。

请求的接收者是Connector，每个Service可以有多个Connector，接收不同类型不同端口的请求。

请求的处理主体是Engine，在一个Service中只有一个，和Connector平级，Service中定义的Connector都和这个Engine关联，Connector接收的请求都交给Engine处理。

Engine可以定义多个虚拟主机Host，Host可以自动加载指定目录中的WEB应用，也可以手工指定多个WEB应用。WEB应用的定义用Context元素。

内嵌组件可以嵌套在多种元素中，如Logger、Valve可以定义各级别的日志。

server

它代表整个容器,是Tomcat实例的顶层元素。由org.apache.catalina.Server接口来定义.它包含一个或多个<Service>元素，并且它不能做为任何元素的子元素.

<Server port="8005" shutdown="SHUTDOWN" debug="0">

1. port指定Tomcat监听shutdown命令端口.终止服务器运行时,必须在Tomcat服务器所在的机器上发出shutdown命令.该属性是必须的.
2. shutdown指定终止Tomcat服务器运行时,发给Tomcat服务器的shutdown监听端口的字符串.该属性必须设置

service

一个Service元素关联一个或多个Connector组件，它们共享同一个处理外来请求的Engine。

该元素由org.apache.catalina.Service接口定义,它包含一个<Engine>元素,以及一个或多个<Connector>,这些Connector元素共享用同一个Engine元素 。

<Service name="Catalina">
<Service name="Apache">

第一个<Service>处理所有直接由Tomcat服务器接收的web客户请求.

第二个<Service>处理所有由Apahce服务器转发过来的Web客户请求

Connector

表示客户端和service之间的连接，由Connector接口定义。<Connector>元素代表与客户程序实际交互的组件,它负责接收客户请求,以及向客户返回响应结果。

<Connector
 port="8080"
 maxThread="50"
 minSpareThreads="25"
 maxSpareThread="75"
 enableLookups="false"
 redirectPort="8443"
 acceptCount="100"
 debug="0"
 connectionTimeout="20000"
 disableUploadTimeout="true" />

<Connection
 port="8009"
 enableLookups="false"
 redirectPort="8443"
 debug="0"
 protocol="AJP/1.3" />

第一个Connector元素定义了一个HTTP Connector,它通过8080端口接收HTTP请求;第二个Connector元素定义了一个JD Connector,它通过8009端口接收由其它服务器转发过来的请求.

Connector元素常用属性：

1. className指定实现Connector接口的类。
2. enableLookups如果设为true,表示支持域名解析,可以把IP地址解析为主机名.WEB应用中调用request.getRemoteHost方法返回客户机主机名.默认值为true。
3. redirectPort指定转发端口.如果当前端口只支持non-SSL请求,在需要安全通信的场命,将把客户请求转发至SSL的redirectPort端口。
4. port设定Tcp/IP端口,默认值为8080,如果把8080改成80,则只要输入http://localhost即可，因为TCP/IP的默认端口是80。
5. address如果服务器有二个以上ip地址,此属性可以设定端口监听的ip地址.默认情况下,端口会监听服务器上所有的ip地址。
6. bufferSize设定由端口创建的输入流的缓存大小.默认值为2048byte。
7. protocol设定Http协议,默认值为HTTP/1.1。
8. maxThreads设定在监听端口的线程的最大数目,这个值也决定了服务器可以同时响应客户请求的最大数目.默认值为200。
9. acceptCount设定在监听端口队列的最大客户请求数量,默认值为10.如果队列已满,客户必须等待。
10. connectionTimeout定义建立客户连接超时的时间.如果为-1,表示不限制建立客户连接的时间。

Engine

表示指定service中的请求处理机，接收和处理来自Connector的请求。

每个Service元素只能有一个Engine元素.元素处理在同一个<Service>中所有<Connector>元素接收到的客户请求.由org.apahce.catalina.Engine接口定义。

<Engine name="Catalina" defaultHost="localhost" debug="0">

1. defaultHost指定处理客户的默认主机名,在<Engine>中的<Host>子元素中必须定义这一主机
2. name定义Engine的名字。

在<Engine>可以包含如下元素<Logger>, <Realm>, <Value>, <Host>。

Context

表示一个web应用程序，通常为WAR文件，关于WAR的具体信息见servlet规范。

它由Context接口定义.是使用最频繁的元素.每个<Context元素代表了运行在虚拟主机上的单个Web应用.一个<Host>可以包含多个<Context>元素.每个web应用有唯一的一个相对应的Context代表web应用自身.servlet容器为每一个web应用创建一个ServletContext对象.

<Context path="/myweb" docBase="sample" debug="0" reloadbale="true">

1. path指定访问Web应用的URL入口,注意/myweb,而不是myweb了事。
2. reloadable如果这个属性设为true, Tomcat服务器在运行状态下会监视在。WEB-INF/classes和Web-INF/lib目录CLASS文件的改运.如果监视到有class文件被更新,服务器自重新加载Web应用。

在<Context>元素中可以包含如下元素<Logger>, <Realm>, <Resource>, <ResourceParams>。

host

表示一个虚拟主机。

它由Host接口定义。一个Engine元素可以包含多个<Host>元素。每个<Host>的元素定义了一个虚拟主机。它包含了一个或多个Web应用。

<Host name="localhost"
 debug="0"
 appBase="webapps"
 unpackWARs="true"
 autoDeploy="true">

1. appBase指定虚拟主机的目录,可以指定绝对目录,也可以指定相对于<CATALINA_HOME>的相对目录.如果没有此项,默认为<CATALINA_HOME>/webapps
2. unpackWARs如果此项设置为true,表示把WEB应用的WAR文件先展开为开放目录结构后再运行.如果设为false将直接运行为WAR文件

在<Host>元素中可以包含如下子元素<Logger>, <Realm>, <Value>, <Context>

Logger

表示日志，调试和错误信息

Realm

表示存放用户名，密码及role的数据库。

Valve

功能与Logger差不多，其prefix和suffix属性解释和Logger 中的一样