LinkedBlockingQueue源码分析

这几周陆续都有其他事情,项目跟进,回学校答辩等等。耽误了博客的更新力度,趁着现在有点时间空余,接着看看其他的内容。本次的主角依然是列表家族的常用成员-LinkedBlockingQueue。

LinkedBlockingQueue简单介绍

LinkedBlockingQueue作为一个链表式的阻塞队列,他与ArrayBlockingQueue的却别就好比LinkedList于ArrayList的区别一样,但是它更常用于线程池的构造函数中作为阻塞队列出现,而且为了避免队列长度的无限制增长一般需要限制阻塞列表的长度。

源码分析

类定义

/**
 *都是一些常规的方法抽象
 */
public class LinkedBlockingQueue<E> extends AbstractQueue<E>
        implements BlockingQueue<E>, java.io.Serializable 

属性分析

    /**队列容量(重要,如果没有给出的话就默认为Integer.MAX_VALUE) */
    private final int capacity;

    /**队列实际长度(这里不能指定int,否则final修改会出错,但是因为是线程安全的队列,所以使用AutomicInteger)*/
    private final AtomicInteger count = new AtomicInteger(0);

    /**
     * 头部节点(这里的transient在以前的博文中介绍过)
     */
    private transient Node<E> head;

    /**
     * 尾部节点
     */
    private transient Node<E> last;

    /** take, poll等操作需要的锁 */
    private final ReentrantLock takeLock = new ReentrantLock();

    /** takeLock对应的Condition */
    private final Condition notEmpty = takeLock.newCondition();

    /** put, offer需要的锁*/
    private final ReentrantLock putLock = new ReentrantLock();

    /** putLock对应的Condition*/
    private final Condition notFull = putLock.newCondition();

内部类

    static class Node<E> {
        E item;
        /** 指向下一个节点的指针*/
        Node<E> next;

        Node(E x) { item = x; }
    }

构造函数

    public LinkedBlockingQueue() {
        this(Integer.MAX_VALUE); 
    }
    /**
     * 默认初始化容量为给定的值,没有给定就初始为Integer.MAX_VALUE
     */
    public LinkedBlockingQueue(int capacity) {
        if (capacity <= 0) throw new IllegalArgumentException();
        this.capacity = capacity;
        last = head = new Node<E>(null);
    }
    /**
     *将c中的数据塞到队列中,并初始化队列长度为Integer.MAX_VALUE而不是c.size();
     */
    public LinkedBlockingQueue(Collection<? extends E> c) {
        this(Integer.MAX_VALUE);
        //这里统一说下这种写法的好处(JDK源码中处处可见):
        //1.避免直接饮用成员变量,引用局部变量的引用更加迅速。
        //2.当成员变量出现被其他线程改变时,因为在内部重新将饮用定义为final,所以在方法内部的数据是一致的。
        //3.让代码更短,如果成员变量(静态变量)更长的话可以定义一个短一点的名字
        final ReentrantLock putLock = this.putLock;
        putLock.lock(); 
        try {
            int n = 0;
            for (E e : c) {
                if (e == null)
                    throw new NullPointerException();
                if (n == capacity)
                    throw new IllegalStateException("Queue full");
                enqueue(new Node<E>(e));
                ++n;
            }
            count.set(n);
        } finally {
            putLock.unlock();
        }
    }
    

