Service 组件

目录

简介

一个 Service 元素表示一个或多个 Connector 组件的组合,这些组件共享单个 Engine 组件以处理传入请求。一个或多个 Service 元素可以嵌套在 Server 元素内部。

属性

通用属性

所有 Service 的实现都支持以下属性

属性描述
className

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

name

Service 的显示名称,如果您使用标准 Catalina 组件,此名称将包含在日志消息中。与特定 Server 关联的每个 Service 的名称必须是唯一的。

标准实现

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

属性描述
gracefulStopAwaitMillis

停止 Service 时,等待客户端连接完成处理并关闭的时间(以毫秒为单位),在此之后 Service 的容器层次结构才会被停止。此等待仅适用于 bindOnInit 值为 false(非默认值)的连接器。任何小于或等于零的值表示不等待。如果未指定,将使用默认值零。

嵌套组件

唯一可以嵌套在 Service 元素内部的组件是一个或多个 Connector 元素,后跟且仅跟一个 Engine 元素。

特殊功能

没有与 Service 关联的特殊功能。