服务器组件

目录

简介

一个 Server 元素代表整个 Catalina Servlet 容器。因此,它必须是 conf/server.xml 配置文件中唯一的、最外层的元素。它的属性代表了整个 Servlet 容器的特性。

属性

常用属性

所有 Server 实现都支持以下属性

属性描述
className

要使用的实现的 Java 类名。此类的实现必须符合 org.apache.catalina.Server 接口。如果未指定类名,将使用标准实现。

address

此服务器等待关机命令的 TCP/IP 地址。如果未指定地址,则使用 localhost

port

此服务器等待关机命令的 TCP/IP 端口号。设置为 -1 可禁用关机端口。

注意:当使用 Apache Commons Daemon 启动 Tomcat(在 Windows 上作为服务运行或在 un*x 系统上使用 jsvc 运行)时,禁用关机端口效果很好。但是,当使用标准 shell 脚本运行 Tomcat 时,不能使用此功能,因为它将阻止 shutdown.bat|.sh 和 catalina.bat|.sh 正常停止 Tomcat。

portOffset

应用于 port 以及任何嵌套连接器端口的偏移量。它必须是一个非负整数。如果未指定,则使用默认值 0

shutdown

必须通过 TCP/IP 连接到指定端口号才能接收到的用于关闭 Tomcat 的命令字符串。

utilityThreads

Service 用于各种实用任务(包括周期性任务)的线程数。特殊值 0 将导致使用 Runtime.getRuntime().availableProcessors() 的值。负值将导致使用 Runtime.getRuntime().availableProcessors() + value,除非结果小于 1,在这种情况下将使用 1 个线程。默认值为 1。

标准实现

Server 的标准实现是 org.apache.catalina.core.StandardServer。它支持以下附加属性(除了上面列出的常用属性):

属性描述
utilityThreadsAsDaemon

为实用线程设置守护程序标志值。默认值为 false

periodicEventDelay

此值表示在此 Server 上配置的生命周期监听器的周期性生命周期事件调用之间的延迟(以秒为单位)。该值以秒为单位,负值或零值将禁用调用。如果未指定,此属性的默认值为 10 秒。

嵌套组件

以下组件可以嵌套在 Server 元素内部:

特殊功能

没有与 Server 相关的特殊功能。