一、简介

摘自《Java并发编程的艺术》一书

Semaphore（信号量）是用来控制同时访问特定资源的线程数量，它通过协调各个线程，以保证合理的使用公共资源。

Semaphore一般用于流量的控制，特别是公共资源有限的应用场景。例如数据库的连接，假设数据库的连接数上线为10个，多个线程并发操作数据库可以使用Semaphore来控制并发操作数据库的线程个数最多为10个。

二、类总览

通过上面的类图可以看到，Semaphore与ReentrantLock的内部类的结构相同，类内部总共存在Sync、NonfairSync、FairSync三个类，NonfairSync与FairSync类继承自Sync类，Sync类继承自AbstractQueuedSynchronizer抽象类。

1. 类继承关系

public class Semaphore implements java.io.Serializable {}

实现了Serializable接口。

2. 类的内部类

2.1 Sync类

abstract static class Sync extends AbstractQueuedSynchronizer {//序列化版本号private static final long serialVersionUID = 1192457210091910933L;//构造方法Sync(int permits) {setState(permits);}//获取许可final int getPermits() {return getState();}//共享模式下非公平策略获取final int nonfairTryAcquireShared(int acquires) {for (;;) {int available = getState();int remaining = available - acquires;if (remaining < 0 ||compareAndSetState(available, remaining))return remaining;}}//共享模式下进行释放protected final boolean tryReleaseShared(int releases) {for (;;) {int current = getState();int next = current + releases;if (next < current) // overflowthrow new Error("Maximum permit count exceeded");if (compareAndSetState(current, next))return true;}}//根据指定的缩减量减小可用许可的数目final void reducePermits(int reductions) {for (;;) {int current = getState();int next = current - reductions;if (next > current) // underflowthrow new Error("Permit count underflow");if (compareAndSetState(current, next))return;}}//获取并返回立即可用的所有许可final int drainPermits() {for (;;) {int current = getState();if (current == 0 || compareAndSetState(current, 0))return current;}}
}

方法细节第四章会详细分析

2.2 NonfairSync类

NonfairSync类继承了Sync类，表示采用非公平策略获取资源，其只有一个tryAcquireShared方法，重写了AQS的该方法

static final class NonfairSync extends Sync {//序列化版本号private static final long serialVersionUID = -2694183684443567898L;//构造方法NonfairSync(int permits) {super(permits);}//共享模式下获取protected int tryAcquireShared(int acquires) {return nonfairTryAcquireShared(acquires);}
}

2.3 FairSync类

FairSync类继承了Sync类，表示采用公平策略获取资源，其只有一个tryAcquireShared方法，重写了AQS的该方法

static final class FairSync extends Sync {//序列化版本号private static final long serialVersionUID = 2014338818796000944L;//构造方法FairSync(int permits) {super(permits);}//共享模式下获取protected int tryAcquireShared(int acquires) {for (;;) {if (hasQueuedPredecessors())return -1;int available = getState();int remaining = available - acquires;if (remaining < 0 ||compareAndSetState(available, remaining))return remaining;}}
}

3. 类的属性

与CountDownLatch类似，Semaphore主要是通过AQS的共享锁机制实现的，因此它的核心属性只有一个sync

//序列化版本号
private static final long serialVersionUID = -3222578661600680210L;
//同步队列
private final Sync sync;

4. 构造方法

Semaphore构造方法有两种

//指定许可数，默认为非公平策略
public Semaphore(int permits) {sync = new NonfairSync(permits);
}//指定许可数和是否公平策略
public Semaphore(int permits, boolean fair) {sync = fair ? new FairSync(permits) : new NonfairSync(permits);
}

构造方法类似于ReentrantLock的构造方法，只是多了一个许可数的参数。调用构造方法的结果就是初始化了同步队列实例，设置state值为permits值。

三、使用案例

这里以经典的停车作为案例。假设停车场有3个停车位，此时有5辆汽车需要进入停车场停车。

public static void main(String[] args) {//定义semaphore实例，设置许可数为3，即停车位为3个Semaphore semaphore = new Semaphore(3);//创建五个线程，即有5辆汽车准备进入停车场停车for (int i = 1; i <= 5; i++) {new Thread(() -> {try {System.out.println(Thread.currentThread().getName() + "尝试进入停车场...");//尝试获取许可semaphore.acquire();//模拟停车long time = (long) (Math.random() * 10 + 1);System.out.println(Thread.currentThread().getName() + "进入了停车场，停车" + time +"秒...");Thread.sleep(time);} catch (InterruptedException e) {e.printStackTrace();} finally {System.out.println(Thread.currentThread().getName() + "开始驶离停车场...");//释放许可semaphore.release();System.out.println(Thread.currentThread().getName() + "离开了停车场！");}}, i + "号汽车").start();}
}

