package syncx import "sync" type ( // SharedCalls is an alias of SingleFlight. // Deprecated: use SingleFlight. SharedCalls = SingleFlight // SingleFlight lets the concurrent calls with the same key to share the call result. // For example, A called F, before it's done, B called F. Then B would not execute F, // and shared the result returned by F which called by A. // The calls with the same key are dependent, concurrent calls share the returned values. // A ------->calls F with key<------------------->returns val // B --------------------->calls F with key------>returns val SingleFlight interface { Do(key string, fn func() (interface{}, error)) (interface{}, error) DoEx(key string, fn func() (interface{}, error)) (interface{}, bool, error) } call struct { wg sync.WaitGroup val interface{} err error } flightGroup struct { calls map[string]*call lock sync.Mutex } ) // NewSingleFlight returns a SingleFlight. func NewSingleFlight() SingleFlight { return &flightGroup{ calls: make(map[string]*call), } } // NewSharedCalls returns a SingleFlight. // Deprecated: use NewSingleFlight. func NewSharedCalls() SingleFlight { return NewSingleFlight() } func (g *flightGroup) Do(key string, fn func() (interface{}, error)) (interface{}, error) { c, done := g.createCall(key) if done { return c.val, c.err } g.makeCall(c, key, fn) return c.val, c.err } func (g *flightGroup) DoEx(key string, fn func() (interface{}, error)) (val interface{}, fresh bool, err error) { c, done := g.createCall(key) if done { return c.val, false, c.err } g.makeCall(c, key, fn) return c.val, true, c.err } func (g *flightGroup) createCall(key string) (c *call, done bool) { g.lock.Lock() if c, ok := g.calls[key]; ok { g.lock.Unlock() c.wg.Wait() return c, true } c = new(call) c.wg.Add(1) g.calls[key] = c g.lock.Unlock() return c, false } func (g *flightGroup) makeCall(c *call, key string, fn func() (interface{}, error)) { defer func() { g.lock.Lock() delete(g.calls, key) g.lock.Unlock() c.wg.Done() }() c.val, c.err = fn() }