com.netflix.concurrency.limits.Limiter Maven / Gradle / Ivy
/**
* Copyright 2018 Netflix, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.netflix.concurrency.limits;
import java.util.Optional;
/**
* Contract for a concurrency limiter. The caller is expected to call acquire() for each request
* and must also release the returned listener when the operation completes. Releasing the Listener
* may trigger an update to the concurrency limit based on error rate or latency measurement.
*
* @param Some limiters take a context to perform more fine grained limits.
*/
@FunctionalInterface
public interface Limiter {
/**
*/
interface Listener {
/**
* Notification that the operation succeeded and internally measured latency should be
* used as an RTT sample
*/
void onSuccess();
/**
* The operation failed before any meaningful RTT measurement could be made and should
* be ignored to not introduce an artificially low RTT
*/
void onIgnore();
/**
* The request failed and was dropped due to being rejected by an external limit or hitting
* a timeout. Loss based {@link Limit} implementations will likely do an aggressive
* reducing in limit when this happens.
*/
void onDropped();
}
/**
* Acquire a token from the limiter. Returns an Optional.empty() if the limit has been exceeded.
* If acquired the caller must call one of the Listener methods when the operation has been completed
* to release the count.
*
* @param context Context for the request
* @return Optional.empty() if limit exceeded.
*/
Optional acquire(ContextT context);
}