throttle

KO | EN

gitlite — search

#javascript #python #llm #go #machine-learning #nodejs #java #cli #kubernetes #vue #awesome-list #security #pytorch #mcp

(★ 14)

Java Rate Limiter Derived From Googles' Guava Implementation

throttle Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Throttle [![Build Status](https://travis-ci.org/client-side/throttle.svg)](https://travis-ci.org/client-side/throttle) [![JCenter](https://api.bintray.com/packages/client-side/clients/throttle/images/download.svg) ](https://bintray.com/client-side/clients/throttle/_latestVersion) [![License](http://img.shields.io/badge/license-Apache--2-blue.svg?style=flat) ](https://raw.githubusercontent.com/client-side/throttle/master/LICENSE) [![codecov](https://codecov.io/gh/client-side/throttle/branch/master/graph/badge.svg)](https://codecov.io/gh/client-side/throttle)

>Provides a mechanism to limit the rate of access to a resource.

### Usage

A Throttle instance distributes permits at a desired rate, blocking if necessary until a permit is available.

### Java Version Support

Version `0.2.6` is the latest version to support Java 8.  Future versions will support the latest Java version that is out at the time of release.

###### Submit two tasks per second:

```java
Throttle throttle = Throttle.create(2.0); // 2 permits per second
// ...
void submitTasks(List<Runnable> tasks, Executor executor) {
  for (Runnable task : tasks) {
    throttle.acquire();
    executor.execute(task);
  }
}
```

###### Cap data stream to 5kb per second:

```java
Throttle throttle = Throttle.create(5000.0); // 5000 permits per second
// ...
void submitPacket(byte[] packet) {
  throttle.acquire(packet.length);
  networkService.send(packet);
}
```

### Changes From Guava Rate Limiter
* Nanosecond instead of microsecond accuracy.
* Uses a `ReentrantLock` instead of `synchronized` blocks to support optional fair acquisition ordering.
* Factoring out an interface class, [Throttle](src/main/java/engineering/clientside/throttle/Throttle.java#L83), from the base abstract class.
* Remove the need for any non-core-Java classes outside of the original [RateLimiter](https://github.com/google/guava/blob/master/guava/src/com/google/common/util/concurrent/RateLimiter.java) and [SmoothRateLimiter](https://github.com/google/guava/blob/master/guava/src/com/google/common/util/concurrent/SmoothRateLimiter.java) classes.
* Remove the need for a [SleepingStopwatch](https://github.com/google/guava/blob/master/guava/src/com/google/common/util/concurrent/RateLimiter.java#L395) or similar class instance.
* Guava provides rate limiters with either _bursty_ or _warm-up_ behavior. Throttle provides only a single strict rate limiter implementation that will never exceed the desired rate limit over a one second period.
* Throws checked InterruptedException's or unchecked CompletionException's with the cause set to the corresponding InterruptedException if interrupted.

### Dependency Management
```groovy
repositories {
   jcenter()
}

dependencies {
   compile 'engineering.clientside:throttle:+'
}
```

throttle

throttle Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

throttle

throttle Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README