com.configcat

Class ConfigCatClient

java.lang.Object

com.configcat.ConfigCatClient

All Implemented Interfaces:

ConfigurationProvider, java.io.Closeable, java.lang.AutoCloseable

public class ConfigCatClient
extends java.lang.Object
implements ConfigurationProvider

A client for handling configurations provided by ConfigCat.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConfigCatClient.Builder A builder that helps construct a ConfigCatClient instance.

Constructor Summary

Constructors

Constructor and Description
ConfigCatClient(java.lang.String apiKey) Constructs a new client instance with the default configuration.

Method Summary

Modifier and Type	Method and Description
void	close()
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.
static ConfigCatClient.Builder	newBuilder() Creates a new builder instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigCatClient

public ConfigCatClient(java.lang.String apiKey)

Constructs a new client instance with the default configuration.

Parameters:

apiKey - the token which identifies your project configuration.

Method Detail

getRefreshPolicy

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

Description copied from interface: ConfigurationProvider

Gets the internal refresh policy.

Specified by:

getRefreshPolicy in interface ConfigurationProvider

Type Parameters:

T - the type of the desired policy.

Parameters:

classOfT - the class of T.

Returns:

the internal policy.

getValue

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

Description copied from interface: ConfigurationProvider

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

Specified by:

getValue in interface ConfigurationProvider

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

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

Description copied from interface: ConfigurationProvider

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

Specified by:

getValue in interface ConfigurationProvider

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

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

Description copied from interface: ConfigurationProvider

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

Specified by:

getValueAsync in interface ConfigurationProvider

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

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

Description copied from interface: ConfigurationProvider

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

Specified by:

getValueAsync in interface ConfigurationProvider

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

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

Description copied from interface: ConfigurationProvider

Gets a collection of all setting keys.

Specified by:

getAllKeys in interface ConfigurationProvider

Returns:

a collection of all setting keys.

getAllKeysAsync

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

Description copied from interface: ConfigurationProvider

Gets a collection of all setting keys asynchronously.

Specified by:

getAllKeysAsync in interface ConfigurationProvider

Returns:

a collection of all setting keys.

forceRefresh

public void forceRefresh()

Description copied from interface: ConfigurationProvider

Initiates a force refresh synchronously on the cached configuration.

Specified by:

forceRefresh in interface ConfigurationProvider

forceRefreshAsync

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

Description copied from interface: ConfigurationProvider

Initiates a force refresh asynchronously on the cached configuration.

Specified by:

forceRefreshAsync in interface ConfigurationProvider

Returns:

the future which executes the refresh.

close

public void close()
           throws java.io.IOException

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

newBuilder

public static ConfigCatClient.Builder newBuilder()

Creates a new builder instance.

Returns:

the new builder.