【JUC源码解析】CyclicBarrier

简介

CyclicBarrier，一个同步器，允许多个线程相互等待，直到达到一个公共屏障点。

概述

CyclicBarrier支持一个可选的 Runnable 命令，在一组线程中的最后一个线程到达之后，释放所有线程之前，该命令只在屏障点运行一次。

应用

描述

有一个矩阵，每一行数据交给一个线程去处理，处理内容是，将这行数据的每一个值相加，结果存入第一个元素中，每个线程处理完成后，会在屏障点相互等待，直到最后一个线程也到达屏障点，最后将各个线程处理的数据汇总，具体是将每一行汇总的数据（存在每行的第一个元素中的数据）再相加，结果存在第一行中的第一个元素。

具体如下代码所示。

代码

public class Solver {
final int N;
final float[][] data; // 待处理的数据
final CyclicBarrier barrier; // 屏障

class Worker implements Runnable { // 工作者
int myRow;

Worker(int row) {
myRow = row;
}

public void run() {
System.out.println("Matrix[" + myRow + "]数据准备处理");
processRow(myRow); // 处理每一行数据，把各个数据相加，并且存入第一个元素
System.out.println("Matrix[" + myRow + "]数据处理完成");
try {
barrier.await(); // 处理完成后，在此等待，直到最后一个线程也完成任务
} catch (InterruptedException ex) {
return;
} catch (BrokenBarrierException ex) {
return;
}
}
}

public Solver(float[][] matrix) throws InterruptedException {
data = matrix;
N = matrix.length;

System.out.println("开始处理数据，最初矩阵如下所示");
displayData(); // 数据展示

Runnable barrierAction = new Runnable() { // 操作完成后，由最后一个到达屏障点的线程执行此操作，整体只执行一次
public void run() { // 数据汇总，把第一列每行的和再相加，结果存入第一行第一个元素
float tmp = 0.0f;
for (int i = 0; i < N; i++) {
tmp += data[i][0];
}

data[0][0] = tmp;
System.out.println("Matrix[0]数据汇总完成，结果是" + tmp + "，存在了Matrix[0][0]");
}
};
barrier = new CyclicBarrier(N, barrierAction);

List<Thread> threads = new ArrayList<Thread>(N);
for (int i = 0; i < N; i++) {
Thread thread = new Thread(new Worker(i));
threads.add(thread);
thread.start(); // 启动各个工作线程
}

for (Thread thread : threads) { // 等待所有线程执行完成
thread.join();
}
System.out.println("所以数据都已经处理完成，最终矩阵如下所示");
displayData();
}

private void processRow(int myRow) { //  处理每一行数据，把各个数据相加，并且存入第一个元素
float[] row = data[myRow];
float tmp = 0.0f;
int length = row.length;
for (int i = 0; i < length; i++) {
tmp += row[i];
}

String msg = Arrays.toString(row);
row[0] = tmp;
System.out.println("Matrix[" + myRow + "]数据" + msg + "的和是：" + tmp + ", 且存入了Matrix[" + myRow + "][0]");
}

private void displayData() { // 数据展示
TableInfo info = new TableInfo(N + 1); // TableInfo见下面代码，仅仅为了展示数据，可忽略，也可以用Arrays.toString(array);

String[] header = new String[N + 1];
header[0] = String.valueOf("    ");
for (int i = 0; i < N; i++) {
header[i + 1] = String.valueOf(i);
}
info.addHeader(header);
for (int i = 0; i < N; i++) {
String[] tmp = new String[N + 1];
tmp[0] = String.valueOf(i);
for (int j = 0; j < data[i].length; j++) {
tmp[j + 1] = String.valueOf(data[i][j]);
}
info.addRecode(tmp);
}
System.out.println(info.getInfo());
}

public static void main(String[] args) throws InterruptedException {
Random r = new Random(47);
float[][] matrix = new float[5][5];
for (int i = 0; i < 5; i++) {
for (int j = 0; j < 5; j++) {
matrix[i][j] = r.nextFloat();
}
}
new Solver(matrix);
}
}

