Tomcat 配置之 server.xml
本文将介绍Tomcat中主要的配置文件server.xml的一些标签及其含义
Tomcat隶属于Apache基金会,是开源的轻量级Web应用服务器,使用非常广泛。server.xml是Tomcat中最重要的配置文件,server.xml的每一个元素都对应了Tomcat中的一个组件;通过对xml文件中元素的配置,可以实现对Tomcat中各个组件的控制。因此,学习server.xml文件的配置,对于了解和使用Tomcat至关重要。
安装好tomcat后,在conf目录下的server.xml默认会有一些配置
<Server port="8005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.startup.VersionLoggerListener" />
<Listener SSLEngine="on"
className="org.apache.catalina.core.AprLifecycleListener" />
<Listener className="org.apache.catalina.core.JasperListener" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />
<GlobalNamingResources>
<Resource auth="Container" description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory" name="UserDatabase"
pathname="conf/tomcat-users.xml" type="org.apache.catalina.UserDatabase" />
</GlobalNamingResources>
<Service name="Catalina">
<Connector URIEncoding="UTF-8" connectionTimeout="20000"
port="80" protocol="HTTP/1.1" redirectPort="8443" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
<Engine defaultHost="localhost" name="Catalina">
<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm"
resourceName="UserDatabase" />
</Realm>
<Host appBase="webapps" autoDeploy="true" name="localhost"
unpackWARs="true">
<Valve className="org.apache.catalina.valves.AccessLogValve"
directory="logs" pattern="%h %l %u %t "%r" %s %b" prefix="localhost_access_log."
suffix=".txt" />
</Host>
</Engine>
</Service>
以上的就是我们要逐一介绍的节点
Server节点
描述:Server代表一个Tomcat实例(一个JVM)所以server.xml中唯一一个最外层的元素(唯一)
功能:提供接口让客户端能访问Server包含的Service,维护各个Service的生命周期等。
属性:
- port: 指定端口监听关闭tomcat的请求,设为-1可以禁掉该端口。
- shutdown: 关闭tomcat的发送的字符串
Service
描述:一个Server节点可以包含多个Service节点。不同的Service所监听的端口必须是不能重复的。
功能:一个Service可以理解为Engine和Connector的容器。每个Connector通过一个特定的端口和协议接收入站请求交将其转发至关联的Engine进行处理。
属性:
- name:指定service 的名字
会默认生成一个名为Catalina的Service
Service包含Connector和Engine两个节点。
Connector
描述:一个Service可以包含多个Connector,Connector有多种类型
- HTTP连接器
- SSL连接器
- AJP 1.3连接器
- proxy连接器
他用来表示客户端和service之间的连接。
HTTP connector 示例:
<Connector port="8080" protocol="HTTP/1.1"
maxThreads="150" connectionTimeout="20000"
redirectPort="8443" URIEncoding="UTF-8"/>
SSL connector 示例:
<Connector port="8443"
maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
enableLookups="false" acceptCount="100" debug="0" scheme="https" secure="true"
clientAuth="false" sslProtocol="TLS" />
AJP connector 示例:
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />
在默认的Service中包含两个Connector:
分别是
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"redirectPort="8443"/>
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>
此时Tomcat监听的HTTP请求,协议是HTTP/1.1,端口是8080,转发HTTPS请求到8443端口。
配置<Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>
客户端就可以通过8009端口使用AJP协议访问tomcat。
AJP协议:
AJP协议负责和其他http服务器建立连接,把tomcat服务器和其他http服务器连接时,就需要这个,之所以使用Tomcat和其他服务器集成,是因为Tomcat可以用作Servlet/JSP容器,但是对静态资源的处理速度较慢,不如Apache和IIS等HTTP服务器;因此常常将Tomcat与Apache等集成,前者作Servlet容器,后者处理静态资源,而AJP协议便负责Tomcat和Apache的连接
功能:接收连接请求,创建Request和Response对象用于和请求端交换数据,然后分配线程让Engine处理请求并把Request和Response对象传递给Engine
主要属性属性:
- port 指定服务器要创建的端口号,并在改端口监听客户端的请求。
- minProcessors 服务启动时创建处理请求的线程数目。
- maxProcessors 最大可创建的处理请求线程数目。
- enableLookups true:进行DNS查询得到远程客户端的实际主机名 false不进行查询。s
- redirectPort 如果某连接器支持的协议是HTTP,当接收客户端发来的HTTPS请求时,则转发至此属性定义的端口
- connectionTimeout 等待客户端发送请求的超时时间,单位为毫秒,默认为60000,即1分钟;
Engine
描述:一个Service 对应一个Engine。
功能:一个Engine�从一个或者多个Connector中接收请求并处理,并将完成的响应返回给Connector。
主要属性:
- defaultHost 默认host的名字。
- name 用于日志和错误信息,在Server中唯一
- startStopThreads 该Engine启动子Host默认开启的线程
Host
描述:一个Engine对应多个Host ,每个�Host代表Engine的一个虚拟主机。Host组件至少有一个,且其中一个的name必须与Engine组件的defaultHost属性相匹配。
功能:运用来运行多个web应用,负责�Web应用的生命周期。
tip: 虚拟主机是一种在一个web服务器上服务多个域名的机制,对每个域名而言,都好象独享了整个主机。实际上,大多数的小型商务网站都是采用虚拟主机实现的,这主要是因为虚拟主机能直接连接到Internet并提供相应的带宽,以保障合理的访问响应速度,另外虚拟主机还能提供一个稳定的固定IP。
主要属性:
- name 指定虚拟主机的主机名
- unpackWARs 是否将war文件解压,true为运行解压war文件后灯文件夹,false直接运行war文件。
- autoDeploy 是否自动部署
- appBase �此虚拟Host的WebApp存放路径。
若只配置appBase,不配Context 的docBase(appBase和docBase二选一就可以了),则appBase的每个文件夹里都代表一个应用.这个目录下面的.war文件将被自动解压缩并部署为应用。
Context
描述:一个Host可以对应多个Context,Context表示在特定的虚拟主机�上运行的一个Web�应用。
功能:
主要属性:
- path 指定Web应用的URL入口 (多指项目名)
- docBase 指定Web应用的文件路径,可以是绝对路径,也可以是相对路径(相对该Context所在的Host的appBase属性值)
- reloadable 若此属性为true,tomcat在运行状态下回监视WEB-INF/classes和WEB-INF/lib目录下class的文件改动,若有文件更新服务器会重载Web应用
例子:在默认Host标签中添加Context
<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".txt"
pattern="%h %l %u %t "%r" %s %b"/>
<Context path="/test" reloadable="true" docBase="/Users/WLW/tomcat/webapps2">
</Context>
</Host>
在/Users/WLW/tomcat/webapps2
下创建test.html。
访问http://localhost:8080/test/test.html