一、简介
摘自《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) // overflow
                throw 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) // underflow
                throw 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;
        //如果释放后比释放前的许可值还小,直接报Error
        if (next < current) // overflow
            throw 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) // underflow
            throw new Error("Permit count underflow");
        //CAS修改同步状态,成功则返回,失败则继续自旋
        if (compareAndSetState(current, next))
            return;
    }
}
reducePermits方法本质就是减少指定的信号量的值,它和acquire方法相比都是减少信号量的值,但是reducePermits是不会导致任何线程阻塞,即只要传递的参数reductions(减少的信号量的数量)大于0,操作就会成功。所以调用该方法可能会导致信号量最终为负数。
五、总结
Semaphore是一个有效的流量控制工具,它基于AQS共享锁实现。我们常常用它来控制对有限资源的访问。
- 每次使用资源前,先申请一个信号量,如果资源数不够,就会阻塞等待;
 - 每次释放资源后,就释放一个信号量。
 
