com.configcat

Interface ConfigurationProvider

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable

All Known Implementing Classes:

ConfigCatClient

public interface ConfigurationProvider
extends java.io.Closeable

Defines the public interface of the ConfigCatClient.

Method Summary

Modifier and Type	Method and Description
void	forceRefresh() Initiates a force refresh synchronously on the cached configuration.
java.util.concurrent.CompletableFuture<java.lang.Void>	forceRefreshAsync() Initiates a force refresh asynchronously on the cached configuration.
java.util.Collection<java.lang.String>	getAllKeys() Gets a collection of all setting keys.
java.util.concurrent.CompletableFuture<java.util.Collection<java.lang.String>>	getAllKeysAsync() Gets a collection of all setting keys asynchronously.
<T extends RefreshPolicy> T	getRefreshPolicy(java.lang.Class<T> classOfT) Gets the internal refresh policy.
<T> T	getValue(java.lang.Class<T> classOfT, java.lang.String key, T defaultValue) Gets a value synchronously as T from the configuration identified by the given key.
<T> T	getValue(java.lang.Class<T> classOfT, java.lang.String key, User user, T defaultValue) Gets a value synchronously as T from the configuration identified by the given key.
<T> java.util.concurrent.CompletableFuture<T>	getValueAsync(java.lang.Class<T> classOfT, java.lang.String key, T defaultValue) Gets a value asynchronously as T from the configuration identified by the given key.
<T> java.util.concurrent.CompletableFuture<T>	getValueAsync(java.lang.Class<T> classOfT, java.lang.String key, User user, T defaultValue) Gets a value asynchronously as T from the configuration identified by the given key.

Methods inherited from interface java.io.Closeable

close

Method Detail

getRefreshPolicy

<T extends RefreshPolicy> T getRefreshPolicy(java.lang.Class<T> classOfT)

Gets the internal refresh policy.

Type Parameters:

T - the type of the desired policy.

Parameters:

classOfT - the class of T.

Returns:

the internal policy.

getValue

<T> T getValue(java.lang.Class<T> classOfT,
               java.lang.String key,
               T defaultValue)

Gets a value synchronously as T from the configuration identified by the given key.

Type Parameters:

T - the type of the desired config value.

Parameters:

classOfT - the class of T. Only String, Integer, Double or Boolean types are supported.

key - the identifier of the configuration value.

defaultValue - in case of any failure, this value will be returned.

Returns:

the configuration value identified by the given key.

getValue

<T> T getValue(java.lang.Class<T> classOfT,
               java.lang.String key,
               User user,
               T defaultValue)

Gets a value synchronously as T from the configuration identified by the given key.

Type Parameters:

T - the type of the desired config value.

Parameters:

classOfT - the class of T. Only String, Integer, Double or Boolean types are supported.

key - the identifier of the configuration value.

user - the user object to identify the caller.

defaultValue - in case of any failure, this value will be returned.

Returns:

the configuration value identified by the given key.

getValueAsync

<T> java.util.concurrent.CompletableFuture<T> getValueAsync(java.lang.Class<T> classOfT,
                                                            java.lang.String key,
                                                            T defaultValue)

Gets a value asynchronously as T from the configuration identified by the given key.

Type Parameters:

T - the type of the desired config value.

Parameters:

classOfT - the class of T. Only String, Integer, Double or Boolean types are supported.

key - the identifier of the configuration value.

defaultValue - in case of any failure, this value will be returned.

Returns:

a future which computes the configuration value identified by the given key.

getValueAsync

<T> java.util.concurrent.CompletableFuture<T> getValueAsync(java.lang.Class<T> classOfT,
                                                            java.lang.String key,
                                                            User user,
                                                            T defaultValue)

Gets a value asynchronously as T from the configuration identified by the given key.

Type Parameters:

T - the type of the desired config value.

Parameters:

classOfT - the class of T. Only String, Integer, Double or Boolean types are supported.

key - the identifier of the configuration value.

user - the user object to identify the caller.

defaultValue - in case of any failure, this value will be returned.

Returns:

a future which computes the configuration value identified by the given key.

getAllKeys

java.util.Collection<java.lang.String> getAllKeys()

Gets a collection of all setting keys.

Returns:

a collection of all setting keys.

getAllKeysAsync

java.util.concurrent.CompletableFuture<java.util.Collection<java.lang.String>> getAllKeysAsync()

Gets a collection of all setting keys asynchronously.

Returns:

a collection of all setting keys.

forceRefresh

void forceRefresh()

Initiates a force refresh synchronously on the cached configuration.

forceRefreshAsync

java.util.concurrent.CompletableFuture<java.lang.Void> forceRefreshAsync()

Initiates a force refresh asynchronously on the cached configuration.

Returns:

the future which executes the refresh.