基础方法

    private void enqueue(Node<E> node) {
        // assert putLock.isHeldByCurrentThread(); 线程安全性需要调用者来保障
        //代码从右往左读
        last = last.next = node;
    }
    /**
     * 从队列头部移除一个元素(调用者保证队列不为空)
     * 返回被移除的元素的下一个元素的内容值,并且保证新的head.item=null 
     */
    private E dequeue() {
        // assert takeLock.isHeldByCurrentThread();
        线程安全性需要调用者来保障
        // assert head.item == null;
        Node<E> h = head;
        Node<E> first = h.next;
        h.next = h; // 为了加快对于h对象的清理。(还好JVM内部默认的不是引用计数法)
        head = first;
        E x = first.item;
        first.item = null;
        return x;
    }
    /**
     * 内容简单并且重复
     */
    private void signalNotEmpty() {
        final ReentrantLock takeLock = this.takeLock;
        takeLock.lock();
        try {
            notEmpty.signal();
        } finally {
            takeLock.unlock();
        }
    }
    private void signalNotFull() {
        final ReentrantLock putLock = this.putLock;
        putLock.lock();
        try {
            notFull.signal();
        } finally {
            putLock.unlock();
        }
    }
    void fullyLock() {
        putLock.lock();
        takeLock.lock();
    }
    void fullyUnlock() {
        takeLock.unlock();
        putLock.unlock();
    }
    /**
     *put操作会响应中断,而且e不能为Null
     */
    public void put(E e) throws InterruptedException {
        if (e == null) throw new NullPointerException();
        // Note: convention in all put/take/etc is to preset local var
        // holding count negative to indicate failure unless set.
        int c = -1;
        Node<E> node = new Node(e);
        final ReentrantLock putLock = this.putLock;
        final AtomicInteger count = this.count;
        putLock.lockInterruptibly();
        try {
            /*
             * 因为put获得了putLock,所以在这里所有对于count的增加操作都是不可能的,只能减少count的值,如果在这里阻塞的话,一旦有其他减少count的操作就会立马被唤醒。
             * 但是因为在notFull.await()的时候释放了锁,所以有可能这时候忽然有一个类put的操作提交抢占了锁,这就导致count的值又增加。所以需要在这里使用while多次判断
             */
            while (count.get() == capacity) {
                notFull.await();
            }
            enqueue(node);
            c = count.getAndIncrement();
            if (c + 1 < capacity) //如果至少还有一个坑
                notFull.signal();
        } finally {
            putLock.unlock();
        }
        //如果原来列表为空,这就要通知一下
        if (c == 0)
            signalNotEmpty();
    }
    /**
     *offer于put的区别就是可以设置等待锁的时间,而且有返回值代表成功与否
     */
    public boolean offer(E e, long timeout, TimeUnit unit)
        throws InterruptedException {
        
        if (e == null) throw new NullPointerException();
        long nanos = unit.toNanos(timeout);
        int c = -1;
        final ReentrantLock putLock = this.putLock;
        final AtomicInteger count = this.count;
        putLock.lockInterruptibly();
        try {
            while (count.get() == capacity) {
                if (nanos <= 0)//等待时间到了之后立马返回(finally释放锁)
                    return false;
                nanos = notFull.awaitNanos(nanos);//返回的nanos代表已经等待的时间减去给定的等待时间
            }
            //以下部分跟put操作一样
            enqueue(new Node<E>(e));
            c = count.getAndIncrement();
            if (c + 1 < capacity)
                notFull.signal();
        } finally {
            putLock.unlock();
        }
        if (c == 0)
            signalNotEmpty();
        return true;
    }
    //put操作在full情况会等待,而offer直接返回失败
    public boolean offer(E e) {
        if (e == null) throw new NullPointerException();
        final AtomicInteger count = this.count;
        if (count.get() == capacity)
            return false;
        int c = -1;
        Node<E> node = new Node(e);
        final ReentrantLock putLock = this.putLock;
        putLock.lock();
        try {
            if (count.get() < capacity) {
                enqueue(node);
                c = count.getAndIncrement();
                if (c + 1 < capacity)
                    notFull.signal();
            }
        } finally {
            putLock.unlock();
        }
        if (c == 0)
            signalNotEmpty();
        return c >= 0; //如果容量满了的话c=-1,说明offer操作失败
    }
    /**
     *take操作是个阻塞操作,与put对应,都可以相应中断,实现也非常相似
     */
    public E take() throws InterruptedException {
        E x;
        int c = -1;
        final AtomicInteger count = this.count;
        final ReentrantLock takeLock = this.takeLock;
        takeLock.lockInterruptibly();
        try {//这里调用while的原因跟put操作的原因一样
            while (count.get() == 0) {
                notEmpty.await();
            }
            x = dequeue();//实际上链表的头节点是空的,第二个节点才是我们认为的“头结点”
            c = count.getAndDecrement();
            if (c > 1)
                notEmpty.signal();
        } finally {
            takeLock.unlock();
        }//如果原来的链表已经满了的话
        if (c == capacity)
            signalNotFull();
        return x;
    }
    //这两个操作与offer操作对应,实现也是一模一样(看过offer的可以跳过这个了)
    public E poll(long timeout, TimeUnit unit) throws InterruptedException {
        E x = null;
        int c = -1;
        long nanos = unit.toNanos(timeout);
        final AtomicInteger count = this.count;
        final ReentrantLock takeLock = this.takeLock;
        takeLock.lockInterruptibly();
        try {
            while (count.get() == 0) {
                if (nanos <= 0)
                    return null;
                nanos = notEmpty.awaitNanos(nanos);
            }
            x = dequeue();
            c = count.getAndDecrement();
            if (c > 1)
                notEmpty.signal();
        } finally {
            takeLock.unlock();
        }
        if (c == capacity)
            signalNotFull();
        return x;
    }

    public E poll() {
        final AtomicInteger count = this.count;
        if (count.get() == 0)
            return null;
        E x = null;
        int c = -1;
        final ReentrantLock takeLock = this.takeLock;
        takeLock.lock();
        try {
            if (count.get() > 0) {
                x = dequeue();
                c = count.getAndDecrement();
                if (c > 1)
                    notEmpty.signal();
            }
        } finally {
            takeLock.unlock();
        }
        if (c == capacity)
            signalNotFull();
        return x;
    }
    //peek:偷窥(只是看看而不改变链表结构)
    public E peek() {
        if (count.get() == 0)
            return null;
        final ReentrantLock takeLock = this.takeLock;
        takeLock.lock();
        try {
            Node<E> first = head.next;
            if (first == null)
                return null;
            else
                return first.item;
        } finally {
            takeLock.unlock();
        }
    }
    /**
     * remove操作是全锁的,因为这个操作会改变链表中间的节点。但是只会移除第一个匹配的节点(遍历时候也可以进行移除呦)
     * remove和contains都是需要全锁的,保证在操作时候不会有其他线程改变现有结构(因为这个两个操作都是需要在“某个瞬间时刻”进行的)
     */
    public boolean remove(Object o) {
        if (o == null) return false;
        fullyLock();
        try {
            for (Node<E> trail = head, p = trail.next;
                 p != null;
                 trail = p, p = p.next) {
                if (o.equals(p.item)) {
                    unlink(p, trail);
                    return true;
                }
            }
            return false;
        } finally {
            fullyUnlock();
        }
    }
    //调用者保证线程安全
    void unlink(Node<E> p, Node<E> trail) {
        // 一定要在isFullyLocked()使用的前提下;
        // 这里没有改变p.next是为了保持在遍历时候的弱一致性
        p.item = null;
        trail.next = p.next;
        if (last == p)
            last = trail;
        if (count.getAndDecrement() == capacity)
            notFull.signal(); //注意这里已经调用了isFullyLocked()所以已经取得了锁
    }
    /**
     * 将链表中指定数量(maxElemets)的的内容放到c中(从头部开始)
     */
    public int drainTo(Collection<? super E> c, int maxElements) {
        if (c == null)
            throw new NullPointerException();
        if (c == this)
            throw new IllegalArgumentException();
        boolean signalNotFull = false;
        final ReentrantLock takeLock = this.takeLock;
        takeLock.lock();
        try {//链表中的元素数量可能小于maxElements
            int n = Math.min(maxElements, count.get());
            Node<E> h = head;
            int i = 0;
            try {
                while (i < n) { //从n的值保证了p不为null
                    Node<E> p = h.next;
                    c.add(p.item);
                    p.item = null;
                    h.next = h; //促进GC
                    h = p;
                    ++i;
                }
                return n;
            } finally {
                // 即使在插入过程抛出异常,已经进行的操作还会保持有效
                if (i > 0) {
                    // 正常情况下h.item = null
                    head = h;
                    //如果当前count == capacity就表明队列已经从满-》不满,这样就可以通知等待在notFull上的线程
                    signalNotFull = (count.getAndAdd(-i) == capacity);
                }
            }
        } finally {
            takeLock.unlock();
            //因为这是一个减少队列元素的过程,所以有了元素移除操作就要看一下是否有线程等待在notFull.
            if (signalNotFull)
                signalNotFull();
        }
    }

LinkedBlockingQueue的内容都在这里进行了介绍。下面我们总结一下它与LinkedList的区别

  • LinkedBlockingQueue线程安全,LinkedList不安全
  • LinkedBlockingQueue为单向链表,LinkedList为双向链表
  • LinkedBlockingQueue支持容量设置,并且不能扩容,LinkedList不支持设置容量
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,080评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,422评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,630评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,554评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,662评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,856评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,014评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,752评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,212评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,541评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,687评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,347评论 4 331
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,973评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,777评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,006评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,406评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,576评论 2 349

推荐阅读更多精彩内容