java-limiter · 疾限Lock-free rate limiting

Six algorithms in one 18 KB jar, Java 8+, zero dependencies, no background threads. 六种算法、单个 18 KB jar、零依赖、无后台线程。

🇺🇸 English docs

🇨🇳 中文文档

GitHub

Zero dependencies · 零依赖

Only the JDK — no framework, no logging binding, no JSON library, no Redis client. 只用 JDK，没有框架、日志绑定、JSON 库或 Redis 客户端。

Lock-free · 无锁

One atomic read and at most one compare-and-set per request. 每次请求一次原子读、最多一次 CAS，快路径上没有互斥锁。

No background threads · 无后台线程

The rate is derived from System.nanoTime() on demand, so an idle limiter costs nothing. 请求到来时现算速率，空闲不限流器不占 CPU。

Six algorithms · 六种算法

Token bucket, leaky bucket, sliding window, fixed window, warm-up and a concurrency bulkhead. 令牌桶、漏桶、滑动窗口、固定窗口、预热限流、并发数限流。

Two documentation languages

🇺🇸 English documentation — introduction, guide, algorithms, API reference and FAQ.
🇨🇳 中文文档 — 简介、使用指南、算法原理、API 参考与常见问题。

Install

xml

<dependency>
    <groupId>io.github.onblog</groupId>
    <artifactId>java-limiter</artifactId>
    <version>1.0.0</version>
</dependency>

java

RateLimiter limiter = RateLimiters.tokenBucket("api", 200, 100, Duration.ofSeconds(1));

if (limiter.tryAcquire()) {
    handleRequest();
} else {
    response.setStatus(429);
}