[Curator] Shared Semaphore 的使用与分析

最新推荐文章于 2023-01-08 17:30:58 发布

weixin_34247032

最新推荐文章于 2023-01-08 17:30:58 发布

阅读量138

点赞数

原文链接：https://my.oschina.net/roccn/blog/912697

版权

为什么80%的码农都做不了架构师？>>>

Shared Semaphore

一个计数信号量，可以使用一把锁来限制进程进入的数量（租约）。每一个用户按请求顺序得到一份租约，基本上还是一个公平的过程。

有两种方式来控制信号量的最大租约数（max leases）。

用户直接设定某个path下最大租约数
- 不可以对不同的处理任务进行单独限制数量
- 所有的任务都使用一个公用的限制数
使用一个SharedCountReader来决定对于path下应该提供多少份租约
- 可以为不同的执行任务分配不同的租约数量

对于获得到的租约，一定要妥善的关闭（例如，在finally块中调用close方法），否则，租约就会丢失（信号量可用数量不可逆的减少了）。

在客户端session失效时，链接持有的租约会自动关闭，其他客户端可以继续使用这份租约。

1. 关键 API

org.apache.curator.framework.recipes.locks.InterProcessSemaphoreV2

org.apache.curator.framework.recipes.locks.Lease

org.apache.curator.framework.recipes.shared.SharedCountReader

2. 机制说明

在《Shared Lock 的使用与分析》中已经见识过InterProcessSemaphoreV2的使用了。

3. 用法

3.1 创建

3.1.1 直接设定maxLeases的方式

public InterProcessSemaphoreV2(CuratorFramework client,
                             String path,
                             int numberOfLeases)

3.1.2 使用SharedCountReader的方式

public InterProcessSemaphoreV2(CuratorFramework client,
                             String path,
                             SharedCountReader count)

3.2 使用

3.2.1 申请

提供了好几个acquire方法，可用于不同的场景：

阻塞式申请单个

public Lease acquire()

阻塞式批量申请

public Collection<Lease> acquire(int qty)

等待式申请单个

public Lease acquire(long time,
                     TimeUnit unit)

等待式批量申请

public Collection<Lease> acquire(int qty,
                               long time,
                               TimeUnit unit)

3.2.2 归还

批量归还

public void returnAll(Collection<Lease> leases)

单个归还

public void returnLease(Lease lease)

当然，也可以直接调用租约的关闭方法：Lease#close()

4. 错误处理

实际使用中，必须考虑链接问题。强烈建议：添加一个ConnectionStateListener用以处理链接中断或者丢失的情况

5. 源码分析

参见《Shared Lock 的使用与分析》中，有关InterProcessSemaphoreV2的部分。

转载于:https://my.oschina.net/roccn/blog/912697