tomcat server.xml的配备详解
tomcat server.xml 配置详解
|
元素名 |
属性 |
解释 |
|
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
接口来定义
.
它包含一个
<Service> 元素 . 并且它不能做为任何元素的子元素 .
<
Server
port
="8005"
shutdown
="SHUTDOWN"
debug
="0">
1>className
指定实现
org.apache.catalina.Server
接口的类
.
默认值为
org.apache.catalina.core.StandardServer
2>port
指定
Tomcat
监听
shutdown
命令端口
.
终止服务器运行时
,
必须在
Tomcat
服务器所在的机器上发出
shutdown
命令
.
该属性是必须的
.
3>shutdown
指定终止
Tomcat
服务器运行时
,
发给
Tomcat
服务器的
shutdown
监听端口的字符串
.
该属性必须设
置
<Service> 元素
该元素由
org.apache.catalina.Service
接口定义
,
它包含一个
<Engine>
元素
,
以及一个或多个
<Connector>,
这些
Connector
元素共享用同一个
Engine
元素
<
Service
name
="Catalina">
<
Service
name
="Apache">
第一个
<Service>
处理所有直接由
Tomcat
服务器接收的
web
客户请求
.
第二个
<Service>
处理所有由
Apahce
服务器转发过来的
Web
客户请求
1>className
指定实现
org.apahce.catalina.Service
接口的类
.
默认为
org.apahce.catalina.core.StandardService
2>name
定义
Service
的名字
<Engine> 元素
每个
Service
元素只能有一个
Engine
元素
.
元素处理在同一个
<Service>
中所有
<Connector>
元素接收到的客
户请求 . 由 org.apahce.catalina.Engine 接口定义 .
<
Engine
name
="Catalina"
defaultHost
="localhost"
debug
="0">
1>className
指定实现
Engine
接口的类
,
默认值为
StandardEngine
2>defaultHost
指定处理客户的默认主机名
,
在
<Engine>
中的
<Host>
子元素中必须定义这一主机
3>name
定义
Engine
的名字
在
<Engine>
可以包含如下元素
<Logger>, <Realm>, <Value>,
<Host>
<Host> 元素
它由
Host
接口定义
.
一个
Engine
元素可以包含多个
<Host>
元素
.
每个
<Host>
的元素定义了一个虚拟主机
.
它
包含了一个或多个 Web 应用 .
<
Host
name
="localhost"
debug
="0"
appBase
="webapps"
unpackWARs
="true"
autoDeploy
="true">
1>className
指定实现
Host
接口的类
.
默认值为
StandardHost
2>appBase
指定虚拟主机的目录
,
可以指定绝对目录
,
也可以指定相对于
<CATALINA_HOME>
的相对目录
.
如果
没有此项
,
默认为
<CATALINA_HOME>/webapps
3>autoDeploy
如果此项设为
true,
表示
Tomcat
服务处于运行状态时
,
能够监测
appBase
下的文件
,
如果有新有
web
应用加入进来
,
会自运发布这个
WEB
应用
4>unpackWARs
如果此项设置为
true,
表示把
WEB
应用的
WAR
文件先展开为开放目录结构后再运行
.
如果设为
false
将直接运行为
WAR
文件
5>alias
指定主机别名
,
可以指定多个别名
6>deployOnStartup
如果此项设为
true,
表示
Tomcat
服务器启动时会自动发布
appBase
目录下所有的
Web
应用
.
如果
Web
应用中的
server.xml
没有相应的
<Context>
元素
,
将采用
Tomcat
默认的
Context
7>name
定义虚拟主机的名字
在
<Host>
元素中可以包含如下子元素
<Logger>, <Realm>, <Value>, <Context>
<Context> 元素
它由
Context
接口定义
.
是使用最频繁的元素
.
每个
<Context
元素代表了运行在虚拟主机上的单个
Web
应用
.
一个
<Host>
可以包含多个
<Context>
元素
.
每个
web
应用有唯一
的一个相对应的
Context
代表
web
应用自身
.servlet
容器为第一个
web
应用创建一个
ServletContext
对象
.
<
Context
path
="/sample"
docBase
="sample"
debug
="0"
reloadbale
="true">
1>className
指定实现
Context
的类
,
默认为
StandardContext
类
2>path
指定访问
Web
应用的
URL
入口
,
注意
/myweb,
而不是
myweb
了事
3>reloadable
如果这个属性设为
true, Tomcat
服务器在运行状态下会监视在
WEB-INF/classes
和
Web-
INF/lib
目录
CLASS
文件的改运
.
如果监视到有
class
文件被更新
,
服务器自重新加载
Web
应用
3>cookies
指定是否通过
Cookies
来支持
Session,
默认值为
true
4>useNaming
指定是否支持
JNDI,
默认值为了
true
在
<Context>
元素中可以包含如下元素
<Logger>, <Realm>, <Resource>, <ResourceParams>
<Connector> 元素
由
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
端口
HttpConnector
元素的属性
1>className
实现
Connector
的类
2>port
设定
Tcp/IP
端口
,
默认值为
8080,
如果把
8080
改成
80,
则只要输入
http://localhost
即可
因为
TCP/IP
的默认端口是
80
3>address
如果服务器有二个以上
ip
地址
,
此属性可以设定端口监听的
ip
地址
.
默认情况下
,
端口会监听服务
器上所有的
ip
地址
4>bufferSize
设定由端口创建的输入流的缓存大小
.
默认值为
2048byte
5>protocol
设定
Http
协议
,
默认值为
HTTP/1.1
6>maxThreads
设定在监听端口的线程的最大数目
,
这个值也决定了服务器可以同时响应客户请求的最大数
目
.
默认值为
200
7>acceptCount
设定在监听端口队列的最大客户请求数量
,
默认值为
10.
如果队列已满
,
客户必须等待
.
8>connectionTimeout
定义建立客户连接超时的时间
.
如果为
-1,
表示不限制建立客户连接的时间
JkConnector
的属性
1>className
实现
Connector
的类
2>port
设定
AJP
端口号
3>protocol
必须设定为
AJP/1.3
========================================================================================
<Server>
元素
它代表整个容器
,
是
Tomcat
实例的顶层元素
.
由
org.apache.catalina.Server
接口来定义
.
它包含一个
<Service>
元素
.
并且它不能做为任何元素的子元素
.
<Server port="8005" shutdown="SHUTDOWN" debug="0">
1>
className
指定实现
org.apache.catalina.Server
接口的类
.
默认值为
org.apache.catalina.core.StandardServer
2>
port
指定
Tomcat
监听
shutdown
命令端口
.
终止服务器运行时
,
必须在
Tomcat
服务器所在的机器上发出
shutdown
命令
.
该属性是必须的
.
3>
shutdown
指定终止
Tomcat
服务器运行时
,
发给
Tomcat
服务器的
shutdown
监听端口的字符串
.
该属性必须设置
<Service>
元素
该元素由
org.apache.catalina.Service
接口定义
,
它包含一个
<Engine>
元素
,
以及一个或多个
<Connector>,
这些
Connector
元素共享用同一个
Engine
元素
<Service name="Catalina">
<Service name="Apache">
第一个
<Service>
处理所有直接由
Tomcat
服务器接收的
web
客户请求
.
第二个
<Service>
处理所有由
Apahce
服务器转发过来的
Web
客户请求
1>
className
指定实现
org.apahce.catalina.Service
接口的类
.
默认为
org.apahce.catalina.core.StandardService
2>
name
定义
Service
的名字
<Engine>
元素
每个
Service
元素只能有一个
Engine
元素
.
元素处理在同一个
<Service>
中所有
<Connector>
元素接收到的客户请求
.
由
org.apahce.catalina.Engine
接口定义
.
<Engine name="Catalina" defaultHost="localhost" debug="0">
1>
className
指定实现
Engine
接口的类
,
默认值为
StandardEngine
2>
defaultHost
指定处理客户的默认主机名
,
在
<Engine>
中的
<Host>
子元素中必须定义这一主机
3>
name
定义
Engine
的名字
在 <Engine> 可以包含如下元素 <Logger>, <Realm>, <Value>, <Host>
<Host>
元素
它由
Host
接口定义
.
一个
Engine
元素可以包含多个
<Host>
元素
.
每个
<Host>
的元素定义了一个虚拟主机
.
它包含了一个或多个
Web
应用
.
<Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" autoDeploy="true">
1>
className
指定实现
Host
接口的类
.
默认值为
StandardHost
2>
appBase
指定虚拟主机的目录
,
可以指定绝对目录
,
也可以指定相对于
<CATALINA_HOME>
的相对目录
.
如果没有此项
,
默认为
<CATALINA_HOME>/webapps
3>
autoDeploy
如果此项设为
true,
表示
Tomcat
服务处于运行状态时
,
能够监测
appBase
下的文件
,
如果有新有
web
应用加入进来
,
会自运发布这个
WEB
应用
4>
unpackWARs
如果此项设置为
true,
表示把
WEB
应用的
WAR
文件先展开为开放目录结构后再运行
.
如果设为
false
将直接运行为
WAR
文件
5>
alias
指定主机别名
,
可以指定多个别名
6>
deployOnStartup
如果此项设为
true,
表示
Tomcat
服务器启动时会自动发布
appBase
目录下所有的
Web
应用
.
如果
Web
应用中的
server.xml
没有相应的
<Context>
元素
,
将采用
Tomcat
默认的
Context
7>
name
定义虚拟主机的名字
在
<Host>
元素中可以包含如下子元素
<Logger>, <Realm>, <Value>, <Context>
<Context>
元素
它由
Context
接口定义
.
是使用最频繁的元素
.
每个
<Context
元素代表了运行在虚拟主机上的单个
Web
应用
.
一个
<Host>
可以包含多个
<Context>
元素
.
每个
web
应用有唯一
的一个相对应的
Context
代表
web
应用自身
.servlet
容器为第一个
web
应用创建一个
ServletContext
对象
.
<Context path="/sample" docBase="sample" debug="0" reloadbale="true">
1>
className
指定实现
Context
的类
,
默认为
StandardContext
类
2>
path
指定访问
Web
应用的
URL
入口
,
注意
/myweb,
而不是
myweb
了事
3>
reloadable
如果这个属性设为
true, Tomcat
服务器在运行状态下会监视在
WEB-INF/classes
和
Web-INF/lib
目录
CLASS
文件的改运
.
如果监视到有
class
文件被更新
,
服务器自重新加载
Web
应用
3>
cookies
指定是否通过
Cookies
来支持
Session,
默认值为
true
4>
useNaming
指定是否支持
JNDI,
默认值为了
true
在
<Context>
元素中可以包含如下元素
<Logger>, <Realm>, <Resource>, <ResourceParams>
Connector
元素
由
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
端口
HttpConnector
元素的属性
1>
className
实现
Connector
的类
2>
port
设定
Tcp/IP
端口
,
默认值为
8080,
如果把
8080
改成
80,
则只要输入
http://localhost
即可
因为
TCP/IP
的默认端口是
80
3>
address
如果服务器有二个以上
ip
地址
,
此属性可以设定端口监听的
ip
地址
.
默认情况下
,
端口会监听服务器上所有的
ip
地址
4>
bufferSize
设定由端口创建的输入流的缓存大小
.
默认值为
2048byte
5>
protocol
设定
Http
协议
,
默认值为
HTTP/1.1
6>
maxThreads
设定在监听端口的线程的最大数目
,
这个值也决定了服务器可以同时响应客户请求的最大数目
.
默认值为
200
7>
acceptCount
设定在监听端口队列的最大客户请求数量
,
默认值为
10.
如果队列已满
,
客户必须等待
.
8>
connectionTimeout
定义建立客户连接超时的时间
.
如果为
-1,
表示不限制建立客户连接的时间
JkConnector
的属性
1>
className
实现
Connector
的类
2>
port
设定
AJP
端口号
3>
protocol
必须设定为
AJP/1.3