CyclicBarrier是如何成为一个"栅栏"的
CyclicBarrier是一种类似于栅栏的存在，意思就是在栅栏开放之前你都只能被挡在栅栏的一侧，当栅栏移除之后，之前被挡在一侧的多个对象则同时开始动起来。
1. 如何使用CyclicBarrier
在介绍其原理之前，先了解一下CyclicBarrier应该如何使用。
假设现在有这样的场景，我们需要开一个会议，需要张1、张2、张3三个人参加，
会议需要三个人都到齐之后才能开始，否则只能干等着；这个场景用CyclicBarrier可以很契合的模拟出来。代码如下：
public static void main(String[] args) {
// 线程池，每个线程代表一个人
ThreadPoolExecutor executor = ThreadPoolProvider.getInstance();
// 会议所需的人数为3
CyclicBarrier barrier = new CyclicBarrier(3);
executor.execute(() -> {
try {
System.err.println("张1到达会议室");
barrier.await();
System.err.println("会议开始，张1开始发言");
} catch (InterruptedException | BrokenBarrierException e) {
e.printStackTrace();
}
});
executor.execute(() -> {
try {
System.err.println("张2到达会议室");
barrier.await();
System.err.println("会议开始，张2开始发言");
} catch (InterruptedException | BrokenBarrierException e) {
e.printStackTrace();
}
});
executor.execute(() -> {
try {
System.err.println("张3先去个厕所，内急解决再去开会");
TimeUnit.SECONDS.sleep(1);
System.err.println("张3到达会议室");
barrier.await();
System.err.println("会议开始，张3开始发言");
} catch (InterruptedException | BrokenBarrierException e) {
e.printStackTrace();
}
});
executor.shutdown();
}
结果图：
通过上方代码可以知道CyclicBarrier的几点：
1. 使用`await()`来表示完成了某些事情。(上方例子的表现为**到达了会议室**)
2. 使用`await()`之后**当前线程就进入阻塞状态**，需要**等待完全满足`CyclicBarrier`的条件后唤醒**才能继续接下来的操作。(上方例子中 **为3个人都到达会议室**)
3. **在最后一个线程达到条件之后，之前阻塞的线程全部放开**，继续接下来的操作。(上方例子为张3到达会议室)
这个简单的例子也让我们了解CyclicBarrier的使用方法，那来看看其内部究竟是如何实现栅栏的效果的。
2. CyclicBarrier是如何成为"栅栏"的
从第一节的代码中我们也能看到，需要关注的就两个地方
- 构造函数
- await()方法
只要了解这两个方法的内部，相当于了解了CyclicBarrier的内部。
那在深入了解之前，先来看下CyclicBarrier的几个变量，不用刻意去记，看代码的时候知道这个东西做什么用的就行了:
lock：
CyclicBarrier类创建的ReentrantLock实例，关于ReentrantLock不清楚的可以->传送。trip：
lock中的condition，CyclicBarrier使用该变量来实现各线程之间的阻塞和同时唤醒。同样，不明白condition作用的=>传送门。parties：需要满足条件(调用
await方法)的总数，就是说当有parties个线程await()之后就会唤醒全部线程。barrierCommand：一个
Runnable变量，在await方法的调用次数到达总数parties之后，在唤醒全部线程之前执行其run()方法generation：其内部类，可以理解为周期，周期内需要完成n个任务，只要一个任务失败，当前周期的所有任务就算失败，结束当前周期，再开启下个周期。
count：当前周期剩余需要完成的任务数(剩余调用
await方法的次数)
以下为源码：
public class CyclicBarrier {
// 内部类，可理解为周期
private static class Generation {
// 当前周期是否失败
boolean broken = false;
}
// 锁的实例
private final ReentrantLock lock = new ReentrantLock();
// ReentrantLock的condition变量，用来控制线程唤醒和阻塞
private final Condition trip = lock.newCondition();
// 需要满足条件的次数，即需要调用await方法的次数
private final int parties;
// 满足条件次数达到parties之后，唤醒所有线程之前执行其 run()方法
private final Runnable barrierCommand;
// 当前周期
private Generation generation = new Generation();
// 剩余满足条件次数
private int count;
// ...
}
看完CyclicBarrier的几个变量后，来看其具体的内部实现。
首先来看构造函数，其构造函数有两个，一个在达到条件总数(parties)后直接叫醒所有线程；另一个指定一个Runnable在达到条件总数后先执行其run()方法再叫醒。
- 不指定
Runnable，参数只有一个：需要达成的任务数
public CyclicBarrier(int parties) {
// 直接调用另一个构造方法，Runnable传null，表示不执行
this(parties, null);
}
- 指定
Runnable的构造方法，赋值任务总数、剩余任务数、唤醒操作之前的Runnable
public CyclicBarrier(int parties, Runnable barrierAction) {
if (parties <= 0) throw new IllegalArgumentException();
// 任务总数
this.parties = parties;
// 剩余需要完成的任务数
this.count = parties;
// 唤醒之前执行的Runnable
this.barrierCommand = barrierAction;
}
在第一节我们使用的是第一个构造方法，来试试第二个
public static void main(String[] args) throws InterruptedException {
ThreadPoolExecutor executor = ThreadPoolProvider.getInstance();
/** =======增加Runnable，其他地方保持一致=============*/
CyclicBarrier barrier = new CyclicBarrier(3, ()-> System.err.println("在会议开始之前，先给大家发下开会资料"));
executor.execute(() -> {
try {
System.err.println("张1到达会议室");
barrier.await();
System.err.println("会议开始，张1开始发言");
} catch (InterruptedException | BrokenBarrierException e) {
e.printStackTrace();
}
});
executor.execute(() -> {
try {
System.err.println("张2到达会议室");
barrier.await();
System.err.println("会议开始，张2开始发言");
} catch (InterruptedException | BrokenBarrierException e) {
e.printStackTrace();
}
});
executor.execute(() -> {
try {
System.err.println("张3先去个厕所，内急解决再去开会");
TimeUnit.SECONDS.sleep(1);
System.err.println("张3到达会议室");
barrier.await();
System.err.println("会议开始，张3开始发言");
} catch (InterruptedException | BrokenBarrierException e) {
e.printStackTrace();
}
});
executor.shutdown();
}
结果图：
看完构造函数，就算理解了一半CyclicBarrier了，接下来来看另一半——await()；跟踪代码，看到是这样的
public int await() throws InterruptedException, BrokenBarrierException {
try {
return dowait(false, 0L);
} catch (TimeoutException toe) {
throw new Error(toe); // cannot happen
}
}
直接调用dowait方法，传参为false和0，意思就是不限时等待，除非线程被打断或者唤醒。再进入dowait方法，这个方法就是CyclicBarrier的另一半，在下方的代码中很清楚的写了整个执行流程
/** 参数说明, timed：是否限时, nanos：限时时间*/
private int dowait(boolean timed, long nanos)
throws InterruptedException, BrokenBarrierException, TimeoutException {
// 锁
final ReentrantLock lock = this.lock;
// 获取锁，如果失败的话线程睡眠，进入同步队列(AQS中的知识)
lock.lock();
try {
/* 拿到锁之后进入代码处理逻辑*/
// 当前周期
final Generation g = generation;
// 如果当前周期是失败的，那么直接抛错
if (g.broken)
throw new BrokenBarrierException();
// 如果当前线程被打断了,那么此次周期失败，设置相关参数，然后抛错
if (Thread.interrupted()) {
// 实现代码在下行的注释中，设置相关参数来提醒其他线程周期失败了
breakBarrier();
/*
* private void breakBarrier() {
* generation.broken = true;
* count = parties;
* // 唤醒condition中的所有线程
* trip.signalAll();
* }
*/
throw new InterruptedException();
}
// 如果成功了，那么剩余任务数(count)减1
int index = --count;
// 如果为0则表示达到剩余的任务数没有了，达到CyclicBarrier的条件总数了，需要唤醒其他线程
if (index == 0) {
boolean ranAction = false;
try {
// 唤醒之前的Runnable
final Runnable command = barrierCommand;
// 如果不为空的话执行其run方法
if (command != null)
command.run();
ranAction = true;
// 开启下个周期,这个方法是CyclicBarrier可以复用的原因，具体实现在下行注释
nextGeneration();
/* private void nextGeneration() {
* // 首先叫醒当前周期的其他线程，告诉其周期结束了，可以执行接下来的操作了
* trip.signalAll();
* // 然后开启下个周期，剩余任务数重置
* count = parties;
* // 下个周期
* generation = new Generation();
* }
*/
return 0;
} finally {
if (!ranAction)
breakBarrier();
}
}
// 如果还不能结束本周期，就一直等待直到结束或者周期失败
for (;;) {
try {
// await的过程中是释放锁的
// 不限时的话就一直等待直到被唤醒或者打断
if (!timed)
trip.await();
else if (nanos > 0L)
// 否则的话等待一段时间后醒来
nanos = trip.awaitNanos(nanos);
} catch (InterruptedException ie) {
if (g == generation && ! g.broken) {
breakBarrier();
throw ie;
} else {
// We're about to finish waiting even if we had not
// been interrupted, so this interrupt is deemed to
// "belong" to subsequent execution.
Thread.currentThread().interrupt();
}
}
if (g.broken)
throw new BrokenBarrierException();
if (g != generation)
return index;
if (timed && nanos <= 0L) {
breakBarrier();
throw new TimeoutException();
}
}
} finally {
// 释放锁
lock.unlock();
}
}
到这里就基本理解CyclicBarrier的内部实现了，其他像带参数的await也是一样逻辑，只不过是多了限时的条件而已。
最后还有一个比较隐蔽的方法——reset()，先来看下内部类Generation定义注释中的一段话。（这里感谢评论区中147110老哥对于此方法的提醒）
/**
* ...
* The generation changes whenever the barrier is tripped, or
* is reset.
* ...
*/
private static class Generation {
boolean broken = false;
}
意思就是说当一个生命周期被中断或者重置这两种情况发生的时候会发生改变，那中断的情况上面注释也讲了（任务线程中断），那重置又是啥意思呢？
来，我们把镜头给到await()方法的注释，
/**
* ...
* <p>If the current thread is not the last to arrive then it is
* disabled for thread scheduling purposes and lies dormant until
* one of the following things happens:
* <ul>
* <li>The last thread arrives; or
* <li>Some other thread {@linkplain Thread#interrupt interrupts}
* the current thread; or
* <li>Some other thread {@linkplain Thread#interrupt interrupts}
* one of the other waiting threads; or
* <li>Some other thread times out while waiting for barrier; or
* <li>Some other thread invokes {@link #reset} on this barrier.
* </ul>
* ...
*/
public int await() throws InterruptedException, BrokenBarrierException {
// ...
}
这段注释的大概意思就是，如果线程不是最后一个到达（完成任务）的，那么在下面的情况发生之前会进入休眠状态：
- 最后一个线程到达了。
- 其他线程打断了当前线程。
- 其他线程打断了其他等待中的线程。
- 其他线程等待时间到了。
- 其他线程主动调用了reset方法。（划重点）
上面4条基本就是线程打断或者完成的情况，属于能改变生命周期的第一种情况，而第五点就是能改变生命周期的第二种情况——线程主动调用reset()方法。
public void reset() {
final ReentrantLock lock = this.lock;
lock.lock();
try {
// 打断当前的生命周期，就是将broken设置为true并且重置状态后唤起其他线程
breakBarrier();
// 重启一个新的周期
nextGeneration();
} finally {
lock.unlock();
}
}
okay，以上就是对CyclicBarrier一些比较重要的地方，不过其实如果你了解ReentrantLock的话，就知道CyclicBarrier整个就是对ReentrantLock的condition的活用而已。
3.总结
整体来说CyclicBarrier的实现相对较简单，说是ReentrantLock中condition的升级版也不为过。其关键点为两个，一个为其构造函数，决定任务个数和唤醒前操作；另外一个点为await方法，在正常情况下每次await都会减少一个任务数(总数由构造方法决定)，在任务数变为0的时候表示周期结束，需要唤醒condition的其他线程，而途中遇到失败的话当前周期失败，唤醒其他线程一起抛错。
失败不会让你变得弱小，害怕失败会。
