ReentrantLock解析及源码分析

本文结构

  • Tips:说明一部分概念及阅读源码须要的基础内容
  • ReentrantLock简介
  • 公平机制:对于公平机制和非公平机制进行介绍,包含对比
  • 实现:Sync源码解析额,公平和非公平模式的加锁、解锁过程及源码分析
  • 公平锁和非公平锁的加锁流程图
  • ReentrantLock提供的一些其余方法
  • Condition:这里只是一提,不会有什么有意义的内容
  • ReentrantLock所有源码理解:我的阅读ReentrantLock源码的时候作的注释,须要结合AQS一块理解

Tips:


  • 同步等待队列:即广泛的资料中提到的同步队列,由AQS维护。在代码的英文注释中写道wait queue,所以我在这里翻译成同步等待队列
  • 条件等待队列:即广泛的资料中提到的等待队列,由AQS.Condition维护,在代码的英文注释中也是写道wait queue,所以我在这里翻译成条件等待队列
  • 本篇文章会大量提到AQS这个类,而且大量的方法都在AQS中实现,本文对会对使用到的方法进行解释,可是对于AQS内部的属性没有过多解释,后续篇章写AQS会专门写,建议能够了解一下,有助于理解
  • 建议阅读前先了解AQS中的Node类,有助于阅读,本文不会说明

ReentrantLock简介


在多线程编程中,同步和互斥是一个很是重要的问题。
在java中能够经过使用synchronized来实现共享资源的独占,
除此以外还可使用Lock提供的方法来实现对共享资源的独占。
并且Lock对比synchronized具备更高的灵活性。java

ReentrantLockLock接口的一种实现,它提供了公平和非公平两种锁的公平机制供开发者选择,
而且实现了锁的可重入性(指的是对同一临界资源重复加锁,注意:加锁多少次就必定要解锁多少次)。node

公平机制


概念

ReentrantLock提供了公平锁和非公平锁两个版本供开发者选择:编程

  • 公平锁:全部请求获取锁的线程按照前后顺序排队获取锁,下一个获取锁的线程必定是等候获取锁时间最长的线程,所得获取知足FIFO特色。安全

  • 非公平锁:请求获取锁的线程不必定须要排队,只要锁没有被获取,不管是否有线程在等待获取所,他就能够进行加锁操做。eg:全部在队列中等待锁的线程都没有被操做系统调度到而且锁没有被获取,此时正在指定的线程须要获取锁就能够直接尝试获取锁多线程

对比

公平锁 非公平锁
优势 全部的线程均可以获取到资源不会饿死在队列当中 能够减小CPU唤醒线程的开销,总体的吞吐效率会高点,CPU也没必要取唤醒全部线程,会减小唤起线程的数量
缺点 吞吐量会降低不少,队列里面除了第一个线程,其余的线程都会阻塞,cpu唤醒阻塞线程的开销会很大 可能致使队列中间的线程一直获取不到锁或者长时间获取不到锁,致使饿死

实现


抽象类Sync

公平与非公平的实现主要靠锁的同步器来实现,他们都是内部抽象类Sync的子类(姑且称之为抽象同步器)。app

