<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
