HTTP 端点 (httpEndpoint)
HTTP 端点的配置属性。
| 属性名称 | 数据类型 | 缺省值 | 描述 |
|---|---|---|---|
| accessLoggingRef | 对顶级 httpAccessLogging 元素的引用(字符串)。 | 端点的 HTTP 访问日志记录配置。 | |
| enabled | 布尔型 | true | 切换端点的可用性。值为 true 时,分派器将激活此端点以处理 HTTP 请求。 |
| 主机 | string | localhost | 客户机用于请求资源的 IP 地址、带域名后缀的域名服务器 (DNS) 主机名,或仅 DNS 主机名。可使用“*”来表示所有可用网络接口。 |
| httpOptionsRef | 对顶级 httpOptions 元素的引用(字符串)。 | defaultHttpOptions | 端点的 HTTP 协议选项。 |
| httpPort | 整型 最小值:-1 最大值:65535 |
用于客户机 HTTP 请求的端口。使用 -1 来禁用此端口。 | |
| httpsPort | 整型 最小值:-1 最大值:65535 |
用于通过 SSL (https) 来保护的客户机 HTTP 请求的端口。使用 -1 来禁用此端口。 | |
| id | string | 唯一配置标识。 | |
| onError |
|
WARN | 启动端点失败后要执行的操作。
|
| sslOptionsRef | 对顶级 sslOptions 元素的引用(字符串)。 | 端点的 SSL 协议选项。 | |
| tcpOptionsRef | 对顶级 tcpOptions 元素的引用(字符串)。 | defaultTCPOptions | 端点的 TCP 协议选项。 |
- accessLogging
描述: 端点的 HTTP 访问日志记录配置。必需: False数据类型: 属性名称 数据类型 缺省值 描述 enabled 布尔型 true 启用访问日志记录。 filePath 文件路径 ${server.output.dir}/logs/http_access.log 访问日志文件的目录路径和名称。指定目录路径时可以使用标准变量替换,如 ${server.output.dir}。 logFormat string %h %u %{t}W "%r" %s %b 指定在日志记录客户机访问信息时所使用的日志格式。 maxFileSize 整型 最小值:0
20 回滚之前日志文件的最大大小,以兆字节计;值为 0 时意味着无限制。 maxFiles 整型 最小值:0
2 移除最旧的日志文件之前将保留的最大日志文件数;值为 0 时意味着无限制。
- httpOptions
描述: 端点的 HTTP 协议选项。必需: False数据类型: 属性名称 数据类型 缺省值 描述 keepAliveEnabled 布尔型 true 启用持续连接(HTTP 保持活动)。如果为 true,那么连接将保持活动状态,以供多个顺序请求和响应复用。如果为 false,那么发送响应之后会关闭连接。 maxKeepAliveRequests 整型 最小值:-1
100 启用持续连接时,单个 HTTP 连接上可接受的最大持续请求数。值为 -1 时意味着不受限制。 persistTimeout 精度为秒的时间段 30s 将允许套接字在两个请求之间保持空闲的时间量。仅当启用持续连接时,此设置才适用。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 readTimeout 精度为秒的时间段 60s 发生第一次读取之后,用于等待读请求在套接字上完成的时间量。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 removeServerHeader 布尔型 False 从 HTTP 头中移除服务器实现信息,并且还要禁用缺省 Liberty 概要文件欢迎页面。 writeTimeout 精度为秒的时间段 60s 响应数据的每个部分在套接字上等待传输的时间量。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。
- sslOptions
描述: 端点的 SSL 协议选项。必需: False数据类型: 属性名称 数据类型 缺省值 描述 sessionTimeout 精度为秒的时间段 1d 用于等待读或写请求在套接字上完成的时间量。特定于协议的超时将覆盖此值。指定后跟时间单位的正整数,时间单位可以是小时 (h)、分钟 (m) 或秒 (s)。例如,将 30 秒指定为 30s。可以将多个值包括在单个条目中。例如,1m30s 相当于 90 秒。 sslRef 对顶级 ssl 元素的引用(字符串)。 缺省 SSL 配置指令表。缺省值为 defaultSSLSettings。 suppressHandshakeErrors 布尔型 False 禁止记录 SSL 握手错误。正常操作期间可能会发生 SSL 握手错误,但是如果 SSL 行为异常,那么这些消息很有用。
参考主题