\(\color{#FF3030}{Sync及父类AQS提供了整个加锁和解锁的过程及排队等待的过程,}\)并暴露出抽象方法lock()供实现不一样的锁公平机制。less

ReentrantLockSync的子类NonfairSync提供非公平锁同步机制,FairSync提供公平的锁同步机制。ide

代码的解释请看注释oop

/**
     * Base of synchronization control for this lock. Subclassed
     * into fair and nonfair versions below. Uses AQS state to
     * represent the number of holds on the lock.
     */
    //提供了这个锁的同步器的基础方法,子类NonfairSync和FairSync提供了公平和非公平两种同步器的实现
    //使用AQS的state来标识锁的状态
    abstract static class Sync extends AbstractQueuedSynchronizer {
        private static final long serialVersionUID = -5179523762034025860L;

        /**
         * Performs {@link Lock#lock}. The main reason for subclassing
         * is to allow fast path for nonfair version.
         */
        //抽象方法加锁,加锁过程交给子类实现以提供不一样的公平机制
        abstract void lock();

        /**
         * Performs non-fair tryLock.  tryAcquire is implemented in
         * subclasses, but both need nonfair try for trylock method.
         */
        //默认提供了非公平机制的加锁过程
        //acquires 申请加锁的次数,通常状况下是一次,可是有屡次的状况,在Condition中会看到
        final boolean nonfairTryAcquire(int acquires) {
            final Thread current = Thread.currentThread();
            //获取锁的状态,getState在AQS中实现
            int c = getState();
            //锁空闲
            if (c == 0) {
                //加锁,加锁成功设置锁的属于哪一个线程信息
                if (compareAndSetState(0, acquires)) {
                    setExclusiveOwnerThread(current);
                    return true;
                }
            }
            //当前线程已经成功获取了锁,这块也是锁的可重入性的体现
            else if (current == getExclusiveOwnerThread()) {
                //将锁的持有次数加给定的次数便可
                int nextc = c + acquires;
                if (nextc < 0) // overflow
                    throw new Error("Maximum lock count exceeded");
                //设置加锁次数
                setState(nextc);
                return true;
            }
            return false;
        }
        
        //释放锁的过程
        //releases释放锁的次数,通常状况下是一次,可是有屡次的状况,在Condition中会看到
        protected final boolean tryRelease(int releases) {
            //getState在AQS中实现
            int c = getState() - releases;
            //独占锁释放锁的时候谁获取的锁谁用完释放,期间不准其余线程使用
            /若是锁的拥有者不是当前线程代码结构则出了问题
            if (Thread.currentThread() != getExclusiveOwnerThread())
                throw new IllegalMonitorStateException();
            //因为可重入性,只有在释放releases次后锁状态为0才彻底释放锁,锁才不被占有
            boolean free = false;
            //若是释放锁后锁状态为0,则表示当前线程再也不持有这个锁
            //则将持有锁的线程exclusiveOwnerThread置null
            if (c == 0) {
                free = true;
                setExclusiveOwnerThread(null);
            }
            //设置锁状态,,在AQS中实现
            setState(c);
            return free;
        }

        //检查当前线程是否持当前锁
        protected final boolean isHeldExclusively() {
            // While we must in general read state before owner,
            // we don't need to do so to check if current thread is owner
            return getExclusiveOwnerThread() == Thread.currentThread();
        }

        //条件等待队列
        //具体实如今AQS中实现
        final ConditionObject newCondition() {
            return new ConditionObject();
        }

        // Methods relayed from outer class
        //获取当前锁的持有者
        final Thread getOwner() {
            return getState() == 0 ? null : getExclusiveOwnerThread();
        }

        //获取当前线程持有锁的次数
        final int getHoldCount() {
            return isHeldExclusively() ? getState() : 0;
        }

        //检查锁是否被持有
        final boolean isLocked() {
            return getState() != 0;
        }

        /**
         * Reconstitutes the instance from a stream (that is, deserializes it).
         */
        private void readObject(java.io.ObjectInputStream s)
            throws java.io.IOException, ClassNotFoundException {
            s.defaultReadObject();
            setState(0); // reset to unlocked state
        }
    }

公平锁

公平锁提供了一种绝对等待时间公平的机制,锁永远会被同步等待队列中等待时间最长的获取到,
这样能够保证每一个在等待的线程在程序不退出的状况下均可以获取到锁。
可是每个请求的锁的线程都将进入到同步等待队列中阻塞休眠,线程的休眠和唤醒须要耗费额外的时间,会下降效率,下降吞吐量
(整个在同步等待队列中阻塞休眠的操做不是绝对的,只有所没有被占有,而且同步等待队列为空时能够直接获取锁或者递归调用同一个线程获取锁)源码分析

公平锁的同步器

/**
     * Sync object for fair locks
     */
    static final class FairSync extends Sync {
        private static final long serialVersionUID = -3000897897090466540L;

        final void lock() {
            //调用AQS提供的请求加锁的方法
            //紧接着下一个代码片断解释
            acquire(1);
        }



        /**
         * Fair version of tryAcquire.  Don't grant access unless
         * recursive call or no waiters or is first.
         */
        //公平版本的tryAcquire,
        //第一个获取锁的线程和已经获取锁的线程递归调用获取锁不须要再排队等待
        protected final boolean tryAcquire(int acquires) {
            final Thread current = Thread.currentThread();
            int c = getState();
            if (c == 0) {
                //判断同步等待队列中是否有其余等待获取锁的线程
                //没有而且锁没有被其余线程持有则能够直接获取锁
                if (!hasQueuedPredecessors() &&
                    compareAndSetState(0, acquires)) {
                    setExclusiveOwnerThread(current);
                    return true;
                }
            }
            //若是当前线程持有锁,则能够锁计数器加一让该线程再一次获取锁
            else if (current == getExclusiveOwnerThread()) {
                int nextc = c + acquires;
                if (nextc < 0)
                    throw new Error("Maximum lock count exceeded");
                setState(nextc);
                return true;
            }
            //不然当前线程在此次尝试获取锁以前就没有获取到锁
            //同步等待队列中有其余线程在尝试获取锁
            //则获取锁失败,下一步应该会被加入到同步等待队列
            return false;
        }
    }

简单看下hasQueuedPredecessors()方法,这里只解释知足公平锁加锁条件的状况

/**
 * Queries whether any threads have been waiting to acquire longer
 * than the current thread.
 */
//这个方法是再AQS中提供的用来判断线同步等待队列中是否还有等待时间比当前线程等待时间更长的线程
//tail是队列的尾节点,head是头节点,每一个节点会表明一个线程首尾节点除外
//再tryAcquire中咱们但愿它返回的时false那么看下返回false表明那种状况
//返回false要求 h != t && ((s = h.next) == null|| s.thread != Thread.currentThread())为false,那么要么h==t就是头尾节点是同一个,队列为空
//要么(s = h.next) == null|| s.thread != Thread.currentThread()为false,
//这就要求h.next!=null 而且h.next就是当前线程,也就是说队列中第一个等待获取锁的线程就是当前线程
//那么就能够直接加锁;
public final boolean hasQueuedPredecessors() {
    // The correctness of this depends on head being initialized
    // before tail and on head.next being accurate if the current
    // thread is first in queue.
    Node t = tail; // Read fields in reverse initialization order
    Node h = head;
    Node s;
    return h != t &&
        ((s = h.next) == null || s.thread != Thread.currentThread());
}

公平锁的加锁

在公平锁的同步器中提供了lock()方法用来进行加锁操做,
可重入锁进行加锁的方法也确实是调用同步器的lock()来实现加锁

加锁入口:lock()方法;lock()方法定义在ReentrantLock类里面,经过调用同步器的加锁操做完成加锁过程,公平机制不影响对外暴露的接口

/**
     * Acquires the lock.
     *
     * <p>Acquires the lock if it is not held by another thread and returns
     * immediately, setting the lock hold count to one.
     *
     * <p>If the current thread already holds the lock then the hold
     * count is incremented by one and the method returns immediately.
     *
     * <p>If the lock is held by another thread then the
     * current thread becomes disabled for thread scheduling
     * purposes and lies dormant until the lock has been acquired,
     * at which time the lock hold count is set to one.
     */
    public void lock() {
        sync.lock();
    }

官方的注释说明了lock操做会作那些事情:

  1. 获取锁,若是所没有被其余线程获取,那么将获取这个锁并返回,并设置这个锁的状态为1标识被加锁一次(锁被获取一次)
  2. 若是当前线程已经持有锁,那么锁计数器自增1
  3. 若是锁被其余线程持有,那么当前线程会被阻塞进入睡眠状态并进入同步的等待队列,直到锁被获取,而后将锁的计数器设置为1

\(\color{#00FF00}{这里面好像没说明公平的方式哈,只要锁没被获取就马上获取,感受公平锁是绿的}\)

加锁的过程直接调用了同步器的lock()方法在上述的同步器中lock()调用acquire()方法

acquire()方法在AQS中实现

具体解释见注释

/**
     * Acquires in exclusive mode, ignoring interrupts.  Implemented
     * by invoking at least once {@link #tryAcquire},
     * returning on success.  Otherwise the thread is queued, possibly
     * repeatedly blocking and unblocking, invoking {@link
     * #tryAcquire} until success.  This method can be used
     * to implement method {@link Lock#lock}.
     *
     * @param arg the acquire argument.  This value is conveyed to
     *        {@link #tryAcquire} but is otherwise uninterpreted and
     *        can represent anything you like.
     */
    //以独占的方法加锁,而且忽略中断
    //那是否是还有响应中断的加锁呢??
    public final void acquire(int arg) {
        //先尝试调用同步器的tryAcquire()方法加锁
        if (!tryAcquire(arg) &&
            //加锁失败的状况下将当前线程放入同步等待队列中
            acquireQueued(addWaiter(Node.EXCLUSIVE), arg))
            
            //acquireQueued返回值是线程在等待期间是否被中断,若是有则还原中断现场
            selfInterrupt();
    }

addWaiter()方法,使用当前线程构造一个同步等待队列的节点,而且放在队尾,在AQS中实现

/**
     * Creates and enqueues node for current thread and given mode.
     *
     * @param mode Node.EXCLUSIVE for exclusive, Node.SHARED for shared
     * @return the new node
     */
    private Node addWaiter(Node mode) {
        //为当前的线程构造一个同步等待队列中的节点,在可重入锁中式排他的模式(mode==Node.EXCLUSIVE)
        Node node = new Node(Thread.currentThread(), mode);
        // Try the fast path of enq; backup to full enq on failure
        Node pred = tail;
        //若是队尾不为空
        if (pred != null) {
            node.prev = pred;//将当前节点放在队尾
            //使用CAS操做原子的设置队尾节点
            if (compareAndSetTail(pred, node)) {
                pred.next = node;
                return node;
            }
        }
        //若是对尾节点为空或者CAS设置队尾节点失败调用enq方法将当前线程节点添加进队列
        enq(node);
        return node;
    }

enq()方法:若是队列不存在或者使用CAS操做使节点入队失败,则进入此方法构造队列并将节点入队,在AQS中实现

/**
     * Inserts node into queue, initializing if necessary. See picture above.
     * @param node the node to insert
     * @return node's predecessor
     */
    private Node enq(final Node node) {

        //用一个死循环将当前节点添加进队列,若是队列不存在则建立队列
        for (;;) {
            Node t = tail;

            //尾节点为空则堆类不存在进行初始化队列,建立头节点
            if (t == null) { // Must initialize

                //使用CAS操做建立头节点,
                //为何式CAS操做,试想刚判断出队列不存在须要建立头节点,
                //此时线程发生线程的调度当前线程阻塞,另外一个线程作一样的操做并建立了队列
                //当前线程再次被唤醒后继续建立队列,会有线程安全问题
                if (compareAndSetHead(new Node()))
                    //尾节点指向头节点
                    tail = head;

            //队列存在死循环的将当前线程对应的节点放入到队列当中
            } else {
                node.prev = t;
                if (compareAndSetTail(t, node)) {
                    t.next = node;
                    return t;
                }
            }
        }
    }

acquireQueued()方法,对于排队等待的线程应当使其进行阻塞,减小调度以及CPU空转的时间,除非下一个就到了这个线程获取锁,在AQS中实现

这个方法的设计上若是自身是头节点的后继节点,那么有可能头节点会很快处理完成任务释放锁,本身就能够获取到锁,避免进行线程阻塞、唤醒操做,减小资源消耗

/**
     * Acquires in exclusive uninterruptible mode for thread already in
     * queue. Used by condition wait methods as well as acquire.
     *
     * @param node the node
     * @param arg the acquire argument
     * @return {@code true} if interrupted while waiting
     */
    final boolean acquireQueued(final Node node, int arg) {
        boolean failed = true;
        try {
            
            //当前线程中断的标志位
            boolean interrupted = false;
            for (;;) {
                //获取当前节点的前驱节点
                final Node p = node.predecessor();
                
                //前驱节点是头节点则尝试调用同步器的tryAcquire获取锁
                //第一次进入者方法时尝试一次获取锁,获取失败则会进行判断是否须要进行阻塞
                //若是须要阻塞则阻塞,若是不须要阻塞则会将前驱节点的waitStatus设置为SIGNAL,
                //再次循环获取锁失败,再次进入判断是否须要阻塞时必定会被阻塞
                //获取失败即使先驱节点是头节点也会被阻塞
                if (p == head && tryAcquire(arg)) {

                    //成功获取锁则将当前节点设置为头节点
                    setHead(node);
            
                    //原先区节点的下一个节点置空,
                    p.next = null; // help GC  //怎么help我的理解当当前节点称为头节点再被释放的时候,那么当前节点能够作到不可达,从而gc
                    
                    failed = false;
                    //返回线程在队列中等待期间是否被中断
                    return interrupted;
                }
                
                //在先驱节点不是头结点的状况下阻塞当前线程并使其睡眠
                //直到被其余线程唤醒,这样能够减小CPU的空转,提升效率
                //从阻塞唤醒后继续for循环直到获取到锁,
                if (shouldParkAfterFailedAcquire(p, node) &&
                    //阻塞当前线程直到有其余线程唤醒,并返回中断信息
                    parkAndCheckInterrupt())
                    //若是在线程阻塞休眠期间线程被中断则设置终端标记位,
                    interrupted = true;
            }
        } finally {
            //若是没有获取到锁(获取锁的过程出了意外),或者取消了获取锁,则取消当前线程获取锁的操做
            if (failed)
                cancelAcquire(node);
        }
    }

shouldParkAfterFailedAcquire()方法,在AQS中实现

/**
     * Checks and updates status for a node that failed to acquire.
     * Returns true if thread should block. This is the main signal
     * control in all acquire loops.  Requires that pred == node.prev.
     *
     * @param pred node's predecessor holding status
     * @param node the node
     * @return {@code true} if thread should block
     */
    private static boolean shouldParkAfterFailedAcquire(Node pred, Node node) {
        //获取先驱节点的等待状态
        int ws = pred.waitStatus;

        //SIGNAL前驱节点准备好唤醒后继节点,后继节点能够安全的阻塞
        if (ws == Node.SIGNAL)
            /*
             * This node has already set status asking a release
             * to signal it, so it can safely park.
             */
            return true;
        
        //大于0表示先驱节点已经被取消获取锁及排队
        if (ws > 0) {
            /*
             * Predecessor was cancelled. Skip over predecessors and
             * indicate retry.
             */
            //循环向前找到一个没有取消的节点
            do {
                node.prev = pred = pred.prev;
            } while (pred.waitStatus > 0);
            //更新先驱节点
            pred.next = node;
        } else {
            /*
             * waitStatus must be 0 or PROPAGATE.  Indicate that we
             * need a signal, but don't park yet.  Caller will need to
             * retry to make sure it cannot acquire before parking.
             */
            //// 更新pred结点waitStatus为SIGNAL
            compareAndSetWaitStatus(pred, ws, Node.SIGNAL);
        }
        return false;
    }

parkAndCheckInterrupt()方法,调用LockSupport.park()阻塞指定线程,在AQS中实现

/**
     * Convenience method to park and then check if interrupted
     *
     * @return {@code true} if interrupted
     */
    private final boolean parkAndCheckInterrupt() {
        //阻塞当前线程,直到其余线程调用LockSupport.unpark(当前线程),
        //使得调用unpark的线程释放锁后当前线程被唤醒并返回在阻塞期间线程是否被中断
        LockSupport.park(this);
        return Thread.interrupted();
    }

cancelAcquire()方法,取消获取锁,在AQS中实现

/**
     * Cancels an ongoing attempt to acquire.
     *
     * @param node the node
     */
    private void cancelAcquire(Node node) {
        // Ignore if node doesn't exist
        if (node == null)
            return;
        
        //节点的线程置null
        node.thread = null;

        // Skip cancelled predecessors

        Node pred = node.prev;
        //若是前驱节点已经取消,那么循环向前找到一个没有取消的节点并设置当前节点的前驱节点
        while (pred.waitStatus > 0)
            node.prev = pred = pred.prev;

        // predNext is the apparent node to unsplice. CASes below will
        // fail if not, in which case, we lost race vs another cancel
        // or signal, so no further action is necessary.
        Node predNext = pred.next;

        // Can use unconditional write instead of CAS here.
        // After this atomic step, other Nodes can skip past us.
        // Before, we are free of interference from other threads.
        //设置当前节点状态为已经取消获取锁
        node.waitStatus = Node.CANCELLED;

        // If we are the tail, remove ourselves.
        //若是节点自身时队尾,则移除节点并使用CAS操做设置队尾
        if (node == tail && compareAndSetTail(node, pred)) {
            compareAndSetNext(pred, predNext, null);
        } else {
            // If successor needs signal, try to set pred's next-link
            // so it will get one. Otherwise wake it up to propagate.
            int ws;

            //前驱节点不是头节点,则当前节点就须要阻塞
            //前驱节点线程不为null,则保证存在前驱节点
            //前驱节点没有被取消,waitStatus能够被设置为SIGNAL保证能够唤醒后继节点
            if (pred != head &&
                ((ws = pred.waitStatus) == Node.SIGNAL ||
                 (ws <= 0 && compareAndSetWaitStatus(pred, ws, Node.SIGNAL))) &&
                pred.thread != null) {
                Node next = node.next;

                //写一个节点存在而且没有被取消,则CAS的将前驱节点的后继节点设置为当前节点的后继节点
                if (next != null && next.waitStatus <= 0)
                    compareAndSetNext(pred, predNext, next);
            } else {
                //不然唤醒后继线程
                unparkSuccessor(node);
            }

            node.next = node; // help GC
        }
    }

至此,公平锁的加锁操做所有结束(或者已经取消获取锁),在同步等待队列中等待的线程,若是对应的节点的先驱节点不是头节点,则线程会被阻塞减小调度。

公平锁的公平的保证时靠加锁时判断当前锁对应的同步等待队列中存在等待的队列,若是有则当前线程入队,排队来保证的;
若是当前锁没有被获取,而且队列不存在或者队列中没有等待的线程则能够直接加锁。回到acquire()方法,若是在线程等等待的过程当中发生了中断,
那么获取到所以后会还原中断。

公平锁的解锁

经过加锁的过程能够发现,锁被获取的次数经过给state字段增长和设置锁所属的线程exclusiveOwnerThread来完成加锁操做,
那么当线程须要解锁的时候应该也是对这两个字段的操做,且解锁必定在加锁以后,所以不存在进入同步等待队列等待的过程。

解锁入口:unlock()方法;unlock()方法定义在ReentrantLock类里面,经过调用同步器的解锁操做完成解锁过程,公平机制不影响对外暴露的接口
代码具体解释见注释

/**
     * Attempts to release this lock.
     *
     * <p>If the current thread is the holder of this lock then the hold
     * count is decremented.  If the hold count is now zero then the lock
     * is released.  If the current thread is not the holder of this
     * lock then {@link IllegalMonitorStateException} is thrown.
     *
     * @throws IllegalMonitorStateException if the current thread does not
     *         hold this lock
     */
    //尝试释放获取的锁,调用到release方法,这个方法在AQS中实现
    public void unlock() {
        sync.release(1);
    }

release()方法,在AQS中实现

/**
     * Releases in exclusive mode.  Implemented by unblocking one or
     * more threads if {@link #tryRelease} returns true.
     * This method can be used to implement method {@link Lock#unlock}.
     *
     * @param arg the release argument.  This value is conveyed to
     *        {@link #tryRelease} but is otherwise uninterpreted and
     *        can represent anything you like.
     * @return the value returned from {@link #tryRelease}
     */
    //释放持有的排他锁
    public final boolean release(int arg) {
        //调用tryRelease()来释放锁,由同步器实现
        //tryRelease方法的解释在同步器章节
        //若是有线程在同步等待队列中等待获取锁,
        //那么还应该唤醒等待的线程
        if (tryRelease(arg)) {
            //若是存在同步等待队列,那么当前节点解锁成功后回将自身节点设置为头节点
            //所以这里的头节点就是自身当前线程的节点
            //可是在加锁成功的时候会将节点的thread字段设置为null,所以没法比对判断
            Node h = head;

            //后继线程在阻塞前之前会将前驱结点的waitStatus设置为SIGNAL=-1,所以不为0即须要唤醒后继节点
            //为何是不为0,而不是等于-1??由于node有1,-1,-2,-3和0五种状况
            //0表明默认状态,node节点刚被建立,
            //1表明当前节点已经取消获取锁,
            //-1表明有后继节点须要唤醒
            //-2表明节点在条件等待队列中等待,也就是不会出如今同步等待队列
            //-3表明共享模式,
            //若是在获取到锁而且已经存在后继节点的时候取消获取锁,那么节点就会使1,
            //直接点线程被唤醒完成加锁操做后释放锁,他的waitStatus使1而不是-1,所以使用的是waitStatus != 0
            if (h != null && h.waitStatus != 0)
                //唤醒后继节点
                unparkSuccessor(h);
            return true;
        }
        return false;
    }

unparkSuccessor()方法唤醒后继节点,在AQS中实现

/**
     * Wakes up node's successor, if one exists.
     *
     * @param node the node
     */
    //唤醒头结点的后继节点
    private void unparkSuccessor(Node node) {
        /*
         * If status is negative (i.e., possibly needing signal) try
         * to clear in anticipation of signalling.  It is OK if this
         * fails or if status is changed by waiting thread.
         */
        int ws = node.waitStatus;
        //头节点的状态<0,则在发出唤醒信号以前尝试清除这个状态,即将头节点的状态设置为0,
        //容许失败或者被等待的线程改变
        if (ws < 0)
            compareAndSetWaitStatus(node, ws, 0);

        /*
         * Thread to unpark is held in successor, which is normally
         * just the next node.  But if cancelled or apparently null,
         * traverse backwards from tail to find the actual
         * non-cancelled successor.
         */
        Node s = node.next;
        //下一个节点不存在或者取消了获取锁,则沿着队列从后往前找到第一个没有取消的节点
        if (s == null || s.waitStatus > 0) {
            s = null;
            for (Node t = tail; t != null && t != node; t = t.prev)
                if (t.waitStatus <= 0)
                    s = t;
        }
        //唤醒没有取消获取锁的第一个节点
        if (s != null)
            LockSupport.unpark(s.thread);
    }

至此可重入锁的公平模式的加锁和解锁所有结束

问题:在解锁的最后一步调用了LockSupport.unpark()来解锁,
而一个线程B进入同步等待队列阻塞的时候根据先去接点的waitState==-1来判断是否须要阻塞,
那么在他判断完前驱节点线程A waitState==-1成立而后发生系统调度,执行其余线程,
而这时候线程A获取锁并解锁调用了LockSupport.unpark(),而后执行线程B
线程B会执行阻塞的过程,线程B会被阻塞掉,而后后面的节点都不能获取锁么?

非公平锁

除了公平的加锁方式,可重入锁还提供了非公平模式(默认)的加锁。在非公平模式下只要锁尚未被其余线程获取,就有机会成功获取锁,
固然已加入到队列中的线程仍是要按照顺序排队获取。这样作会减小须要阻塞、唤醒的线程,下降因为阻塞、唤醒带来的额外开销,
可是在队列中等待的线程可能会被活活饿死(很惨的那种,出了问题排查的时候)

非公平锁同步器

/**
     * Sync object for non-fair locks
     */
    static final class NonfairSync extends Sync {
        private static final long serialVersionUID = 7316153563782823691L;

        /**
         * Performs lock.  Try immediate barge, backing up to normal
         * acquire on failure.
         */
        final void lock() {
            //和公平锁最大的区别
            //若是当前锁没有被其余线程获取则直接尝试加锁
            //没有被其余线程获取体如今参数值是0
            if (compareAndSetState(0, 1))
                setExclusiveOwnerThread(Thread.currentThread());
            else
                //调用AQS的acquire方法请求加锁,和公平锁一致
                acquire(1);
        }

        protected final boolean tryAcquire(int acquires) {
            //调用父类Sync的nonfairTryAcquire请求加锁
            return nonfairTryAcquire(acquires);
        }
    }

非公平锁加锁

加锁入口同公平模式:

public void lock() {
        //都是调用到同步器的lock方法
        sync.lock();
    }

lock()直接调用同步器实现的lock()

/**
         * Performs lock.  Try immediate barge, backing up to normal
         * acquire on failure.
         */
        final void lock() {
            //在这里无论是否有线程在排队,直接尝试加锁
            if (compareAndSetState(0, 1))
                setExclusiveOwnerThread(Thread.currentThread());
            else
                //加锁失败则调用AQS的acquire方法
                acquire(1);
        }

acquire()方法在AQS中实现,和公平锁的一致,方便阅读就再写一次

具体解释见注释

//以独占的方法加锁,而且忽略中断
    //那是否是还有响应中断的加锁呢??
    public final void acquire(int arg) {
        //先尝试调用同步器的tryAcquire()方法加锁
        if (!tryAcquire(arg) &&
            //加锁失败的状况下将当前线程放入同步等待队列中
            acquireQueued(addWaiter(Node.EXCLUSIVE), arg))
            
            //acquireQueued返回值是线程在等待期间是否被中断,若是有则还原中断现场
            selfInterrupt();
    }

同步器的tryAcquire()方法见非公平模式的同步器,会调用到SyncnonfairTryAcquire()方法,

若是加锁失败则会依次构建同步等待队列->尝试加锁->失败则判断是否须要进行阻塞->是则阻塞等待前驱节点唤醒->尝试加锁这样的流程

这个流程同公平锁

//默认提供了非公平机制的加锁过程
        //acquires 申请加锁的次数,通常状况下是一次,可是有屡次的状况,在Condition中会看到
        final boolean nonfairTryAcquire(int acquires) {
            final Thread current = Thread.currentThread();
            //获取锁的状态,getState在AQS中实现
            int c = getState();
            //锁空闲
            if (c == 0) {
                //加锁,加锁成功设置锁的属于哪一个线程信息
                if (compareAndSetState(0, acquires)) {
                    setExclusiveOwnerThread(current);
                    return true;
                }
            }
            //当前线程已经成功获取了锁,这块也是锁的可重入性的体现
            else if (current == getExclusiveOwnerThread()) {
                //将锁的持有次数加给定的次数便可
                int nextc = c + acquires;
                if (nextc < 0) // overflow
                    throw new Error("Maximum lock count exceeded");
                //设置加锁次数
                setState(nextc);
                return true;
            }
            return false;
        }

非公平锁的解锁

非公平锁的解锁过程同公平锁,释放过程不存在公平于非公平,具体逻辑所有由SyncAQS实现;

公平锁和非公平锁的加锁流程图


ReentrantLock提供的一些其余方法


方法名称 返回值类型 方法描述
lockInterruptibly() void 以响应中断的方式获取锁,若是在锁获取以前发生中断直接抛出中断异常,在从同步等待队列中被唤醒后检查在等待期间是否有中断发生,若是有则抛出中断异常
tryLock() boolean 尝试一次以非公平模式获取锁,当且仅当锁没有被获取时有可能获取成功,即使锁私用的是公平模式,直接调用 Sync的非公平模式获取一次锁,返回获取结果
tryLock(long timeout, TimeUnit unit) boolean 含有超时等待功能的获取锁,若是线程进入同步等待队列阻塞,则只会阻塞指定的时间,这个功能由LockSupport类提供
newCondition() Condition 获取一个Condition对象,能够提供相似Object Moitor同样的功能
getHoldCount() int 获取持有锁的次数,通常用于测试锁
isHeldByCurrentThread boolean 检查当前线程是否持有这个锁
isLocked boolean 检查锁是否被任何一个线程获取
isFair() boolean 检查当前锁是不是公平锁
getOwner() Thread 获取持有锁的线程
hasQueuedThreads() boolean 同步等待队列是否有线程等待获取锁
hasQueuedThread(Thread thread) boolean 判断指定线程是否在同步等待队列中等待
getQueueLength() int 获取同步等待对列的长度,队列中的线程不必定都是等待获取锁的线程,还有可能已经取消
hasWaiters(Condition condition) boolean 判断给定的condition中是否由线程等待
getWaitQueueLength(Condition condition) int 获取给定condition中等待队列的长度
getWaitingThreads(Condition condition) Collection<Thread> 获取给定的condition中全部的等待线程

Condition

ReentrantLock中提供了一个newCondition()方法,
利用返回的Condition对象能够实现Object.wait()、Object.notify()、Object.notifyAll()等功能,而且具备更强大的功能。
返回的Condition的实现是在AQS当中实现,因此这个放在AQS学习完了写。


\(\color{#FF3030}{转载请标明出处}\)

附ReentrantLock所有源码理解


/**
 * 一个能够重入的排他锁基本的行为和语义与使用synchronized做为
 * 隐式的锁的监听器是同样的,可是实现了更多的功能 
 *
 * 一个可重入锁后被最后一次成功加锁可是没有解锁的线程持有
 * 当一个锁没有被不被任何一个线程持有,这是一个线程来申请这个锁将会被申请成功
 * 可使用{@link #isHeldByCurrentThread}, 和 {@link
 * #getHoldCount}检查当前线程是否持有锁
 *
 * 这个类的构造器提供了一个fairness参数来设定是否公平
 * <当设置为true时,是个公平锁,锁老是被当前等待时间最长的线程获取
 * 不然不能保证将按照何种顺序获取该锁
 * 使用公平锁的程序吞吐量比默认(非公平锁)更小
 * 可是在得到此线程和保证保证不被饿死方面会比默认更好
 * 然而锁的g公平性并不保证线程的公平性。所以使用公平锁的
 * 所以使用公平锁的的多个线程可能有一个会屡次得到他,而其余线程可能一次也没有
 *
 * 注意:随机的tryLock并不支持公平性,
 * 只要锁可用即便有其余线程正在等待也能够获取他
 *
 * 在使用lock后使用try语句而且将unlock放在finally中
 *
 * 除了实现{@link Lock}接口外,
 * 还有这个类定义了许多检查锁状态的方法。
 * 其中的一些方法方法只对检测和监视有用
 *
 * <p>Serialization of this class behaves in the same way as built-in
 * locks: a deserialized lock is in the unlocked state, regardless of
 * its state when serialized.
 *
 * <p>这个锁最多支持冲入2147483647 次(递归调用)
 *
 */
public class ReentrantLock implements Lock, java.io.Serializable {
    private static final long serialVersionUID = 7373984872572414699L;
    /** Synchronizer providing all implementation mechanics */
    private final Sync sync;

    /**
     * Base of synchronization control for this lock. Subclassed
     * into fair and nonfair versions below. Uses AQS state to
     * represent the number of holds on the lock.
     */
    abstract static class Sync extends AbstractQueuedSynchronizer {
        private static final long serialVersionUID = -5179523762034025860L;

        /**
         * Performs {@link Lock#lock}. The main reason for subclassing
         * is to allow fast path for nonfair version.
         */
        abstract void lock();

        /**
         * Performs non-fair tryLock.  tryAcquire is implemented in
         * subclasses, but both need nonfair try for trylock method.
         */
        final boolean nonfairTryAcquire(int acquires) {
            final Thread current = Thread.currentThread();
            int c = getState();
            if (c == 0) {
                if (compareAndSetState(0, acquires)) {
                    setExclusiveOwnerThread(current);
                    return true;
                }
            }
            else if (current == getExclusiveOwnerThread()) {
                int nextc = c + acquires;
                if (nextc < 0) // overflow
                    throw new Error("Maximum lock count exceeded");
                setState(nextc);
                return true;
            }
            return false;
        }

        protected final boolean tryRelease(int releases) {
            int c = getState() - releases;
            if (Thread.currentThread() != getExclusiveOwnerThread())
                throw new IllegalMonitorStateException();
            boolean free = false;
            if (c == 0) {
                free = true;
                setExclusiveOwnerThread(null);
            }
            setState(c);
            return free;
        }

        protected final boolean isHeldExclusively() {
            // While we must in general read state before owner,
            // we don't need to do so to check if current thread is owner
            return getExclusiveOwnerThread() == Thread.currentThread();
        }

        final ConditionObject newCondition() {
            return new ConditionObject();
        }

        // Methods relayed from outer class

        final Thread getOwner() {
            return getState() == 0 ? null : getExclusiveOwnerThread();
        }

        final int getHoldCount() {
            return isHeldExclusively() ? getState() : 0;
        }

        final boolean isLocked() {
            return getState() != 0;
        }

        /**
         * Reconstitutes the instance from a stream (that is, deserializes it).
         */
        private void readObject(java.io.ObjectInputStream s)
            throws java.io.IOException, ClassNotFoundException {
            s.defaultReadObject();
            setState(0); // reset to unlocked state
        }
    }

    /**
     * 可重入锁非公平同步器
     */
    static final class NonfairSync extends Sync {
        private static final long serialVersionUID = 7316153563782823691L;

        /**
         * 加锁.  Try immediate barge, backing up to normal
         * acquire on failure.
         */
        final void lock() {
                
                       //使用cas操做加锁,成功的话将锁的拥有线程置为本身
            if (compareAndSetState(0, 1))
                setExclusiveOwnerThread(Thread.currentThread());
            else
                    //排他模式获取,忽略中断,经过再次调用tryAcquire获取锁,
                        //获取失败将进入等待队列,可能会重复的阻塞和取消阻塞,
                        //直到调用tryAcquire获取锁成功
                acquire(1);
        }
                //实现AQS的tryAcquire()方法(该方法进行一次尝试获取锁)
        protected final boolean tryAcquire(int acquires) {
            return nonfairTryAcquire(acquires);
        }
    }

    /**
     * 可重入锁的公平同步器
     */
    static final class FairSync extends Sync {
        private static final long serialVersionUID = -3000897897090466540L;

                 //公平模式与非公平模式的区别,公平模式下全部的所获取都会检查当前的等待队列
                //非公平锁能够进行抢占,即使有等待队列中有等待的线程,只要锁对象没有加锁成功,既能够被加锁
        final void lock() {
            acquire(1);
        }

        /**
         * 实现AQS的tryAcquire方法,加锁时会检查当前锁的等待队列的实际元素
         * 当等待队列为空(头节点==尾节点)或者头结点的下一个节点对应的线程试当前的线程能够加锁成功
                  *   若是当前线程已经持有
         */
        protected final boolean tryAcquire(int acquires) {
            final Thread current = Thread.currentThread();
            int c = getState();
            if (c == 0) {
                if (!hasQueuedPredecessors() &&
                    compareAndSetState(0, acquires)) {
                    setExclusiveOwnerThread(current);
                    return true;
                }
            }
            else if (current == getExclusiveOwnerThread()) {
                int nextc = c + acquires;
                if (nextc < 0)
                    throw new Error("Maximum lock count exceeded");
                setState(nextc);
                return true;
            }
            return false;
        }
    }

    /**
     * 建立一个可重入锁.非公平模式
     * 与使用 {@code ReentrantLock(false)}.建立效果同样
     */
    public ReentrantLock() {
        sync = new NonfairSync();
    }

    /**
     * 建立给定模式(公平或者非公平)的可重入锁
     * @param fair {@codetrue} 使用公平模式
     */
    public ReentrantLock(boolean fair) {
        sync = fair ? new FairSync() : new NonfairSync();
    }

    /**
     * 获取锁.
     *
     * <p>若是这个锁没有被其余线程持有,则获取锁并马上返回,
     * 将锁的计数器记为1
     *
     * 若是当前线程已经持有锁,则将锁的计数器自增1,
     * 而且马上返回
     *
     * <p>若是锁被其余线程持有
     * 那么当前线程将会由于线程调度缘由设置禁用而且为休眠状态,
     * 而且在锁被获取以前处于休眠状态
     * at which time the lock hold count is set to one.
     */
    public void lock() {
        sync.lock();
    }

    /**
     * 获取锁直到当前线程被阻塞
     *
     * <p>若是锁没被其余的线程获取则获取锁并返回
     *
     * 若是锁已经被当前线程获取,则将锁的计数器自增
     *
     * 若是锁被其余线程持有
     * 处于线程调度的目的会将当前线程设置为禁用而且为休眠状态
     * 直到如下两种状况中的一种发生:
     *
     * <ul>
     *
     * <li>当前线程获取到锁; or
     *
     * <li>其余的线程中断了当前的线程
     *
     * </ul>
     *
     * <p>若是当前线程获取到了锁,那么将锁的计数器设置为1
     *
     * <p>若是当前线程
     *
     * 在进入这个方法的时候中断状态已经被设置; 
     * 或者在获取锁的过程当中被中断
     *
     * InterruptedException异常将会被抛出而且清除中断标记位
     *
     * @throws InterruptedException if the current thread is interrupted
     */
    public void lockInterruptibly() throws InterruptedException {
           //该方法会先检查当前线程是否被中断,而后调用tryAcquire获取锁
                //获取失败则调用doAcquireInterruptibly
                //这个方法和忽略中断的加锁acquireQueue基本相同,不一样点是
                //当线程在调用LockSupport.park(this)被唤醒后,Lock方法会忽略是否该线程被中断,
                //若被中断该方法会抛出线程中断异常
                sync.acquireInterruptibly(1);
    }

    /**
     * 当且仅当锁没被其余线程获取时才获取锁
     *
     * <p>当且仅当锁没被其余线程获取时获取锁而且返回ture,设置锁的计数器为1
     * 即便这个锁被设定为公平锁,只要没有其余线程获取到锁,使用tryLock也能马上获取到锁
     * 不管是否有其余线程在排队
     * 即便这种行为破坏了公平,但在某些状况下是有用的
     * 若是想要这个锁的公平设置可使用
     * {@link #tryLock(long, TimeUnit) tryLock(0, TimeUnit.SECONDS) }
     * 这二者几乎是的等价的 (依然会检测中断).
     *
     * 若是当前线程已经持有锁,那么将锁计数器自增长一
     *
     * 若是当前锁被其余线程持有,那么返回false
     *
     * @return {@code true} if the lock was free and was acquired by the
     *         current thread, or the lock was already held by the current
     *         thread; and {@code false} otherwise
     */
    public boolean tryLock() {
            //与非公平锁tryAcquire方法内容相同
        return sync.nonfairTryAcquire(1);
    }

    /**
     * 在超时等待的时间内获取到锁而且线程没有被中断
     *
     * 若是在超时等待的时间内获取到锁而且没有被中断,锁没有被其余线程持有
         * 将返回true,同时将锁计数器设置为1
     * 若是当前锁使用的是公平锁的模式
     * 有其余的线程在等待这个锁,都不能获取到锁这个功能由(tryAcquire实现)
     * 若是想要在超时等待的时间内破坏锁的公平性获取锁能够和TryLock联合使用
     *
     *  <pre> {@code
     * if (lock.tryLock() ||
     *     lock.tryLock(timeout, unit)) {
     *   ...
     * }}</pre>
     *
     * <p>若是当前的线程已经拥有锁那么将锁计数器自增长一(tryAcquire实现)
     *
     * <p>若是锁被其余线程持有那么处于线程调度的目的会将当前线程置为不可用
     * 而且睡眠直到下面一种事情发生:
     *
     * <ul>
     *
     * <li>锁被当前线程获取,或者
     *
     * <li>其余线程中断了当前线程
     *
     * <li>时间超过了设置的等待时间
     *
     * </ul>
     *
     * <p>若是获取到了锁将返回ture,而且将锁计数器设置为1
     *
     * <p>若是当前线程
     *
     * <ul>
     *
     * <li>在进入这个方法以前,中断标记位被设置
     *
     * 或者获取锁的时候被中断
     *
     * </ul>
     * 会抛出 {@link InterruptedException} 异常,而且清楚中断标记位
     *
     * <p>若是超过了设置的等待时间将会返回false(其实还会尝试获取一次锁)
     * 若是设置的超时等待时间少于等于0,这个方法不会一直等待
     *
     * <p>这个方法会先响应中断,而不是锁的获取和等待
     *
     * @param timeout the time to wait for the lock
     * @param unit the time unit of the timeout argument
     * @return {@code true} if the lock was free and was acquired by the
     *         current thread, or the lock was already held by the current
     *         thread; and {@code false} if the waiting time elapsed before
     *         the lock could be acquired
     * @throws InterruptedException if the current thread is interrupted
     * @throws NullPointerException if the time unit is null
     */
    public boolean tryLock(long timeout, TimeUnit unit)
            throws InterruptedException {
        return sync.tryAcquireNanos(1, unit.toNanos(timeout));
    }

    /**
     * 试图释放锁
     *
     * <p>若是当前线程是锁的持有者,则锁的计数器自减1,
     * 若是锁的计数器为0,则释放锁
     * 若是当前线程不是锁的持有者,将抛出异常
         * 释放锁成功后若是等待队列中还有等待的线程,那么调用lockSupport.unspark唤醒等待的线程
     * {@link IllegalMonitorStateException}.
     *
     * @throws IllegalMonitorStateException if the current thread does not
     *         hold this lock
     */
    public void unlock() {
        sync.release(1);
    }

    /**
     * Returns a {@link Condition} instance for use with this
     * {@link Lock} instance.
     *
     * <p>The returned {@link Condition} instance supports the same
     * usages as do the {@link Object} monitor methods ({@link
     * Object#wait() wait}, {@link Object#notify notify}, and {@link
     * Object#notifyAll notifyAll}) when used with the built-in
     * monitor lock.
     *
     * <ul>
     *
     * <li>If this lock is not held when any of the {@link Condition}
     * {@linkplain Condition#await() waiting} or {@linkplain
     * Condition#signal signalling} methods are called, then an {@link
     * IllegalMonitorStateException} is thrown.
     *
     * <li>When the condition {@linkplain Condition#await() waiting}
     * methods are called the lock is released and, before they
     * return, the lock is reacquired and the lock hold count restored
     * to what it was when the method was called.
     *
     * <li>If a thread is {@linkplain Thread#interrupt interrupted}
     * while waiting then the wait will terminate, an {@link
     * InterruptedException} will be thrown, and the thread's
     * interrupted status will be cleared.
     *
     * <li> Waiting threads are signalled in FIFO order.
     *
     * <li>The ordering of lock reacquisition for threads returning
     * from waiting methods is the same as for threads initially
     * acquiring the lock, which is in the default case not specified,
     * but for <em>fair</em> locks favors those threads that have been
     * waiting the longest.
     *
     * </ul>
     *
     * @return the Condition object
     */
    public Condition newCondition() {
        return sync.newCondition();
    }

    /**
     * 查询锁被当前线程加锁的次数
     *
     * <p>线程对于每一个加锁的操做都有一个对应的解锁操做
     *
     * <p>这个操做一般只被用来测试和调试
     * For example, if a certain section of code should
     * not be entered with the lock already held then we can assert that
     * fact:
     *
     *  <pre> {@code
     * class X {
     *   ReentrantLock lock = new ReentrantLock();
     *   // ...
     *   public void m() {
     *     assert lock.getHoldCount() == 0;
     *     lock.lock();
     *     try {
     *       // ... method body
     *     } finally {
     *       lock.unlock();
     *     }
     *   }
     * }}</pre>
     *
     * @return the number of holds on this lock by the current thread,
     *         or zero if this lock is not held by the current thread
     */
    public int getHoldCount() {
        return sync.getHoldCount();
    }

    /**
     * 检查当前线程是否持有这个锁
     *
     * <p>Analogous to the {@link Thread#holdsLock(Object)} method for
     * built-in monitor locks, this method is typically used for
     * debugging and testing. For example, a method that should only be
     * called while a lock is held can assert that this is the case:
     *
     *  <pre> {@code
     * class X {
     *   ReentrantLock lock = new ReentrantLock();
     *   // ...
     *
     *   public void m() {
     *       assert lock.isHeldByCurrentThread();
     *       // ... method body
     *   }
     * }}</pre>
     *
     * <p>It can also be used to ensure that a reentrant lock is used
     * in a non-reentrant manner, for example:
     *
     *  <pre> {@code
     * class X {
     *   ReentrantLock lock = new ReentrantLock();
     *   // ...
     *
     *   public void m() {
     *       assert !lock.isHeldByCurrentThread();
     *       lock.lock();
     *       try {
     *           // ... method body
     *       } finally {
     *           lock.unlock();
     *       }
     *   }
     * }}</pre>
     *
     * @return {@code true} if current thread holds this lock and
     *         {@code false} otherwise
     */
    public boolean isHeldByCurrentThread() {
        return sync.isHeldExclusively();
    }

    /**
     * 检查这个锁是否被任意一个线程持有(检查锁的计数器state是不是0)
     * 这个方法用来监控系统状态,而不是用来同步,
     *
     * @return {@code true} if any thread holds this lock and
     *         {@code false} otherwise
     */
    public boolean isLocked() {
        return sync.isLocked();
    }

    /**
     * 测试当前锁是公平锁仍是非公平锁
     *
     * @return {@code true} if this lock has fairness set true
     */
    public final boolean isFair() {
        return sync instanceof FairSync;
    }

    /**
     * 获取当前拥有锁的线程,若是没有线程持有,则返回null
     * 此方法的目的是为了方便构造提供更普遍的锁监视设施的子类。
     *
     * @return the owner, or {@code null} if not owned
     */
    protected Thread getOwner() {
        return sync.getOwner();
    }

    /**
     * 检查是否有现成正在等待获取此锁(head!=tail) Note that
     * 由于线程取消获取锁可能发生在任什么时候间,因此返回值为true不能保证
     * 必定有其余线程在获取此锁,(好比等待队列中的线程已经取消获取此锁)
     * 这个方法的设计被用来监控系统
     *
     * @return {@code true} if there may be other threads waiting to
     *         acquire the lock
     */
    public final boolean hasQueuedThreads() {
        return sync.hasQueuedThreads();
    }

    /**
     * 判断给定的线程是否在等待这个锁
     * 线程取消获取锁可能发生在任什么时候间, 
     * true的返回值不表明这个线程还在等待获取这个锁
     * 这个方法的设计被用来监控系统
     *
     * @param thread the thread
     * @return {@code true} if the given thread is queued waiting for this lock
     * @throws NullPointerException if the thread is null
     */
    public final boolean hasQueuedThread(Thread thread) {
        return sync.isQueued(thread);
    }

    /**
     * 返回等待队列中等待获取锁的数量的估计值
     * 这个方法返回的是一个估计值由于队列中的线程数量可能在变化
     * 这个方法的设计被用来监控系统
     *
     * @return the estimated number of threads waiting for this lock
     */
    public final int getQueueLength() {
        return sync.getQueueLength();
    }

    /**
     * 返回一个线程集合,集合中的线程可能在等待获取锁
     * 由于线程获取锁可能被取消因此获取到的集合不是准确的
     * 此方法的目的是为了方便构造提供更普遍的锁监视设施的子类
     *
     * @return the collection of threads
     */
    protected Collection<Thread> getQueuedThreads() {
        return sync.getQueuedThreads();
    }

    /**
     * 查询与这个锁关联的condition是否有线程正在等待,便是否有现成调用过与
     * await方法.由于等待超时和线程中断发生在任什么时候候
     * 因此返回值true不表明未来会有信号来唤醒线程
     *  这个方法的设计被用来监控系统
     *
     * @param condition the condition
     * @return {@code true} if there are any waiting threads
     * @throws IllegalMonitorStateException if this lock is not held
     * @throws IllegalArgumentException if the given condition is
     *         not associated with this lock
     * @throws NullPointerException if the condition is null
     */
    public boolean hasWaiters(Condition condition) {
        if (condition == null)
            throw new NullPointerException();
        if (!(condition instanceof AbstractQueuedSynchronizer.ConditionObject))
            throw new IllegalArgumentException("not owner");
               //经过检查condition队列是中的节点是否处于condition状态实现
        return sync.hasWaiters((AbstractQueuedSynchronizer.ConditionObject)condition);
    }

    /**
     * 返回与锁相关的指定的condition的队列中的线程数量,注意这是个估计值
     * 由于线程等待超时和中断发生在任什么时候间
     * 所以队列一直在动态的变化,可能尚未统计完就已经发生了变化.
     *
     * @param condition the condition
     * @return the estimated number of waiting threads
     * @throws IllegalMonitorStateException if this lock is not held
     * @throws IllegalArgumentException if the given condition is
     *         not associated with this lock
     * @throws NullPointerException if the condition is null
     */
    public int getWaitQueueLength(Condition condition) {
        if (condition == null)
            throw new NullPointerException();
        if (!(condition instanceof AbstractQueuedSynchronizer.ConditionObject))
            throw new IllegalArgumentException("not owner");
        return sync.getWaitQueueLength((AbstractQueuedSynchronizer.ConditionObject)condition);
    }

    /**
     * 返回与锁相关的指定的condition的队列中的线程集合
     * 返回的集合只是一个估计值,
     * 由于线程等待超时和中断发生在任什么时候间
     *
     * @param condition the condition
     * @return the collection of threads
     * @throws IllegalMonitorStateException if this lock is not held
     * @throws IllegalArgumentException if the given condition is
     *         not associated with this lock
     * @throws NullPointerException if the condition is null
     */
    protected Collection<Thread> getWaitingThreads(Condition condition) {
        if (condition == null)
            throw new NullPointerException();
        if (!(condition instanceof AbstractQueuedSynchronizer.ConditionObject))
            throw new IllegalArgumentException("not owner");
        return sync.getWaitingThreads((AbstractQueuedSynchronizer.ConditionObject)condition);
    }

    /**
     * Returns a string identifying this lock, as well as its lock state.
     * The state, in brackets, includes either the String {@code "Unlocked"}
     * or the String {@code "Locked by"} followed by the
     * {@linkplain Thread#getName name} of the owning thread.
     *
     * @return a string identifying this lock, as well as its lock state
     */
    public String toString() {
        Thread o = sync.getOwner();
        return super.toString() + ((o == null) ?
                                   "[Unlocked]" :
                                   "[Locked by thread " + o.getName() + "]");
    }
}
相关文章
相关标签/搜索