xfy
2458ac1ed1
为剩余模块添加完整文档注释： - app: 应用生命周期管理 - cache: 文件缓存 - config: 配置加载器 - handler: 静态文件处理和错误页面 - http2/http3: HTTP/2 和 HTTP/3 适配器 - loadbalance: 负载均衡算法和均衡器 - middleware: bodylimit、compression、rewrite、security - mimeutil: MIME 类型检测 - netutil: URL 处理工具 - resolver: DNS 解析器 - server: 服务器升级处理 - ssl: SSL/TLS 和 OCSP - stream: 流处理 - testutil: 测试工具 - variable: 变量池和 SSL 变量 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
71 lines
1.7 KiB
Go
71 lines
1.7 KiB
Go
// Package variable 提供 sync.Pool 用于复用 Context，减少 GC 压力。
|
||
//
|
||
// 包含池统计信息、Get/Put 包装方法和统计重置功能。
|
||
//
|
||
// 作者：xfy
|
||
package variable
|
||
|
||
import (
|
||
"sync"
|
||
"sync/atomic"
|
||
)
|
||
|
||
// PoolStats 池统计信息。
|
||
//
|
||
// 记录 sync.Pool 的使用统计，用于监控和调试。
|
||
type PoolStats struct {
|
||
// Gets 从池中获取对象的次数
|
||
Gets int64
|
||
// Puts 放回池中对象的次数
|
||
Puts int64
|
||
// NewCount 调用 New 函数创建对象的次数
|
||
NewCount int64
|
||
// Active 当前活跃对象数量（Gets - Puts）
|
||
Active int64
|
||
}
|
||
|
||
var (
|
||
// gets 从池中获取对象的次数
|
||
gets atomic.Int64
|
||
// puts 放回池中对象的次数
|
||
puts atomic.Int64
|
||
// newCount 调用 New 函数创建对象的次数
|
||
newCount atomic.Int64
|
||
// active 当前活跃对象数量（Gets - Puts）
|
||
active atomic.Int64
|
||
)
|
||
|
||
// GetStats 获取池统计信息的副本。
|
||
//
|
||
// 返回当前统计信息的快照，包含获取次数、放回次数、新建次数和活跃数量。
|
||
// 该方法是线程安全的，可在多个 goroutine 中同时调用。
|
||
//
|
||
// 返回值：
|
||
// - PoolStats: 统计信息快照，包含 Gets、Puts、NewCount 和 Active 字段
|
||
func GetStats() PoolStats {
|
||
return PoolStats{
|
||
Gets: gets.Load(),
|
||
Puts: puts.Load(),
|
||
NewCount: newCount.Load(),
|
||
Active: active.Load(),
|
||
}
|
||
}
|
||
|
||
// GetPool 获取底层的 sync.Pool（用于测试和调试）。
|
||
//
|
||
// 返回值：
|
||
// - *sync.Pool: 变量池实例，可用于直接操作池中的对象
|
||
func GetPool() *sync.Pool {
|
||
return &pool
|
||
}
|
||
|
||
// ResetStats 重置统计信息。
|
||
//
|
||
// 将所有统计计数器清零，线程安全。
|
||
func ResetStats() {
|
||
gets.Store(0)
|
||
puts.Store(0)
|
||
newCount.Store(0)
|
||
active.Store(0)
|
||
}
|