服务器组件

目录

简介

服务器元素表示整个 Catalina servlet 容器。因此,它必须是 conf/server.xml 配置文件中的最外层元素。它的属性表示 servlet 容器整体的特性。

属性

通用属性

所有 服务器实现都支持以下属性

属性 说明
className

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

address

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

port

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

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

portOffset

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

shutdown

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

utilityThreads

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

标准实现

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

属性 说明
utilityThreadsAsDaemon

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

periodicEventDelay

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

嵌套组件

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

特殊功能

Server 没有关联任何特殊功能。