RateLimiter

限流

当访问频率或者并发量超过其承受范围时候，我们就必须考虑限流来保证接口的可用性或者降级可用性，即接口也需要安装上保险丝，以防止非预期的请求对系统压力过大而引起的系统瘫痪，通常的策略就是拒绝多余的访问，或者让多余的访问排队等待服务，如果要准确的控制qps，简单的做法就是维护一个单位时间内的计数器counter，如果单位时间已经过去，则将counter重置为0

RateLimiter简介

google开源工具包guava提供的限流工具类RateLimiter，该类基于令牌桶算法(Token Bucket)来完成限流的，非常容易使用，它经常用于限制对一些物理资源或者逻辑资源的访问速率，它支持两种获取许令牌的接口，一种是如果拿不到令牌，则立刻返回false，另一种是会阻塞等待一段时间，如果拿不到令牌则返回false，RateLimiter和Java中的信号量(java.util.concurrent.Semaphore)类似，Semaphore通常用于限制并发量

示例

源码注释中的一个例子，比如我们有很多任务需要执行，但是我们不希望每秒超过两个任务执行,那么我们就可以使用RateLimiter

// 限流器定义
final RateLimiter rateLimiter = RateLimiter.create(2.0);

void submitTasks(List<Runnable> tasks, Executor executor) {
    for (Runnable task : tasks) {
        rateLimiter.acquire(); // 获取令牌
        executor.execute(task);
    }
}

RateLimit主要接口

修饰符和类型	方法和描述
static RateLimiter	create(double permitsPerSecond) 根据指定的稳定吞吐率创建RateLimiter，这里的吞吐率是指每秒多少许可数（通常是指QPS，每秒多少查询）
static RateLimiter	create(double permitsPerSecond, long warmupPeriod, TimeUnit unit) 根据指定的稳定吞吐率和预热期来创建RateLimiter，这里的吞吐率是指每秒多少许可数（通常是指QPS，每秒多少个请求量），在这段预热时间内，RateLimiter每秒分配的许可数会平稳地增长直到预热期结束时达到其最大速率。（只要存在足够请求数来使其饱和）
double	acquire() 从RateLimiter获取一个许可，该方法会被阻塞直到获取到请求
double	acquire(int permits) 从RateLimiter获取指定许可数，该方法会被阻塞直到获取到请求
boolean	tryAcquire() 从RateLimiter 获取许可，如果该许可可以在无延迟下的情况下立即获取得到的话
boolean	tryAcquire(int permits, long timeout, TimeUnit unit) 从RateLimiter 获取指定许可数如果该许可数可以在不超过timeout的时间内获取得到的话，或者如果无法在timeout 过期之前获取得到许可数的话，那么立即返回false （无需等待）
boolean	tryAcquire(long timeout, TimeUnit unit) 从RateLimiter 获取许可如果该许可可以在不超过timeout的时间内获取得到的话，或者如果无法在timeout 过期之前获取得到许可的话，那么立即返回false（无需等待）
double	getRate() 返回RateLimiter 配置中的稳定速率，该速率单位是每秒多少许可数
void	setRate(double permitsPerSecond) 更新RateLimite的稳定速率，参数permitsPerSecond 由构造RateLimiter的工厂方法提供