Files
core/lib/doc/dever-http-pool.md
2026-11-03 03:32:07 +00:00

46 lines
1.1 KiB
Markdown

# HTTP 连接池
连接池固定使用一个 origin,在创建它的任务作用域结束时关闭。
## dever.http.PoolLimits
空闲保活和流读取限额。
字段:
- `idle_ms`:空闲连接期限
- `chunk_bytes`:流分块上限
- `read_ms`:流读取期限
## dever.http.ClientResult
HTTP 连接池的创建结果。
分支:
- `Ready(client: dever.system.HttpClient)`:共享资源
- `error Failed(message: Text)`:配置或资源失败
## dever.http.defaultPoolLimits
使用有限的默认保活与读取配置。
## dever.http.client
创建共享资源;第一次请求才连接。HTTPS 校验 CA 和主机名。
未声明端口时使用协议默认端口;显式端口非法时立即报错。
## dever.http.request
在固定 origin 发送独立请求;所有排队和 I/O 共用本次期限。
## dever.http.closeClient
关闭所有连接并等待驱动释放;其他别名随后请求失败。
## dever.http.readClient
取出连接池;创建失败时继续传播错误。
## dever.http.closedClient
关闭成功时继续执行,失败时传播错误。