class TableInfo {
private int count;
private int[] maxLens;
private String[] columns;
private List<String[]> records;
private StringBuilder builder;

public TableInfo(int count) {
this.count = count;
maxLens = new int[count];
columns = new String[count];
builder = new StringBuilder();
records = new ArrayList<String[]>();
}

private boolean isValid(String... args) {
return null == args || args.length == 0;
}

private boolean isOutOfIndex(String... args) {
return args.length > count;
}

public boolean addHeader(String... record) {
if (isValid(record) || isOutOfIndex(record)) {
return false;
}

copy(columns, record);
copy(maxLens, record);

return false;
}

public boolean addRecode(String... record) {
if (isValid(record) || isOutOfIndex(record)) {
return false;
}

copy(maxLens, record);

records.add(record);

return false;
}

public String getInfo() {
buildLine();
buildHeader();
buildLine();
buildBody();
buildLine();

return builder.toString();
}

private void buildHeader() {
builder.append("|");
for (int i = 0; i < columns.length; i++) {
builder.append(columns[i]);
builder.append(getEmpty(maxLens[i] - columns[i].length()));
builder.append("|");
}
builder.append("\r\n");
}

private void buildBody() {
for (String[] recode : records) {
builder.append("|");
for (int i = 0; i < recode.length; i++) {
builder.append(recode[i]);
builder.append(getEmpty(maxLens[i] - recode[i].length()));
builder.append("|");
}
builder.append("\r\n");
}
}

private void buildLine() {
builder.append("+");
for (int i = 0; i < maxLens.length; i++) {
builder.append(getLine(maxLens[i]));
builder.append("+");
}
builder.append("\r\n");
}

private String getLine(int count) {
StringBuilder builder = new StringBuilder();
for (int i = 0; i < count; i++) {
builder.append("-");
}

return builder.toString();

}

private String getEmpty(int count) {
StringBuilder builder = new StringBuilder();
for (int i = 0; i < count; i++) {
builder.append(" ");
}

return builder.toString();
}

private void copy(String[] args1, String... args2) {
for (int i = 0; i < args2.length; i++) {
args1[i] = args2[i];
}
}

private void copy(int[] args1, String... args2) {
for (int i = 0; i < args2.length; i++) {
args1[i] = swap(args1[i], args2[i].length());
}
}

private int swap(int max, int length) {
if (max > length) {
return max;
}

return length;
}

输出

开始处理数据，最初矩阵如下所示
+----+----------+----------+----------+----------+----------+
|    |0         |1         |2         |3         |4         |
+----+----------+----------+----------+----------+----------+
|0   |0.72711575|0.39982635|0.5309454 |0.0534122 |0.16020656|
|1   |0.57799757|0.18847865|0.4170137 |0.51660204|0.73734957|
|2   |0.2678662 |0.9510573 |0.261361  |0.11435455|0.05086732|
|3   |0.5466897 |0.8037155 |0.20143336|0.76206654|0.55373144|
|4   |0.5304296 |0.15709275|0.5295954 |0.39661872|0.48718303|
+----+----------+----------+----------+----------+----------+

Matrix[0]数据准备处理
Matrix[1]数据准备处理
Matrix[0]数据[0.72711575, 0.39982635, 0.5309454, 0.0534122, 0.16020656]的和是：1.8715063, 且存入了Matrix[0][0]
Matrix[0]数据处理完成
Matrix[2]数据准备处理
Matrix[2]数据[0.2678662, 0.9510573, 0.261361, 0.11435455, 0.05086732]的和是：1.6455064, 且存入了Matrix[2][0]
Matrix[2]数据处理完成
Matrix[1]数据[0.57799757, 0.18847865, 0.4170137, 0.51660204, 0.73734957]的和是：2.4374416, 且存入了Matrix[1][0]
Matrix[1]数据处理完成
Matrix[4]数据准备处理
Matrix[3]数据准备处理
Matrix[3]数据[0.5466897, 0.8037155, 0.20143336, 0.76206654, 0.55373144]的和是：2.8676367, 且存入了Matrix[3][0]
Matrix[3]数据处理完成
Matrix[4]数据[0.5304296, 0.15709275, 0.5295954, 0.39661872, 0.48718303]的和是：2.1009195, 且存入了Matrix[4][0]
Matrix[4]数据处理完成
Matrix[0]数据汇总完成，结果是10.923011，存在了Matrix[0][0]
所以数据都已经处理完成，最终矩阵如下所示
+----+---------+----------+----------+----------+----------+
|    |0        |1         |2         |3         |4         |
+----+---------+----------+----------+----------+----------+
|0   |10.923011|0.39982635|0.5309454 |0.0534122 |0.16020656|
|1   |2.4374416|0.18847865|0.4170137 |0.51660204|0.73734957|
|2   |1.6455064|0.9510573 |0.261361  |0.11435455|0.05086732|
|3   |2.8676367|0.8037155 |0.20143336|0.76206654|0.55373144|
|4   |2.1009195|0.15709275|0.5295954 |0.39661872|0.48718303|
+----+---------+----------+----------+----------+----------+

源码解析

关于静态内部类Generation，其属性broken描述CyclicBarrier是否被打破。每次到达屏障点，或者重置时，都会新生下一代（创建Generation实例，记录下一批线程的屏障状态）。

一组线程，执行一批任务，调用CyclicBarrier的await方法，其内部调用的是Condition的await方法，实质上是调用LockSupport.park方法，入队等待。也就是说，这组线程一调用await方法，就会再此阻塞，而最后一个线程调用await方法时，不在走Condition的await的代码分支，而是先执行barrierCommand任务，然后调用nextGeneration方法，在该方法内部，会调用Condition的signalAll方法，即是唤醒阻塞在Condition上的线程，重置count，并重新创建Generation实例，一遍下次使用。

reset方法，会先打破原有的屏障，即是Generation的broken设置为true，提前调用Condition的signalAll方法，释放阻塞着的线程。并且接着调用nextGeneration，开启一个新的Generation实例。

问题：为什么要多次创建Generation实例呢？重用一个实例不是更好吗？毕竟只有一个broken属性，加一个set方法就好了？

回答：之所以创建新的Generation，是因为，每个Generation实例对应一批冲向屏障的线程。假如，只有一个Generation实例，想像这样一个场景，某个线程调用了reset方法，本意是使另外一组线程能重新使用CyclicBarrier，并唤醒与它同一批阻塞在Generation上的线程，被唤醒的老一批线程需要记录屏障打破记录（reset方法会打破屏障状态，即是broken为true），如果是同一个Generation对象，且broken为true，而新线程又要求broken为false，因为是全新的，对它们来说，屏障没有被打破。因此，无法满足。

以下是源码：

属性

private static class Generation { // 分代，对应每一批冲向屏障的线程
boolean broken = false; // 记录屏障是否被打破
}

private final ReentrantLock lock = new ReentrantLock(); // 可重入锁
private final Condition trip = lock.newCondition(); // 条件
private final int parties; // 记录线程数量
private final Runnable barrierCommand; // 最后一个到达屏障的线程需要执行的任务
private Generation generation = new Generation(); // 初代

private int count; // 还未到达屏障的线程个数，会再次重置为parties

创建下一代

private void nextGeneration() { // 创建下一代
trip.signalAll(); // 唤醒阻塞在该代屏障上的线程
count = parties; // 重置count
generation = new Generation(); // 创建新的Generation实例
}

打破屏障

private void breakBarrier() { // 打破屏障
generation.broken = true; // 设置broken
count = parties; // 重置count
trip.signalAll(); // 唤醒阻塞的线程
}

关键的dowait

private int dowait(boolean timed, long nanos)
throws InterruptedException, BrokenBarrierException, TimeoutException {
final ReentrantLock lock = this.lock; // 可重入锁
lock.lock(); // 加锁
try {
final Generation g = generation; // 对应该代线程的分代器，记录屏障的打破状态

if (g.broken) // 如果被打破，抛出异常
throw new BrokenBarrierException();

if (Thread.interrupted()) { // 如果线程中断了
breakBarrier(); // 打破屏障，并抛出异常
throw new InterruptedException();
}

int index = --count; // 来一个线程，count减1
if (index == 0) { // 即将通过屏障
boolean ranAction = false; // 记录是否正常完成
try {
final Runnable command = barrierCommand; // 屏障点任务，由最后一个到达的线程负责执行
if (command != null)
command.run(); // 执行任务
ranAction = true; // 设置为正常完成
nextGeneration(); // 创建新的Generation对象
return 0; // 返回
} finally {
if (!ranAction) // 如果没有正常完成，打破屏障
breakBarrier();
}
}

for (;;) {
try {
if (!timed) // 如果没有设置超时
trip.await(); // 调用await方法
else if (nanos > 0L) // 否则，调用awaitNanos方法
nanos = trip.awaitNanos(nanos);
} catch (InterruptedException ie) { // 如果是中断唤醒的，则看是否换代
if (g == generation && !g.broken) { // 如果还是同一代，并且屏障没有被打破，那么打破屏障，并抛出异常
breakBarrier();
throw ie;
} else { // 如果换代了，或者屏障已经打破了，什么都不作，仅仅重新设置中断标记
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(); // 解锁
}
}

行文至此结束。

尊重他人的劳动，转载请注明出处：http://www.cnblogs.com/aniao/p/aniao_cyclicbarrier.html