Class McpTokenBucketConfig.Builder

java.lang.Object

com.soklet.McpTokenBucketConfig.Builder

Enclosing class:

McpTokenBucketConfig

@NotThreadSafe
public static final class McpTokenBucketConfig.Builder
extends Object

Single-threaded builder for immutable token-bucket configurations.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
@NonNull McpTokenBucketConfig	build()	Builds an immutable finite configuration.
@NonNull McpTokenBucketConfig.Builder	capacity(@NonNull Long capacity)	Sets the maximum number of tokens held by one bucket.
@NonNull McpTokenBucketConfig.Builder	refillInterval(@NonNull Duration refillInterval)	Sets the positive refill interval.
@NonNull McpTokenBucketConfig.Builder	refillTokens(@NonNull Long refillTokens)	Sets the number of tokens replenished during one refill interval.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

capacity

public @NonNull McpTokenBucketConfig.Builder capacity(@NonNull Long capacity)

Sets the maximum number of tokens held by one bucket.

Parameters:

capacity - positive token capacity

Returns:

this builder

Throws:

NullPointerException - if capacity is null

refillTokens

public @NonNull McpTokenBucketConfig.Builder refillTokens(@NonNull Long refillTokens)

Sets the number of tokens replenished during one refill interval. This value is required and has no default.

Parameters:

refillTokens - positive refill quantity

Returns:

this builder

Throws:

NullPointerException - if refillTokens is null

refillInterval

public @NonNull McpTokenBucketConfig.Builder refillInterval(@NonNull Duration refillInterval)

Sets the positive refill interval. This value is required and has no default.

Parameters:

refillInterval - positive refill interval

Returns:

this builder

Throws:

NullPointerException - if refillInterval is null

build

public @NonNull McpTokenBucketConfig build()

Builds an immutable finite configuration.

Returns:

token-bucket configuration

Throws:

IllegalStateException - if refill quantity or interval is absent

IllegalArgumentException - if a numeric value is not positive or the refill interval cannot be represented in nanoseconds