Tomcat的配置文件 —— server.xml

Server.xml包含的元素有<Server>、<Service>、<Connector>、<Engine>、<Host>、<Context>、<logger>、<Value>、<Realm>等，它们可分为四大类：

1、顶层类元素：有<Server>和<Service>。它位于整个配置文件的顶层。

2、连接器类元素：有<Connector>。客户和容器类元素的通讯接口。

3、容器类元素：有<Engine>、<Host>和<Context>。处理客户请求并且生成响应结果。

4、嵌套类元素：有<logger>、<Value>和<Realm>。可以加入到容器中的元素

配置文件结构为：
<server>

              <service>

                            <connector/>

                            <connector/>

                            <engine>

                                                 <host>

                                                               <context/>

                                                 </host>

                                                 <host>

                                                               <context/>

                                                               <context/>

                                                 </host>

                            </engine>

              </service>

<server>

 

<Server>元素

<Server>是Tomcat实例的顶层元素，由org.apache.catalina.Server接口定义，它可以包含一个或多个<Service>元素，并且不能做为任何元素的子元素。一个<Server>是一个提供完整JVM的独立组件，它可以代表整个容器，但它本身不是一个容器，不可以定义<value>或<loggers>之类的子组件。

 

属性说明：

属性	说明
port	指定一个端口，这个端口负责监听关闭Tomcat的请求
shut down	向以上端口发送的关闭服务器的命令字符串，通常为“SHUTDOWN”

 

对于一个已经开启的tomcat服务器，可以在cmd下使用telnet localhost 8005命令进行连接，然后输入“SHUTDOWN” 命令就可以关闭服务器。

 

 

<Service>元素

Service是一个集合，它由一个或者多个Connector以及一个Engine组成，这个Engine负责处理所有Connector所获得的客户请求。每个Service元素只能有一个Engine元素。Service本身也不是容器。

 

属性说明：

属性	说明
name	Service的名称

 

<Connector>元素

<Connector>是直接与用户交互的组件，负责接受用户请求和向客户返回响应结果。

 

属性说明：

属性	说明
port	Connector所监听的端口。在浏览器中可以通过输入url:port的方式提交给对应的Connector。因为浏览器的默认端口是80，所以如果把Connector的port设成80的话，可以直接使用url进行访问，不用在后边再跟一个端口号。
protocol	设定Http协议，默认是HTTP/1.1
minThreads	服务器启动时创建的处理用户请求的线程数
maxThreads	可以创建的最大的处理用户请求的线程数
minSpareThreads	最小备用线程数
maxSpareThreads	最大备用线程数
acceptCount	当所有可以使用的处理请求的线程都被用光时,可以放到处理队列中的请求数,超过这个数的请求将不予处理，而返回Connection refused错误。
redirectPort	服务器正在处理http请求时收到了一个SSL传输请求后重定向的端口号。（即当请求是https时，将它转发到的端口）
enableLookups	如果为true，表示支持域名解析，则可以在web应用中通过调用request.getRemoteHost()进行DNS查询来得到远程客户端的实际主机名；若为false则不进行DNS 查询，而是返回其ip地址。默认值为true。
connectionTimeout	等待超时的时间数（以毫秒为单位），如果为-1表示不限制客户连接的时间。

 

 

<Engine>元素

它处理在同一个<Service>中所有<Connector>元素接收到的客户请求。它匹配请求和自己的虚拟主机，并将请求发给对应的<Host>处理，默认的主机是localhost。

 

属性说明：

属性	说明
name	engine的名称，对应目录 /conf /Catalina
defaultHost	默认的处理请求的虚拟主机，至少与下面一个Host的name属性一样。对应 /conf /Catalina /localhost
Debug	日志等级。

 

<Host>元素

一个<Engine>元素可以包含多个<Host>元素，每个<Host>的元素定义一个虚拟主机，它包含一个或多个web应用。

 

属性说明：

属性	说明
name	虚拟主机名，对应目录 /conf /Catalina /localhost
appBase	指定虚拟主机的目录，默认为/webapps。它将请求url与该虚拟主机的context进行匹配，并把请求转给对应的context来处理。
Debug	日志等级。
autoDeploy	默认为true，表示如果有新的WEB应用放入appBase并且Tomcat在运行的情况下，自动载入应用。
unpackWARs	如果设置为true，表示把war文件先展开再运行。如果为false则直接运行war文件。

 

<Context>元素

代表运行在虚拟主机上的单个web应用。一个<Host>可以包含多个<Context>元素。每个web应用有唯一个相对应的Context代表web应用自身。

 

属性说明：

属性	说明
path	Web应用名，在使用url访问host下的web应用时，通过http://localhst/ website 的形式。其中localhost为上文所说的host的name，而website就是这里的path。 也就是说当一具请求到来时，engine先根据host name = localhost来确定所要求的主机，再根据context path = website确定用户所请求的web应用。
docBase	Web应用的具体存放路径
Debug	日志等级。
autoDeploy	默认为true，表示如果有新的WEB应用放入appBase并且Tomcat在运行的情况下，自动载入应用。
unpackWARs	如果设置为true，表示把war文件先展开再运行。如果为false则直接运行war文件。