Class StripedLock

java.lang.Object
com.sure.tool.thread.StripedLock

public class StripedLock extends Object
定长分段锁:按 key 哈希映射到固定数量的锁段,避免 LockUtil 按 key 无界缓存导致的内存增长, 参考 Guava Striped<Lock> 设计。

段数固定为 2 的幂(向上取整),默认 16 段;相同 key 恒映射到同一段锁(互斥), 不同 key 大概率分散到不同段(可并行)。适合对热点 key 的粗粒度互斥场景。

Since:
1.11.0
  • Field Details

    • DEFAULT_STRIPES

      public static final int DEFAULT_STRIPES
      默认段数。
      See Also:
  • Constructor Details

    • StripedLock

      public StripedLock()
      构造默认 16 段分段锁。
    • StripedLock

      public StripedLock(int stripes)
      构造指定段数分段锁(段数向上取整为 2 的幂)。
      Parameters:
      stripes - 段数,必须大于 0
      Throws:
      IllegalArgumentException - stripes 不大于 0
  • Method Details

    • get

      public ReentrantLock get(Object key)
      按 key 获取对应段锁。相同 key 恒返回同一把锁。
      Parameters:
      key - 锁键,null 视为常量 0
      Returns:
      段锁
    • get

      public ReentrantLock get(int index)
      按索引直接获取段锁(越界自动取模)。
      Parameters:
      index - 段索引,可为任意整数
      Returns:
      段锁
    • lockCount

      public int lockCount()
      返回段锁总数。
      Returns:
      段数
    • runLocked

      public void runLocked(Object key, Runnable action)
      在 key 对应段锁保护下执行动作(锁内执行,不可重入嵌套使用)。
      Parameters:
      key - 锁键
      action - 动作
    • runLocked

      public <T> T runLocked(Object key, Supplier<T> action)
      在 key 对应段锁保护下执行并返回值。
      Type Parameters:
      T - 返回值类型
      Parameters:
      key - 锁键
      action - 动作
      Returns:
      动作结果