在Java生态中，Guava库提供了一个简单而强大的工具，名为`RateLimiter`，用于实现令牌桶算法的限流。

在Java生态中，Guava库提供了一个简单而强大的工具，名为`RateLimiter`，用于实现令牌桶算法的限流。`RateLimiter`是Google Guava库的一部分，它允许开发者以编程方式控制资源的访问速率。

### 令牌桶算法简介

令牌桶算法的核心思想是：

- **令牌**：以固定的时间间隔添加到桶中。
- **桶**：有一个容量上限，代表可以存储的令牌数量。
- **请求**：每次请求会消耗一定数量的令牌，如果桶中令牌不足，则请求可能会被阻塞或拒绝。

### Guava RateLimiter 使用

Guava的`RateLimiter`类提供了几种创建实例的方法，最常见的是使用每秒多少个请求（QPS，Queries Per Second）来定义速率。

#### 创建RateLimiter实例

```java
import com.google.common.util.concurrent.RateLimiter;

// 创建一个每秒允许2个请求的RateLimiter
RateLimiter rateLimiter = RateLimiter.create(2.0); // 2 QPS
```

#### 使用RateLimiter进行限流

- **tryAcquire方法**：尝试获取令牌，如果获取成功则返回true，否则返回false。可以指定获取令牌的数量和等待时间。

```java
// 尝试立即获取一个令牌
if (rateLimiter.tryAcquire()) {
    // 执行请求
} else {
    // 请求被限流
}
```

- **获取令牌**：如果需要获取多个令牌，可以传递数量参数。

```java
if (rateLimiter.tryAcquire(2)) {
    // 执行需要2个令牌的请求
}
```

- **等待获取令牌**：也可以指定等待时间来获取令牌。

```java
// 尝试在1秒内获取一个令牌
if (rateLimiter.tryAcquire(1, TimeUnit.SECONDS)) {
    // 执行请求
} else {
    // 超时未获取到令牌
}
```

### 动态调整速率

`RateLimiter`还允许动态调整速率：

```java
// 设置新的速率为每秒5个请求
rateLimiter.setRate(5.0);
```

### 总结

Guava的`RateLimiter`是一个非常实用的工具，适用于需要细粒度控制请求速率的场景，如API调用限制、数据库访问控制等。它基于令牌桶算法，提供了灵活的限流策略，并且易于集成和使用。