执行结果如下

1号汽车尝试进入停车场...
5号汽车尝试进入停车场...
4号汽车尝试进入停车场...
3号汽车尝试进入停车场...
2号汽车尝试进入停车场...
5号汽车进入了停车场，停车5秒...
1号汽车进入了停车场，停车8秒...
4号汽车进入了停车场，停车9秒...
5号汽车开始驶离停车场...
5号汽车离开了停车场！
3号汽车进入了停车场，停车10秒...
1号汽车开始驶离停车场...
1号汽车离开了停车场！
2号汽车进入了停车场，停车2秒...
4号汽车开始驶离停车场...
4号汽车离开了停车场！
2号汽车开始驶离停车场...
2号汽车离开了停车场！
3号汽车开始驶离停车场...
3号汽车离开了停车场！

总结，每个线程调用acquire方法尝试获取许可，如果成功就会继续执行，否则就会被阻塞，当获取许可成功后，调用release方法释放许可供其他线程使用，之前被阻塞的线程会被唤醒继续执行。

四、核心方法

通过上面的案例我们知道Semaphore的核心方法是acquire获取信号量和release释放信号量，下面我们来一一分析

1. acquire

Semaphore提供了acquire方法来获取一个许可。老规矩，我们跟着上面的案例进入源码分析，acquire方法定义如下

public void acquire() throws InterruptedException {sync.acquireSharedInterruptibly(1);
}

内部调用的是AQS的acquireSharedInterruptibly方法，即共享式获取响应中断，定义如下

public final void acquireSharedInterruptibly(int arg)throws InterruptedException {if (Thread.interrupted())throw new InterruptedException();if (tryAcquireShared(arg) < 0)doAcquireSharedInterruptibly(arg);
}

该方法在AQS详解中有讲解过，这里不赘述了，我们来分析一下子类实现的tryAcquireShared方法，这里就要分公平和非公平策略两种情况了

1.1 非公平策略下

非公平策略下的tryAcquireShared方法定义如下

protected int tryAcquireShared(int acquires) {return nonfairTryAcquireShared(acquires);
}

内部调用Sync类中的nonfairTryAcquireShared方法

final int nonfairTryAcquireShared(int acquires) {//自旋for (;;) {//获取可用许可值int available = getState();//计算剩余的许可值int remaining = available - acquires;//如果剩余许可值小于0，说明许可不够用了，直接返回，否则CAS更新同步状态，更新成功返回，否则继续自旋if (remaining < 0 ||compareAndSetState(available, remaining))return remaining;}
}

该方法本质就是一个自旋方法，通过自旋+CAS来保证修改许可值的线程安全性。该方法返回的情况有如下两种情况

信号量不够，直接返回，返回值为负数，表示获取失败；
信号量足够，且CAS操作成功，返回值为剩余许可值，获取成功。

1.2 公平策略下

公平策略下的tryAcquireShared方法定义如下

protected int tryAcquireShared(int acquires) {//自旋for (;;) {if (hasQueuedPredecessors())return -1;int available = getState();int remaining = available - acquires;if (remaining < 0 ||compareAndSetState(available, remaining))return remaining;}
}

我们看到它与非公平策略的唯一区别就是多了下面这个if代码

if (hasQueuedPredecessors())return -1;

即在获取共享锁之前，先调用hasQueuedPredecessors方法来判断队列中是否存在其他正在排队的节点，如果是返回true，否则为false。因此当存在其他正在排队的节点，当前节点就无法获取许可，只能排队等待，这也是公平策略的体现。

2. release

Semaphore提供release来释放许可。我们继续分析release方法，定义如下

public void release() {sync.releaseShared(1);
}

调用AQS的releaseShared方法，即释放共享式同步状态

