StampedLock

public class StampedLock
extends Object implements Serializable

基于能力的锁定，具有三种控制读/写访问的模式。 StampedLock的状态由一个版本和模式组成。 锁定采集方法返回一个表示和控制与锁定状态相关的访问的标记; 这些方法的“尝试”版本可能会返回特殊值零来表示获取访问失败。 锁定释放和转换方法需要将邮票作为参数，并且如果它们与锁的状态不匹配，则会失败。 这三种模式是：

• Writing. Method writeLock() possibly blocks waiting for exclusive access, returning a stamp that can be used in method unlockWrite(long) to release the lock. Untimed and timed versions of tryWriteLock are also provided. When the lock is held in write mode, no read locks may be obtained, and all optimistic read validations will fail.
• Reading. Method readLock() possibly blocks waiting for non-exclusive access, returning a stamp that can be used in method unlockRead(long) to release the lock. Untimed and timed versions of tryReadLock are also provided.
• Optimistic Reading. Method tryOptimisticRead() returns a non-zero stamp only if the lock is not currently held in write mode. Method validate(long) returns true if the lock has not been acquired in write mode since obtaining a given stamp. This mode can be thought of as an extremely weak version of a read-lock, that can be broken by a writer at any time. The use of optimistic mode for short read-only code segments often reduces contention and improves throughput. However, its use is inherently fragile. Optimistic read sections should only read fields and hold them in local variables for later use after validation. Fields read while in optimistic mode may be wildly inconsistent, so usage applies only when you are familiar enough with data representations to check consistency and/or repeatedly invoke method validate(). For example, such steps are typically required when first reading an object or array reference, and then accessing one of its fields, elements or methods.

此类还支持有条件地提供三种模式转换的方法。 例如，方法tryConvertToWriteLock(long)尝试“升级”模式，如果（1）已处于书写模式（2）处于阅读模式并且没有其他读取器或（3）处于乐观模式且锁定可用，则返回有效的写入标记。 这些方法的形式旨在帮助减少在基于重试的设计中发生的一些代码膨胀。

StampedLocks被设计用作开发线程安全组件的内部工具。 他们的使用依赖于他们所保护的数据，对象和方法的内部属性的知识。 它们不是可重入的，因此锁定的机构不应该调用其他可能尝试重新获取锁定的未知方法（尽管您可以将戳记传递给可以使用或转换它的其他方法）。 读取锁定模式的使用依赖于相关的代码段是无副作用的。 未经验证的乐观阅读部分不能调用未知的方法来容忍潜在的不一致。 邮票使用有限的表示，并且不具有密码安全性（即，有效的邮票可能是可猜测的）。 在连续运行一年后（不止一年），印花值可能会回收。 没有使用或验证时间长于此期限的图章可能无法正确验证。 StampedLocks是可序列化的，但总是反序列化到初始解锁状态，所以它们对远程锁定没有用处。

StampedLock的调度策略并不总是偏爱读者而不是写者，反之亦然。 所有“尝试”方法都是尽力而为，并不一定符合任何调度或公平策略。 任何用于获取或转换锁的“尝试”方法的零返回不包含关于锁的状态的任何信息; 随后的调用可能会成功。

由于它支持跨多种锁定模式的协调使用，因此该类不直接实现Lock或ReadWriteLock接口。 然而，StampedLock可以看作asReadLock() ， asWriteLock() ，或asReadWriteLock()中，仅需要在一组相关联的功能的应用程序。

样例用法。 以下举例说明了维护简单二维点的类中的一些使用习惯用法。 示例代码说明了一些try / catch约定，尽管这里并不严格需要它们，因为它们的主体中不会出现异常。

 class Point {
   private double x, y;
   private final StampedLock sl = new StampedLock();

   void move(double deltaX, double deltaY) { // an exclusively locked method
     long stamp = sl.writeLock();
     try {
       x += deltaX;
       y += deltaY;
     } finally {
       sl.unlockWrite(stamp);
     }
   }

   double distanceFromOrigin() { // A read-only method
     long stamp = sl.tryOptimisticRead();
     double currentX = x, currentY = y;
     if (!sl.validate(stamp)) {
        stamp = sl.readLock();
        try {
          currentX = x;
          currentY = y;
        } finally {
           sl.unlockRead(stamp);
        }
     }
     return Math.sqrt(currentX * currentX + currentY * currentY);
   }

   void moveIfAtOrigin(double newX, double newY) { // upgrade
     // Could instead start with optimistic, not read mode
     long stamp = sl.readLock();
     try {
       while (x == 0.0 && y == 0.0) {
         long ws = sl.tryConvertToWriteLock(stamp);
         if (ws != 0L) {
           stamp = ws;
           x = newX;
           y = newY;
           break;
         }
         else {
           sl.unlockRead(stamp);
           stamp = sl.writeLock();
         }
       }
     } finally {
       sl.unlock(stamp);
     }
   }
 }

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过了一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Public constructors

StampedLock ()

Public methods

Lock asReadLock ()

ReadWriteLock asReadWriteLock ()

Lock asWriteLock ()

int getReadLockCount ()

boolean isReadLocked ()

boolean isWriteLocked ()

long readLock ()

long readLockInterruptibly ()

String toString ()

long tryConvertToOptimisticRead (long stamp)

long tryConvertToReadLock (long stamp)

long tryConvertToWriteLock (long stamp)

long tryOptimisticRead ()

long tryReadLock ()

long tryReadLock (long time, 
                TimeUnit unit)

boolean tryUnlockRead ()

boolean tryUnlockWrite ()

long tryWriteLock ()

long tryWriteLock (long time, 
                TimeUnit unit)

void unlock (long stamp)

void unlockRead (long stamp)

void unlockWrite (long stamp)

boolean validate (long stamp)

long writeLock ()

long writeLockInterruptibly ()