io.github.bucket4j.distributed.proxy

Interface ProxyManager<K>

Type Parameters:

K - type of primary key

All Known Implementing Classes:

AbstractCompareAndSwapBasedProxyManager, AbstractLockBasedProxyManager, AbstractProxyManager, AbstractSelectForUpdateBasedProxyManager

public interface ProxyManager<K>

Represents an extension point of bucket4j library. ProxyManager provides API for building and managing the collection of BucketProxy in backing storage. Typically an instance of ProxyManager is organized around RDBMS table, GRID cache, or some similarly isolated part of external storage. Primary keys are used to distinguish persisted state of different buckets.

See Also:

BucketProxy, AsyncProxyManager

Method Summary

Modifier and Type	Method and Description
AsyncProxyManager<K>	asAsync() Returns asynchronous API for this proxy manager.
RemoteBucketBuilder<K>	builder()
Optional<BucketConfiguration>	getProxyConfiguration(K key) Locates configuration of bucket which actually stored in the underlying storage.
boolean	isAsyncModeSupported() Describes whether or not this manager supports asynchronous API.
void	removeProxy(K key) Removes persisted state of bucket from underlying storage.

Method Detail

builder

RemoteBucketBuilder<K> builder()

getProxyConfiguration

Optional<BucketConfiguration> getProxyConfiguration(K key)

Locates configuration of bucket which actually stored in the underlying storage.

Parameters:

key - the unique identifier used to point to the bucket in external storage.

Returns:

Optional surround the configuration or empty optional if bucket with specified key is not stored.

removeProxy

void removeProxy(K key)

Removes persisted state of bucket from underlying storage.

Parameters:

key - the primary key of bucket which state need to be removed from underlying storage.

isAsyncModeSupported

boolean isAsyncModeSupported()

Describes whether or not this manager supports asynchronous API. If this method returns false then any invocation of asAsync() will throw UnsupportedOperationException.

Returns:

true if this extension supports asynchronous API

asAsync

AsyncProxyManager<K> asAsync()
                      throws UnsupportedOperationException

Returns asynchronous API for this proxy manager.

Returns:

asynchronous API for this proxy manager.

Throws:

UnsupportedOperationException - in case of this proxy manager does not support Async API.