HTTP 端点的配置属性。
Name | Type | Default | Description |
---|---|---|---|
id | 字符串 | 唯一配置标识。 | |
onError |
| WARN | 启动端点失败时要执行的操作。 IGNORE 服务器在发生配置错误时将不会发出警告和错误消息。 WARN 服务器在发生配置错误时将发出警告和错误消息。 FAIL 服务器在第一次发生错误时将发出警告或错误消息,然后停止服务器。 |
enabled | 布尔型 | true | 切换端点的可用性。值为 true 时,分派器将激活此端点以处理 HTTP 请求。 |
host | string | localhost | 客户机用于请求资源的 IP 地址、带域名后缀的域名服务器 (DNS) 主机名,或仅 DNS 主机名。使用“*”可表示所有可用网络接口。 |
httpPort | int Min: -1 Max: 65535 | 用于客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 | |
httpsPort | int Min: -1 Max: 65535 | 用于使用 SSL (https) 保护的客户机 HTTP 请求的端口。使用 -1 可禁用此端口。 | |
httpOptionsRef | 对顶级 httpOptions 元素的引用(字符串)。 | defaultHttpOptions | 端点的 HTTP 协议选项。 |
sslOptionsRef | 对顶级 sslOptions 元素的引用(字符串)。 | 端点的 SSL 协议选项。 | |
tcpOptionsRef | 对顶级 tcpOptions 元素的引用(字符串)。 | defaultTCPOptions | 端点的 TCP 协议选项。 |
accessLoggingRef | 对顶级 httpAccessLogging 元素的引用(字符串)。 | 端点的 HTTP 访问日志记录配置。 |
端点的 HTTP 协议选项。
Name | Type | Default | Description |
---|---|---|---|
keepAliveEnabled | 布尔型 | true | 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应重复使用。如果为 false,那么发送响应之后将关闭连接。 |
maxKeepAliveRequests | int Min: -1 | 100 | 启用持续连接时,单个 HTTP 连接上允许的最大持续请求数。值为 -1 时意味着不受限制。 |
persistTimeout | 具有秒精度的时间段 | 30s | 将允许套接字在各个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
readTimeout | 具有秒精度的时间段 | 60s | 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
writeTimeout | 具有秒精度的时间段 | 60s | 响应数据的每个部分在套接字上等待传输的时间量。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
removeServerHeader | 布尔型 | false | 从 HTTP 头除去服务器实现信息,并同时禁用缺省 Liberty 概要文件欢迎页面。 |
NoCacheCookiesControl | 布尔型 | true | 允许使用者控制“设置 Cookie”头的存在是否会导致使用匹配的无高速缓存值更新“高速缓存控制”头。这还会添加“到期”头。 |
AutoDecompression | 布尔型 | true | 指定 HTTP 通道是否自动解压传入请求主体数据。 |
端点的 SSL 协议选项。
Name | Type | Default | Description |
---|---|---|---|
sessionTimeout | 具有秒精度的时间段 | 1d | 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,以 30s 的形式指定 30 秒。可将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 |
suppressHandshakeErrors | 布尔型 | false | 禁用记录 SSL 握手错误。SSL 握手错误会在正常操作期间发生,但是当 SSL 行为异常时,这些消息将很有用。 |
sslRef | 对顶级 ssl 元素的引用(字符串)。 | 缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。 | |
sslSessionTimeout | 具有毫秒精度的时间段 | 8640ms | SSL 通道建立的 SSL 会话的超时限制。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 |
端点的 TCP 协议选项。
Name | Type | Default | Description |
---|---|---|---|
inactivityTimeout | 具有毫秒精度的时间段 | 60s | 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。. 指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m)、秒 (s) 或毫秒 (ms)。例如,以 500ms 的形式指定 500 毫秒。可将多个值包括在单个条目中。例如,1s500ms 相当于 1.5 秒。 |
soReuseAddr | 布尔型 | true | 允许立即重新绑定到没有任何处于活动状态的侦听器的端口。 |
addressIncludeList | string | 允许在此端点上进行入站连接的地址的逗号分隔列表。您可以指定 IPv4 或 IPv6 地址。IPv4 或 IPv6 地址中的所有值必须用数字或星号通配符表示。 | |
addressExcludeList | string | 不允许在此端点上进行入站连接的地址的逗号分隔列表。您可以指定 IPv4 或 IPv6 地址。IPv4 或 IPv6 地址中的所有值必须用数字或星号通配符表示。 | |
hostNameIncludeList | string | 允许在此端点上进行入站连接的主机名的逗号分隔列表。主机名是不区分大小写的,可以星号(用作通配符)开头。但是,不能在主机名中的任何其他位置使用星号。例如,*.abc.com 有效,但 *.abc.* 无效。 | |
hostNameExcludeList | string | 不允许在此端点上进行入站连接的主机名的逗号分隔列表。主机名是不区分大小写的,可以星号(用作通配符)开头。但是,不能在主机名中的任何其他位置使用星号。例如,*.abc.com 有效,但 *.abc.* 无效。 |
端点的 HTTP 访问日志记录配置。
Name | Type | Default | Description |
---|---|---|---|
enabled | 布尔型 | true | 启用访问日志记录。 |
filePath | 文件路径 | ${server.output.dir}/logs/http_access.log | 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。 |
logFormat | string | %h %u %{t}W "%r" %s %b | 指定记录客户机访问信息时使用的日志格式。 |
maxFileSize | int Min: 0 | 20 | 回滚之前日志文件的最大大小,以兆字节计;值为 0 意味着无限制。 |
maxFiles | int Min: 0 | 2 | 除去最早的日志文件之前将保留的日志文件的最大数目;值为 0 意味着无限制。 |