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
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
