Tomcat隶属于Apache基金会,是开源的轻量级Web应用服务器,使用非常广泛。server.xml是Tomcat中最重要的配置文件,server.xml的每一个元素都对应了Tomcat中的一个组件;通过对xml文件中元素的配置,可以实现对Tomcat中各个组件的控制。因此,学习server.xml文件的配置,对于了解和使用Tomcat至关重要。
元素名 | 属性 | 解释 | |
---|---|---|---|
server | port | 指定一个端口,这个端口负责监听关闭tomcat 的请求 | |
shutdown | 指定向端口发送的命令字符串 | ||
service | name | 指定service 的名字 | |
Connector ( 表示客户端和service 之间的连接) | port | 指定服务器端要创建的端口号,并在这个断口监听来自客户端的请求 | |
minProcessors | 服务器启动时创建的处理请求的线程数 | ||
maxProcessors | 最大可以创建的处理请求的线程数 | ||
enableLookups | 如果为true ,则可以通过调用request.getRemoteHost() 进行DNS查询来得到远程客户端的实际主机名,若为false 则不进行DNS 查询,而是返回其ip 地址 | ||
redirectPort | 指定服务器正在处理http 请求时收到了一个SSL 传输请求后重定向的端口号 | ||
acceptCount | 指定当所有可以使用的处理请求的线程数都被使用时,可以放到处理队列中的请求数,超过这个数的请求将不予处理 | ||
connectionTimeout | 指定超时的时间数( 以毫秒为单位) | ||
Engine ( 表示指定service 中的请求处理机,接收和处理来自Connector 的请求) | defaultHost | 指定缺省的处理请求的主机名,它至少与其中的一个host 元素的name 属性值是一样的 | |
Context ( 表示一个web 应用程序,通常为WAR 文件,关于WAR的具体信息见servlet规范) | docBase | 应用程序的路径或者是WAR 文件存放的路径 | |
path | 表示此web 应用程序的url 的前缀,这样请求的url 为http://localhost:8080/path/ ** | ||
reloadable | 这个属性非常重要,如果为true ,则tomcat 会自动检测应用程序的/WEB-INF/lib 和/WEB-INF/classes 目录的变化,自动装载新的应用程序,我们可以在不重起tomcat 的情况下改变应用程序 | ||
host ( 表示一个虚拟主机 ) | name | 指定主机名 | |
appBase | 应用程序基本目录,即存放应用程序的目录 | ||
unpackWARs | 如果为true ,则tomcat 会自动将WAR 文件解压,否则不解压,直接从WAR 文件中运行应用程序 | ||
Logger ( 表示日志,调试和错误信息) | className | 指定logger 使用的类名,此类必须实现org.apache.catalina.Logger 接口 | |
prefix | 指定log 文件的前缀 | ||
suffix | 指定log 文件的后缀 | ||
timestamp | 如果为true ,则log 文件名中要加入时间,如下例:localhost_log.2001-10-04.txt | ||
Realm ( 表示存放用户名,密码及role 的数据库) | className | 指定Realm 使用的类名,此类必须实现org.apache.catalina.Realm接口 | |
Valve ( 功能与Logger 差不多,其prefix 和suffix 属性解释和Logger 中的一样) | className | 指定Valve 使用的类名,如用org.apache.catalina.valves.AccessLogValve 类可以记录应用程序的访问信息 | |
directory | 指定log 文件存放的位置 | ||
pattern | 有两个值,common 方式记录远程主机名或ip 地址,用户名,日期,第一行请求的字符串,HTTP 响应代码,发送的字节数。combined 方式比common 方式记录的值更多 |
Server元素
它代表整个容器,是Tomcat实例的顶层元素.由org.apache.catalina.Server接口来定义.它包含一个
1 | < Server port ="8005" shutdown ="SHUTDOWN" debug ="0" > |
1 | 1>className指定实现org.apache.catalina.Server接口的类.默认值为org.apache.catalina.core.StandardServer |
Service元素
该元素由org.apache.catalina.Service接口定义,它包含一个
元素,以及一个或多个 ,这些Connector元素共享用同一个Engine元素
1 | < Service name ="Catalina" > |
1 | 第一个<Service>处理所有直接由Tomcat服务器接收的web客户请求. |
1 | 1>className 指定实现org.apahce.catalina.Service接口的类.默认为org.apahce.catalina.core.StandardService |
Engine元素
每个Service元素只能有一个Engine元素.元素处理在同一个
中所有 元素接收到的客户请求.由org.apahce.catalina.Engine接口定义
1 | < Engine name ="Catalina" defaultHost ="localhost" debug ="0" > |
1 | 1>className指定实现Engine接口的类,默认值为StandardEngine |
Host元素
它由Host接口定义.一个Engine元素可以包含多个
元素.每个 的元素定义了一个虚拟主机.它包含了一个或多个Web应用
1 | < Host name ="localhost" debug ="0" appBase ="webapps" unpackWARs ="true"autoDeploy ="true" > |
1 | 1>className指定实现Host接口的类.默认值为StandardHost |
Context元素
它由Context接口定义.是使用最频繁的元素.每个<Context元素代表了运行在虚拟主机上的单个Web应用.一个
可以包含多个 元素.每个web应用有唯一的一个相对应的Context代表web应用自身.servlet容器为第一个web应用创建一个ServletContext对象
1 | < Context path ="/sample" docBase ="sample" debug ="0" reloadbale ="true" > |
1 | 1>className指定实现Context的类,默认为StandardContext类 |
Connector元素
由Connector接口定义.
元素代表与客户程序实际交互的给件,它负责接收客户请求,以及向客户返回响应结果.
1 | < Connector port ="8080" maxThread ="50" minSpareThreads ="25" maxSpareThread ="75" |
第一个Connector元素定义了一个HTTP Connector,它通过8080端口接收HTTP请求;第二个Connector元素定义了一个JD Connector,它通过8009端口接收由其它服务器转发过来的请求
Connector元素共用属性
1 | 1>className指定实现Connector接口的类 |
HttpConnector元素的属性
1 | 1>className实现Connector的类 |
JkConnector的属性
1 | 1>className实现Connector的类 |