基本介绍

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

使用场景

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

使用方式

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不支持对象创建方法及销毁方法。

相关文档