基本介绍

对象复用池(并发安全)。将对象进行缓存复用,支持 过期时间创建方法销毁方法 定义。

使用场景

任何需要支持定时过期的对象复用场景。

使用方式

  1. import "github.com/gogf/gf/v2/container/gpool"

接口文档

https://pkg.go.dev/github.com/gogf/gf/v2/container/gpool

需要注意两点:

  1. New 方法的过期时间类型为 time.Duration
  2. 对象 创建方法( newFunc NewFunc)返回值包含一个 error 返回,当对象创建失败时可由该返回值反馈原因。
  3. 对象 销毁方法( expireFunc...ExpireFunc)为可选参数,用以当对象超时/池关闭时,自动调用自定义的方法销毁对象。

gpoolsync.Pool

gpoolsync.Pool 都可以达到对象复用的作用,但是两者的设计初衷和使用场景不太一样。

sync.Pool 的对象生命周期不支持自定义过期时间,究其原因, sync.Pool 并不是一个 Cachesync.Pool 设计初衷是为了缓解GC 压力sync.Pool 中的对象会在 GC 开始前全部清除;并且 sync.Pool 不支持对象创建方法及销毁方法。

相关文档

📄️ 对象复用-基本使用在GoFrame框架中使用gpool进行对象复用。在示例中,我们创建和操作了一个对象池,展示了对象的获取、返回及过期处理方法。此方法对于管理短生命周期的资源非常有效,可以显著提高程序性能和资源利用率。