通用的Golang分布式锁组件,更多使用案例详见 examples
若有意向贡献未完成的驱动代码,请通过 ISSUES 或 邮箱 249008728@qq.com
联系我
Driver | 代码完成度 | 测试完成度 | 依赖包 | 使用说明 |
---|---|---|---|---|
redis | 100% | 100% | letsfire/redigo | 详见 README.md |
pgsql | 100% | 100% | lib/pq | 详见 README.md |
etcd | 未完成 | 未测试 | etcd/client | 详见 README.md |
etcdv3 | 未完成 | 未测试 | etcd/clientv3 | 详见 README.md |
配置项 mutex.OptFunc
以及返回值锁的使用详见 mutex/README.md
- NewMutex(name string, optFuncs ...mutex.OptFunc) (*mutex.Mutex, error)
创建互斥锁,若name
已用于创建读写锁则返回error
,本方法单例模式 - NewRWMutex(name string, optFuncs ...mutex.OptFunc) (*mutex.RWMutex, error)
创建读写锁,若name
已用于创建互斥锁则返回error
,本方法单例模式
- 不可重入(如果您有强烈的需求场景,请通过 ISSUES 提供反馈)
- 非公平锁(Golang的本地锁
sync.Locker
视乎也不是公平锁,若您有需求或建议,请通过 ISSUES 提供反馈) - 有互斥锁
mutex
和 读写锁rwmutex
两种类型,具体支持程度详见各个Driver
对应的README.md
- 虽有完整的单元测试,但暂未经过实际项目考验,故慎用于生产环境,如有问题请通过 ISSUES 来共同完善
- 主线调用层级为
distlock.go
->mutex.go
->driver.go
distlock.go
提供了创建锁的工厂类,单例模式(相同名称的锁有且仅有一个,有且仅为一种)mutex.go
提供了各类锁的实现,欢迎各位同学贡献其他类型锁,详见 mutex/README.mddriver.go
提供驱动接口的定义,欢迎各位同学贡献其他驱动,详见 driver/README.md