public final boolean releaseShared(int arg) {if (tryReleaseShared(arg)) {//如果释放锁成功，唤醒正在排队的节点doReleaseShared();return true;}return false;
}

同样该方法在AQS详解中有讲解过，这里也不再赘述了，我们来分析一下子类实现的tryReleaseShared方法，定义如下

protected final boolean tryReleaseShared(int releases) {//自旋for (;;) {//获取许可值int current = getState();//计算释放后的许可值int next = current + releases;//如果释放后比释放前的许可值还小，直接报Errorif (next < current) // overflowthrow new Error("Maximum permit count exceeded");//CAS修改许可值，成功则返回，失败则继续自旋if (compareAndSetState(current, next))return true;}
}

该方法也是一个自旋方法，通过自旋+CAS原子性地修改同步状态，逻辑很简单。

3. 其余方法

获取信号量的方法总共有四个

方法	说明
`acquire()`	获取信号量，默认获取1个许可，响应中断	`sync.acquireSharedInterruptibly(1)`
`acquire(int permits)`	获取信号量，指定获取许可的个数，响应中断	`sync.acquireSharedInterruptibly(permits)`
`acquireUninterruptibly()`	获取信号量，默认获取1个许可，不响应中断	`sync.acquireShared(1)`
`acquireUninterruptibly(int permits)`	获取信号量，指定获取许可的个数，不响应中断	`sync.acquireShared(permits)`

释放信号量的方法有两个

方法	说明
`release()`	释放信号量，默认释放一个许可，等同于`release(1)`
`release(int permits)`	释放信号量，指定释放许可的个数

获取信号量四个方法中后面三个方法原理同acquire()，小伙伴可以自己去源码中探究，这里就不再赘述了。我们下面看一下其余的工具方法

3.1 tryAcquire

tryAcquire方法一共有四种重载形式

tryAcquire()
```
public boolean tryAcquire() {return sync.nonfairTryAcquireShared(1) >= 0;
}
```
tryAcquire与acquire方法类似，只是tryAcquire的意思是尝试获取许可，如果获取成功返回true，否则返回false，不会阻塞线程，而且不响应中断。

tryAcquire(int permits)

public boolean tryAcquire(int permits) {if (permits < 0) throw new IllegalArgumentException();return sync.nonfairTryAcquireShared(permits) >= 0;
}

同上，可以指定获取许可的个数。

tryAcquire(long timeout, TimeUnit unit)
```
public boolean tryAcquire(long timeout, TimeUnit unit)throws InterruptedException {return sync.tryAcquireSharedNanos(1, unit.toNanos(timeout));
}
```
tryAcquire可以指定超时时间，它调用AQS的tryAcquireSharedNanos方法，即共享式超时获取。同样该方法在AQS详解中有讲解过，不再赘述。

tryAcquire(int permits, long timeout, TimeUnit unit)

public boolean tryAcquire(int permits, long timeout, TimeUnit unit)throws InterruptedException {if (permits < 0) throw new IllegalArgumentException();return sync.tryAcquireSharedNanos(permits, unit.toNanos(timeout));
}

同上，可以指定获取许可的个数。

3.2 availablePermits

获取可用许可数

public int availablePermits() {//获取可用许可数return sync.getPermits();
}//获取可用许可数
final int getPermits() {return getState();
}

3.3 drainPermits

将剩下的信号量一次性消耗光，并且返回所消耗的信号量

public int drainPermits() {return sync.drainPermits();
}

调用Sync类的drainPermits方法，定义如下

final int drainPermits() {//自旋操作for (;;) {//获取信号量值int current = getState();//如果信号量为0，直接返回//否则CAS修改为0，成功则返回，否则继续自旋if (current == 0 || compareAndSetState(current, 0))return current;}
}

3.4 reducePermits

减少信号量的总数。

protected void reducePermits(int reduction) {if (reduction < 0) throw new IllegalArgumentException();sync.reducePermits(reduction);
}

调用Sync类的reducePermits方法，定义如下

final void reducePermits(int reductions) {//自旋for (;;) {//获取当前信号量值int current = getState();//计算剩余许可值int next = current - reductions;if (next > current) // underflowthrow new Error("Permit count underflow");//CAS修改同步状态，成功则返回，失败则继续自旋if (compareAndSetState(current, next))return;}
}

reducePermits方法本质就是减少指定的信号量的值，它和acquire方法相比都是减少信号量的值，但是reducePermits是不会导致任何线程阻塞，即只要传递的参数reductions（减少的信号量的数量）大于0，操作就会成功。所以调用该方法可能会导致信号量最终为负数。